Annotation of 43BSDReno/usr.bin/refer/addbib/addbib.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1983, 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\"
                      5: .\"     @(#)addbib.1   6.3 (Berkeley) 7/24/90
                      6: .\"
                      7: .Dd July 24, 1990
                      8: .Os BSD 4.2
                      9: .Dt ADDBIB 1
                     10: .Sh NAME
                     11: .Nm addbib
                     12: .Nd create or extend bibliographic database
                     13: .Sh SYNOPSIS
                     14: .Nm addbib
                     15: .Op Fl p Ar promptfile
                     16: .Op Fl a
                     17: .Ar database
                     18: .Sh DESCRIPTION
                     19: When this program starts up, answering
                     20: .Ql y
                     21: to the initial
                     22: .Ql Instructions?
                     23: prompt yields directions;
                     24: typing
                     25: .Ql n
                     26: or
                     27: .Ql RETURN
                     28: skips them.
                     29: .Nm Addbib
                     30: then prompts for various bibliographic fields,
                     31: reads responses from the terminal,
                     32: and sends output records to a
                     33: .Ar database .
                     34: A null response (just
                     35: .Ql RETURN )
                     36: means to leave out that field.
                     37: A minus sign
                     38: .Ql \-
                     39: means to go back to the previous field.
                     40: A trailing backslash allows a field to be continued on the next line.
                     41: The repeating
                     42: .Ql Continue?
                     43: prompt allows the user
                     44: either to resume by typing
                     45: .Ql y
                     46: or
                     47: .Ql RETURN ,
                     48: to quit the current session by typing
                     49: .Ql n
                     50: or
                     51: .Ql q ,
                     52: or to edit the
                     53: .Ar database
                     54: with any system editor (.e.g.
                     55: .Xr vi ,
                     56: .Xr ex ,
                     57: .Xr edit ,
                     58: .Xr ed ) .
                     59: .Pp
                     60: The
                     61: .Fl a
                     62: option suppresses prompting for an abstract;
                     63: asking for an abstract is the default.
                     64: Abstracts are ended with a
                     65: .Ql CTRL-d .
                     66: The
                     67: .Fl p
                     68: option causes
                     69: .Nm addbib
                     70: to use a new prompting skeleton, defined in
                     71: .Ar promptfile .
                     72: This file should contain prompt strings, a tab,
                     73: and the key-letters to be written to the
                     74: .Ar database .
                     75: .Pp
                     76: The most common key-letters and their meanings are given below.
                     77: .Nm Addbib
                     78: insulates you from these key-letters,
                     79: since it gives you prompts in English,
                     80: but if you edit the bibliography file later on,
                     81: you will need to know this information.
                     82: .Dw \&%Y,Z
                     83: .Dp \&%A
                     84: Author's name
                     85: .Dp \&%B
                     86: Book containing article referenced
                     87: .Dp \&%C
                     88: City (place of publication)
                     89: .Dp \&%D
                     90: Date of publication
                     91: .Dp \&%E
                     92: Editor of book containing article referenced
                     93: .Dp \&%F
                     94: Footnote number or label (supplied by
                     95: .Xr refer )
                     96: .Dp \&%G
                     97: Government order number
                     98: .Dp \&%H
                     99: Header commentary, printed before reference
                    100: .Dp \&%I
                    101: Issuer (publisher)
                    102: .Dp \&%J
                    103: Journal containing article
                    104: .Dp \&%K
                    105: Keywords to use in locating reference
                    106: .Dp \&%L
                    107: Label field used by
                    108: .Fl k
                    109: option of
                    110: .Xr refer
                    111: .Dp \&%M
                    112: Memorandum label
                    113: .Dp \&%N
                    114: Number within volume
                    115: .Dp \&%O
                    116: Other commentary, printed at end of reference
                    117: .Dp \&%P
                    118: Page number(s)
                    119: .Dp \&%Q
                    120: Corporate or Foreign Author (unreversed)
                    121: .Dp \&%R
                    122: Report, paper, or thesis (unpublished)
                    123: .Dp \&%S
                    124: Series title
                    125: .Dp \&%T
                    126: Title of article or book
                    127: .Dp \&%V
                    128: Volume number
                    129: .Dp \&%X
                    130: Abstract \(em used by
                    131: .Xr roffbib ,
                    132: not by
                    133: .Xr refer
                    134: .Dp \&%Y,Z
                    135: ignored by
                    136: .Xr refer
                    137: .Dp
                    138: .Pp
                    139: Except for `A', each field should be given just once.
                    140: Only relevant fields should be supplied.
                    141: .Sh EXAMPLES
                    142: .Dw \&%Y,Z
                    143: .Dp %A
                    144: Bill Tuthill
                    145: .Dp %T
                    146: Refer \(em A Bibliography System
                    147: .Dp %I
                    148: Computing Services
                    149: .Dp %C
                    150: Berkeley
                    151: .Dp %D
                    152: 1982
                    153: .Dp %O
                    154: \s-1UNX\s0 4.3.5.
                    155: .Dp
                    156: .Sh FILES
                    157: .Dw promptfile
                    158: .Di L
                    159: .Dp Pa promptfile
                    160: optional file to define prompting
                    161: .Sh SEE ALSO
                    162: .Xr refer 1 ,
                    163: .Xr sortbib 1 ,
                    164: .Xr roffbib 1 ,
                    165: .Xr indxbib 1 ,
                    166: .Xr lookbib 1
                    167: .Sh HISTORY
                    168: appeared in 4.2 BSD.
                    169: .Sh AUTHORS
                    170: Al Stangenberger, Bill Tuthill

unix.superglobalmegacorp.com

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