Return to library.1 CVS log

Up to [Research Unix] / researchv10dc / man / man1

Annotation of researchv10dc/man/man1/library.1, revision 1.1

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