xref: /csrg-svn/old/refer/addbib/addbib.1 (revision 44952)
143081Scael.\" Copyright (c) 1983, 1990 The Regents of the University of California.
243081Scael.\" All rights reserved.
319701Smckusick.\"
419701Smckusick.\"
5*44952Scael.\"     @(#)addbib.1	6.3 (Berkeley) 07/24/90
643081Scael.\"
743081Scael.Dd
843081Scael.Os BSD 4.2
943081Scael.Dt ADDBIB 1
1043081Scael.Sh NAME
1143081Scael.Nm addbib
1243081Scael.Nd create or extend bibliographic database
1343081Scael.Sh SYNOPSIS
1443081Scael.Nm addbib
1543081Scael.Op Fl p Ar promptfile
1643081Scael.Op Fl a
1743081Scael.Ar database
1843081Scael.Sh DESCRIPTION
1943081ScaelWhen this program starts up, answering
20*44952Scael.Ql y
2143081Scaelto the initial
22*44952Scael.Ql Instructions?
2343081Scaelprompt yields directions;
2443081Scaeltyping
25*44952Scael.Ql n
2643081Scaelor
27*44952Scael.Ql RETURN
2843081Scaelskips them.
2943081Scael.Nm Addbib
3019701Smckusickthen prompts for various bibliographic fields,
3119701Smckusickreads responses from the terminal,
3219701Smckusickand sends output records to a
3343081Scael.Ar database .
3443081ScaelA null response (just
35*44952Scael.Ql RETURN )
3643081Scaelmeans to leave out that field.
3743081ScaelA minus sign
38*44952Scael.Ql \-
3943081Scaelmeans to go back to the previous field.
4019701SmckusickA trailing backslash allows a field to be continued on the next line.
4143081ScaelThe repeating
42*44952Scael.Ql Continue?
4343081Scaelprompt allows the user
4443081Scaeleither to resume by typing
45*44952Scael.Ql y
4643081Scaelor
47*44952Scael.Ql RETURN ,
4843081Scaelto quit the current session by typing
49*44952Scael.Ql n
5043081Scaelor
51*44952Scael.Ql q ,
5219701Smckusickor to edit the
5343081Scael.Ar database
5443081Scaelwith any system editor (.e.g.
5543081Scael.Xr vi ,
5643081Scael.Xr ex ,
5743081Scael.Xr edit ,
5843081Scael.Xr ed ) .
5943081Scael.Pp
6019701SmckusickThe
6143081Scael.Fl a
6219701Smckusickoption suppresses prompting for an abstract;
6319701Smckusickasking for an abstract is the default.
6443081ScaelAbstracts are ended with a
65*44952Scael.Ql CTRL-d .
6619701SmckusickThe
6743081Scael.Fl p
6819701Smckusickoption causes
6943081Scael.Nm addbib
7019701Smckusickto use a new prompting skeleton, defined in
7143081Scael.Ar promptfile .
7219701SmckusickThis file should contain prompt strings, a tab,
7319701Smckusickand the key-letters to be written to the
7443081Scael.Ar database .
7543081Scael.Pp
7619701SmckusickThe most common key-letters and their meanings are given below.
7743081Scael.Nm Addbib
7819701Smckusickinsulates you from these key-letters,
7919701Smckusicksince it gives you prompts in English,
8019701Smckusickbut if you edit the bibliography file later on,
8119701Smckusickyou will need to know this information.
8243081Scael.Dw \&%Y,Z
8343081Scael.Dp \&%A
8443081ScaelAuthor's name
8543081Scael.Dp \&%B
8643081ScaelBook containing article referenced
8743081Scael.Dp \&%C
8843081ScaelCity (place of publication)
8943081Scael.Dp \&%D
9043081ScaelDate of publication
9143081Scael.Dp \&%E
9243081ScaelEditor of book containing article referenced
9343081Scael.Dp \&%F
9443081ScaelFootnote number or label (supplied by
9543081Scael.Xr refer )
9643081Scael.Dp \&%G
9743081ScaelGovernment order number
9843081Scael.Dp \&%H
9943081ScaelHeader commentary, printed before reference
10043081Scael.Dp \&%I
10143081ScaelIssuer (publisher)
10243081Scael.Dp \&%J
10343081ScaelJournal containing article
10443081Scael.Dp \&%K
10543081ScaelKeywords to use in locating reference
10643081Scael.Dp \&%L
10743081ScaelLabel field used by
10843081Scael.Fl k
10943081Scaeloption of
11043081Scael.Xr refer
11143081Scael.Dp \&%M
11243081ScaelMemorandum label
11343081Scael.Dp \&%N
11443081ScaelNumber within volume
11543081Scael.Dp \&%O
11643081ScaelOther commentary, printed at end of reference
11743081Scael.Dp \&%P
11843081ScaelPage number(s)
11943081Scael.Dp \&%Q
12043081ScaelCorporate or Foreign Author (unreversed)
12143081Scael.Dp \&%R
12243081ScaelReport, paper, or thesis (unpublished)
12343081Scael.Dp \&%S
12443081ScaelSeries title
12543081Scael.Dp \&%T
12643081ScaelTitle of article or book
12743081Scael.Dp \&%V
12843081ScaelVolume number
12943081Scael.Dp \&%X
13043081ScaelAbstract \(em used by
13143081Scael.Xr roffbib ,
13243081Scaelnot by
13343081Scael.Xr refer
13443081Scael.Dp \&%Y,Z
13543081Scaelignored by
13643081Scael.Xr refer
13743081Scael.Dp
13843081Scael.Pp
13919701SmckusickExcept for `A', each field should be given just once.
14019701SmckusickOnly relevant fields should be supplied.
14143081Scael.Sh EXAMPLES
14243081Scael.Dw \&%Y,Z
14343081Scael.Dp %A
14443081ScaelBill Tuthill
14543081Scael.Dp %T
14643081ScaelRefer \(em A Bibliography System
14743081Scael.Dp %I
14843081ScaelComputing Services
14943081Scael.Dp %C
15043081ScaelBerkeley
15143081Scael.Dp %D
15243081Scael1982
15343081Scael.Dp %O
15443081Scael\s-1UNX\s0 4.3.5.
15543081Scael.Dp
15643081Scael.Sh FILES
15743081Scael.Dw promptfile
158*44952Scael.Di L
15943081Scael.Dp Pa promptfile
16043081Scaeloptional file to define prompting
16143081Scael.Sh SEE ALSO
16243081Scael.Xr refer 1 ,
16343081Scael.Xr sortbib 1 ,
16443081Scael.Xr roffbib 1 ,
16543081Scael.Xr indxbib 1 ,
16643081Scael.Xr lookbib 1
16743081Scael.Sh HISTORY
16843081Scaelappeared in 4.2 BSD.
16943081Scael.Sh AUTHORS
17019701SmckusickAl Stangenberger, Bill Tuthill
171