Return to library.1 CVS log

Up to [Research Unix] / researchv10dc / cmd / library

Annotation of researchv10dc/cmd/library/library.1, revision 1.1

1.1     ! root        1: .nr X  \" 0=3b2(default), 1=vax,uts  \" 0=3b2(default), 1=vax,uts
        !             2: .if \nX=0 .ds x} LIBRARY 1 "User Environment Utilities" "RDS Standard" 1
        !             3: .if \nX=1 .ds x} LIBRARY 1 "R&D UNIX STD"
        !             4: .if \nX=2 .ds x} LIBRARY 1 "R&D UNIX STD" "\&"
        !             5: .if \nX=3 .ds x}
        !             6: .TH \*(x} 
        !             7: .SH NAME
        !             8: library \- send information requests to appropriate organization
        !             9: .PD
        !            10: .SH SYNOPSIS
        !            11: .B library [-1234567] [request string]
        !            12: .PD
        !            13: .SH DESCRIPTION
        !            14: .I library
        !            15: sends document/information requests to the
        !            16: appropriate organization within the Library Network.
        !            17: It also handles a variety of requests for other AT&T organizations
        !            18: (e.g., Engineering Information Services).
        !            19: It requires the user to discriminate between seven classes of requests
        !            20: as indicated by the menu it displays:
        !            21: .sp
        !            22: .nf
        !            23: 1)  Order by number - this includes nearly everything announced
        !            24:        by the AT&T Library Network (e.g. TMs, bulletin items) or handled
        !            25:        by the Engineering Information Services (e.g. J docs, CPSs).
        !            26: 2)  Order item not announced by the AT&T Library Network. Available:
        !            27:         Buy a copy of a book; Address labels; Technical Reports; 
        !            28:         Internal document by date (id unknown); Photocopies; 
        !            29:         Subscribe to a journal; foreign language services.
        !            30: 3)  Subscribe or unsubscribe to a bulletin (e.g. Mercury, CTP)
        !            31: 4)  Submit a database search. Examples of available databases:
        !            32:        book catalog, internal documents, AT&T personnel, released papers
        !            33: 5)  Request human assistance / interaction. Type(s) available:
        !            34:         General AT&T Library Network assistance; Reference question.
        !            35: 6)  Request AT&T Library Network information/services. Examples:
        !            36:        LINUS info, products/services descriptions, loan/reserve status
        !            37: 7)  Read AT&T Library Network email transmissions
        !            38: 
        !            39: .fi
        !            40: Note that the first class includes anything announced by the Library Network operated by AT&T Bell Laboratories.  
        !            41: .PP
        !            42: The main menu level of 
        !            43: .I library 
        !            44: can be skipped by giving
        !            45: the number of the desired option (1 - 7)
        !            46: as the first parameter to the
        !            47: \f2library\f1.
        !            48: .PP
        !            49: The secondary menu levels in
        !            50: .I library
        !            51: (presently in options 2, 4, 5 and 6)
        !            52: can be bypassed by selecting the desired option as the second
        !            53: parameter.
        !            54: For example, to do order a photocopy, use the
        !            55: command
        !            56: .ce
        !            57: library -2 -p
        !            58: .PP
        !            59: Similarly, if you want to do a search of the personnel database,
        !            60: you can do the command line
        !            61: .ce
        !            62: library -4 -p waldstein, r k
        !            63: .PP
        !            64: Requests for objects that can be meaningfully described with one
        !            65: line can be entered on the command line.
        !            66: This includes the things orderable by options 1, 3, 4, and 6.
        !            67: Note that library tries in this case to function with a minimum
        !            68: of interaction.
        !            69: For example, if you request a TM this way,
        !            70: you will not be given a chance to enter remarks connected with the request.
        !            71: .PP
        !            72: When permitted, the command line requests can include more than one item
        !            73: (presently only options 1 and 3 support this).
        !            74: An example command line is
        !            75: .ce
        !            76: library -1 123456-851234-56tm  5d123 ad-123456 
        !            77: .PP
        !            78: In options 2, 5, and 6,
        !            79: .I library
        !            80: will prompt for a variety of information of varying complexity.
        !            81: A period (.) at any point in this session will delete the 
        !            82: request being entered.
        !            83: Blank lines (just hit return) will cause optional information to
        !            84: be left out of the request.
        !            85: A line consisting of tilde e (\~e) will, when a long response is 
        !            86: permitted, put you into an editor.
        !            87: This editor defaults to ed(1).
        !            88: However, if the environment variable EDITOR is set, the specified
        !            89: editor is used.
        !            90: A line consisting of tilde r (\~r) will, when a long response is 
        !            91: permitted, read in the indicated file.
        !            92: .PP
        !            93: Option 7 is a misfit, in that it is primarily a reader, not a
        !            94: request transmitter; although it does allow requesting items.
        !            95: This option is intended for reading electronic transmissions
        !            96: from the library network: primarily responses to option 4 search
        !            97: requests and ASAP (specialized searches like electronic Mercury).
        !            98: A convenient way to use option 7 is to invoke it via a pipe
        !            99: from mail(1), mailx(1) or post(1).
        !           100: .ce
        !           101:  | 3 "library -7"
        !           102: This assumes that mail message 3 consists of a search result.
        !           103: The quote marks are required due to post(1) and mailx(1) syntax.
        !           104: .PP
        !           105: Break causes 
        !           106: .I library
        !           107: to exit
        !           108: without sending any requests.
        !           109: .PP
        !           110: In general for more information about what the library command can
        !           111: do, go into each option and enter a question mark.
        !           112: This will cause a description of how the option works and
        !           113: what it can request.
        !           114: .PP
        !           115: Several other pieces of information can be passed
        !           116: to
        !           117: .I library
        !           118: to ease and improve its usage.
        !           119: This information is looked up in a file called .lib (or the file indicated
        !           120: by the LIBFILE shell variable).
        !           121: It expects this file to contain lines of the form:
        !           122: .sp
        !           123: .ti 10
        !           124: ID: \f2individual's PAN or Social Security Number\f1
        !           125: .ti 10
        !           126: libname: \f2individual's last name\f1
        !           127: .ti 10
        !           128: liblog: \f2name of log file\f1
        !           129: .ti 10
        !           130: libcntl: \f2control information\f1
        !           131: .ti 10
        !           132: reader: \f2reader control information\f1
        !           133: .ti 10
        !           134: liblocal: \f2control information\f1
        !           135: .PP
        !           136: If this file is not found or lines of this form are not found,
        !           137: then 
        !           138: .I library
        !           139: prompts for name and ID (PAN or SS#).
        !           140: .PP
        !           141: This information can also be passed to 
        !           142: .I library
        !           143: as the shell parameters: LIBID, LIBNAME, LIBLOG, LIBCNTL, and LIBLOCAL.
        !           144: .PP
        !           145: .I library
        !           146: keeps a log of requests sent via library if a line in the .lib
        !           147: file exists giving a log file name, i.e., if you have in
        !           148: your .lib file a line of the form
        !           149: .ce
        !           150: liblog: \f2name of log file\f1
        !           151: .PP
        !           152: .I library
        !           153: keeps a log of requests in that file.
        !           154: This file is created in a form that can be read and manipulated
        !           155: by the 
        !           156: .I mail
        !           157: command.
        !           158: To read or modify the log file, type
        !           159: .ce
        !           160: mail -f \f2name of log file\f1
        !           161: .PP
        !           162: .I library
        !           163: creates the log file in your HOME directory unless the file name
        !           164: given starts with a slash (/).
        !           165: .I library
        !           166: will automatically check option 1 requests
        !           167: for duplicates in the log file.
        !           168: .PP
        !           169: The libcntl information is sent with the request to the program
        !           170: that receives the requests for the library networks.
        !           171: Control information containing the letter ``a''
        !           172: will cause an acknowledgement to be mailed back to you that
        !           173: your request has been received.
        !           174: Control information of the form ``m\f2number\f1''will determine the
        !           175: maximum number of items retrieved by a search request.
        !           176: For example, a control line of the form
        !           177: .sp
        !           178: .ce
        !           179: libcntl: am100
        !           180: .PP
        !           181: will cause requests to be acknowledged and a maximum of 100 retrieved
        !           182: search items to be mailed back to you.
        !           183: .PP
        !           184: The reader control information is intended to let you personalize
        !           185: the way
        !           186: .I library
        !           187: option 7 works for you.
        !           188: Each letter after the colon indicates a different option turned
        !           189: on or off.
        !           190: Presently available are the following:
        !           191: .RS
        !           192: .TP 5
        !           193: b
        !           194: causes library -7 to leave a
        !           195: blank line between records when more than one is displayed on the screen.
        !           196: .TP 5
        !           197: c
        !           198: causes 
        !           199: .I library
        !           200: to confirm that you want the entered requests transmitted.
        !           201: It does this at the end of the session, before finishing.
        !           202: .TP 5
        !           203: n
        !           204: is an interesting features causing no introductory menu
        !           205: of available announcements to be displayed.
        !           206: The reader then goes straight into the first announcement to be read,
        !           207: and moves directly from one announcement to the next, without
        !           208: displaying the menu of those available at each stage.
        !           209: .RE
        !           210: .PP
        !           211: The liblocal information is used to control the execution of 
        !           212: .I library.
        !           213: Presently the only meaningful control is \f2x\fP.
        !           214: This causes library(1) to assume you are an expert and the
        !           215: prompts are generally much shorter.
        !           216: .PP
        !           217: .I library
        !           218: also uses your .lib file to save various repetitious responses
        !           219: for its own use.
        !           220: These will prevent you from having to duplicate responses.
        !           221: .PD
        !           222: .SH BUGS
        !           223: .I library
        !           224: checks upon input whether the request is reasonable.
        !           225: New styles of request numbers require program modification
        !           226: before they are valid.
        !           227: .PD
        !           228: .SH FILES
        !           229: .PD 0
        !           230: .TP 15
        !           231: $HOME/.lib
        !           232: This optional file contains a PAN and name for
        !           233: .I library
        !           234: to use.
        !           235: .TP 15
        !           236: /usr/lib/library/library.help
        !           237: The help message displayed by library.
        !           238: .PD
        !           239: .SH "SEE ALSO"
        !           240: mail(1), post(1), mailx(1)
        !           241: .\"    @(#)library.1   1.12  11/26/90 RnD added

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.