build: Better Build System

1 files changed, 241 insertions, 0 deletions

diff --git a/static/unix-v10/man1/library.1 b/static/unix-v10/man1/library.1
new file mode 100644
index 00000000..d6517a3b
--- /dev/null
+++ b/static/unix-v10/man1/library.1
@@ -0,0 +1,241 @@
+.nr X  \" 0=3b2(default), 1=vax,uts  \" 0=3b2(default), 1=vax,uts
+.if \nX=0 .ds x} LIBRARY 1 "User Environment Utilities" "RDS Standard" 1
+.if \nX=1 .ds x} LIBRARY 1 "R&D UNIX STD"
+.if \nX=2 .ds x} LIBRARY 1 "R&D UNIX STD" "\&"
+.if \nX=3 .ds x}
+.TH \*(x} 
+.SH NAME
+library \- send information requests to appropriate organization
+.PD
+.SH SYNOPSIS
+.B library [-1234567] [request string]
+.PD
+.SH DESCRIPTION
+.I library
+sends document/information requests to the
+appropriate organization within the Library Network.
+It also handles a variety of requests for other AT&T organizations
+(e.g., Engineering Information Services).
+It requires the user to discriminate between seven classes of requests
+as indicated by the menu it displays:
+.sp
+.nf
+1)  Order by number - this includes nearly everything announced
+	by the AT&T Library Network (e.g. TMs, bulletin items) or handled
+	by the Engineering Information Services (e.g. J docs, CPSs).
+2)  Order item not announced by the AT&T Library Network. Available:
+	 Buy a copy of a book; Address labels; Technical Reports; 
+	 Internal document by date (id unknown); Photocopies; 
+	 Subscribe to a journal; foreign language services.
+3)  Subscribe or unsubscribe to a bulletin (e.g. Mercury, CTP)
+4)  Submit a database search. Examples of available databases:
+	book catalog, internal documents, AT&T personnel, released papers
+5)  Request human assistance / interaction. Type(s) available:
+	 General AT&T Library Network assistance; Reference question.
+6)  Request AT&T Library Network information/services. Examples:
+	LINUS info, products/services descriptions, loan/reserve status
+7)  Read AT&T Library Network email transmissions
+
+.fi
+Note that the first class includes anything announced by the Library Network operated by AT&T Bell Laboratories.  
+.PP
+The main menu level of 
+.I library 
+can be skipped by giving
+the number of the desired option (1 - 7)
+as the first parameter to the
+\f2library\f1.
+.PP
+The secondary menu levels in
+.I library
+(presently in options 2, 4, 5 and 6)
+can be bypassed by selecting the desired option as the second
+parameter.
+For example, to do order a photocopy, use the
+command
+.ce
+library -2 -p
+.PP
+Similarly, if you want to do a search of the personnel database,
+you can do the command line
+.ce
+library -4 -p waldstein, r k
+.PP
+Requests for objects that can be meaningfully described with one
+line can be entered on the command line.
+This includes the things orderable by options 1, 3, 4, and 6.
+Note that library tries in this case to function with a minimum
+of interaction.
+For example, if you request a TM this way,
+you will not be given a chance to enter remarks connected with the request.
+.PP
+When permitted, the command line requests can include more than one item
+(presently only options 1 and 3 support this).
+An example command line is
+.ce
+library -1 123456-851234-56tm  5d123 ad-123456 
+.PP
+In options 2, 5, and 6,
+.I library
+will prompt for a variety of information of varying complexity.
+A period (.) at any point in this session will delete the 
+request being entered.
+Blank lines (just hit return) will cause optional information to
+be left out of the request.
+A line consisting of tilde e (\~e) will, when a long response is 
+permitted, put you into an editor.
+This editor defaults to ed(1).
+However, if the environment variable EDITOR is set, the specified
+editor is used.
+A line consisting of tilde r (\~r) will, when a long response is 
+permitted, read in the indicated file.
+.PP
+Option 7 is a misfit, in that it is primarily a reader, not a
+request transmitter; although it does allow requesting items.
+This option is intended for reading electronic transmissions
+from the library network: primarily responses to option 4 search
+requests and ASAP (specialized searches like electronic Mercury).
+A convenient way to use option 7 is to invoke it via a pipe
+from mail(1), mailx(1) or post(1).
+.ce
+ | 3 "library -7"
+This assumes that mail message 3 consists of a search result.
+The quote marks are required due to post(1) and mailx(1) syntax.
+.PP
+Break causes 
+.I library
+to exit
+without sending any requests.
+.PP
+In general for more information about what the library command can
+do, go into each option and enter a question mark.
+This will cause a description of how the option works and
+what it can request.
+.PP
+Several other pieces of information can be passed
+to
+.I library
+to ease and improve its usage.
+This information is looked up in a file called .lib (or the file indicated
+by the LIBFILE shell variable).
+It expects this file to contain lines of the form:
+.sp
+.ti 10
+ID: \f2individual's PAN or Social Security Number\f1
+.ti 10
+libname: \f2individual's last name\f1
+.ti 10
+liblog: \f2name of log file\f1
+.ti 10
+libcntl: \f2control information\f1
+.ti 10
+reader: \f2reader control information\f1
+.ti 10
+liblocal: \f2control information\f1
+.PP
+If this file is not found or lines of this form are not found,
+then 
+.I library
+prompts for name and ID (PAN or SS#).
+.PP
+This information can also be passed to 
+.I library
+as the shell parameters: LIBID, LIBNAME, LIBLOG, LIBCNTL, and LIBLOCAL.
+.PP
+.I library
+keeps a log of requests sent via library if a line in the .lib
+file exists giving a log file name, i.e., if you have in
+your .lib file a line of the form
+.ce
+liblog: \f2name of log file\f1
+.PP
+.I library
+keeps a log of requests in that file.
+This file is created in a form that can be read and manipulated
+by the 
+.I mail
+command.
+To read or modify the log file, type
+.ce
+mail -f \f2name of log file\f1
+.PP
+.I library
+creates the log file in your HOME directory unless the file name
+given starts with a slash (/).
+.I library
+will automatically check option 1 requests
+for duplicates in the log file.
+.PP
+The libcntl information is sent with the request to the program
+that receives the requests for the library networks.
+Control information containing the letter ``a''
+will cause an acknowledgement to be mailed back to you that
+your request has been received.
+Control information of the form ``m\f2number\f1''will determine the
+maximum number of items retrieved by a search request.
+For example, a control line of the form
+.sp
+.ce
+libcntl: am100
+.PP
+will cause requests to be acknowledged and a maximum of 100 retrieved
+search items to be mailed back to you.
+.PP
+The reader control information is intended to let you personalize
+the way
+.I library
+option 7 works for you.
+Each letter after the colon indicates a different option turned
+on or off.
+Presently available are the following:
+.RS
+.TP 5
+b
+causes library -7 to leave a
+blank line between records when more than one is displayed on the screen.
+.TP 5
+c
+causes 
+.I library
+to confirm that you want the entered requests transmitted.
+It does this at the end of the session, before finishing.
+.TP 5
+n
+is an interesting features causing no introductory menu
+of available announcements to be displayed.
+The reader then goes straight into the first announcement to be read,
+and moves directly from one announcement to the next, without
+displaying the menu of those available at each stage.
+.RE
+.PP
+The liblocal information is used to control the execution of 
+.I library.
+Presently the only meaningful control is \f2x\fP.
+This causes library(1) to assume you are an expert and the
+prompts are generally much shorter.
+.PP
+.I library
+also uses your .lib file to save various repetitious responses
+for its own use.
+These will prevent you from having to duplicate responses.
+.PD
+.SH BUGS
+.I library
+checks upon input whether the request is reasonable.
+New styles of request numbers require program modification
+before they are valid.
+.PD
+.SH FILES
+.PD 0
+.TP 15
+$HOME/.lib
+This optional file contains a PAN and name for
+.I library
+to use.
+.TP 15
+/usr/lib/library/library.help
+The help message displayed by library.
+.PD
+.SH "SEE ALSO"
+mail(1), post(1), mailx(1)
+.\"	@(#)library.1	1.12  11/26/90 RnD added