xref: /csrg-svn/old/refer/addbib/addbib.1 (revision 47397)
143081Scael.\" Copyright (c) 1983, 1990 The Regents of the University of California.
243081Scael.\" All rights reserved.
319701Smckusick.\"
4*47397Scael.\" %sccs.include.redist.man%
519701Smckusick.\"
6*47397Scael.\"     @(#)addbib.1	6.4 (Berkeley) 03/14/91
743081Scael.\"
843081Scael.Dd
943081Scael.Os BSD 4.2
1043081Scael.Dt ADDBIB 1
1143081Scael.Sh NAME
1243081Scael.Nm addbib
1343081Scael.Nd create or extend bibliographic database
1443081Scael.Sh SYNOPSIS
1543081Scael.Nm addbib
16*47397Scael.Op Fl a
1743081Scael.Op Fl p Ar promptfile
1843081Scael.Ar database
1943081Scael.Sh DESCRIPTION
2043081ScaelWhen this program starts up, answering
2144952Scael.Ql y
2243081Scaelto the initial
2344952Scael.Ql Instructions?
2443081Scaelprompt yields directions;
2543081Scaeltyping
2644952Scael.Ql n
2743081Scaelor
2844952Scael.Ql RETURN
2943081Scaelskips them.
3043081Scael.Nm Addbib
3119701Smckusickthen prompts for various bibliographic fields,
3219701Smckusickreads responses from the terminal,
3319701Smckusickand sends output records to a
3443081Scael.Ar database .
3543081ScaelA null response (just
3644952Scael.Ql RETURN )
3743081Scaelmeans to leave out that field.
3843081ScaelA minus sign
3944952Scael.Ql \-
4043081Scaelmeans to go back to the previous field.
4119701SmckusickA trailing backslash allows a field to be continued on the next line.
4243081ScaelThe repeating
4344952Scael.Ql Continue?
4443081Scaelprompt allows the user
4543081Scaeleither to resume by typing
4644952Scael.Ql y
4743081Scaelor
4844952Scael.Ql RETURN ,
4943081Scaelto quit the current session by typing
5044952Scael.Ql n
5143081Scaelor
5244952Scael.Ql q ,
5319701Smckusickor to edit the
5443081Scael.Ar database
5543081Scaelwith any system editor (.e.g.
5643081Scael.Xr vi ,
5743081Scael.Xr ex ,
5843081Scael.Xr edit ,
5943081Scael.Xr ed ) .
6043081Scael.Pp
61*47397ScaelOptions avilable:
62*47397Scael.Bl -tag -width a
63*47397Scael.It Fl a
6419701SmckusickThe
6543081Scael.Fl a
6619701Smckusickoption suppresses prompting for an abstract;
6719701Smckusickasking for an abstract is the default.
6843081ScaelAbstracts are ended with a
6944952Scael.Ql CTRL-d .
70*47397Scael.It Fl p
7119701SmckusickThe
7243081Scael.Fl p
7319701Smckusickoption causes
7443081Scael.Nm addbib
7519701Smckusickto use a new prompting skeleton, defined in
7643081Scael.Ar promptfile .
7719701SmckusickThis file should contain prompt strings, a tab,
7819701Smckusickand the key-letters to be written to the
7943081Scael.Ar database .
80*47397Scael.El
8143081Scael.Pp
8219701SmckusickThe most common key-letters and their meanings are given below.
8343081Scael.Nm Addbib
8419701Smckusickinsulates you from these key-letters,
8519701Smckusicksince it gives you prompts in English,
8619701Smckusickbut if you edit the bibliography file later on,
8719701Smckusickyou will need to know this information.
88*47397Scael.Pp
89*47397Scael.Bl -tag -width "%Y,Z " -compact -offset indent
90*47397Scael.It \&%A
9143081ScaelAuthor's name
92*47397Scael.It \&%B
9343081ScaelBook containing article referenced
94*47397Scael.It \&%C
9543081ScaelCity (place of publication)
96*47397Scael.It \&%D
9743081ScaelDate of publication
98*47397Scael.It \&%E
9943081ScaelEditor of book containing article referenced
100*47397Scael.It \&%F
10143081ScaelFootnote number or label (supplied by
10243081Scael.Xr refer )
103*47397Scael.It \&%G
10443081ScaelGovernment order number
105*47397Scael.It \&%H
10643081ScaelHeader commentary, printed before reference
107*47397Scael.It \&%I
10843081ScaelIssuer (publisher)
109*47397Scael.It \&%J
11043081ScaelJournal containing article
111*47397Scael.It \&%K
11243081ScaelKeywords to use in locating reference
113*47397Scael.It \&%L
11443081ScaelLabel field used by
11543081Scael.Fl k
11643081Scaeloption of
11743081Scael.Xr refer
118*47397Scael.It \&%M
11943081ScaelMemorandum label
120*47397Scael.It \&%N
12143081ScaelNumber within volume
122*47397Scael.It \&%O
12343081ScaelOther commentary, printed at end of reference
124*47397Scael.It \&%P
12543081ScaelPage number(s)
126*47397Scael.It \&%Q
12743081ScaelCorporate or Foreign Author (unreversed)
128*47397Scael.It \&%R
12943081ScaelReport, paper, or thesis (unpublished)
130*47397Scael.It \&%S
13143081ScaelSeries title
132*47397Scael.It \&%T
13343081ScaelTitle of article or book
134*47397Scael.It \&%V
13543081ScaelVolume number
136*47397Scael.It \&%X
13743081ScaelAbstract \(em used by
13843081Scael.Xr roffbib ,
13943081Scaelnot by
14043081Scael.Xr refer
141*47397Scael.It \&%Y,Z
14243081Scaelignored by
14343081Scael.Xr refer
144*47397Scael.El
14543081Scael.Pp
14619701SmckusickExcept for `A', each field should be given just once.
14719701SmckusickOnly relevant fields should be supplied.
14843081Scael.Sh EXAMPLES
149*47397Scael.Bl -tag -width \&%Y,Z -compact -offset indent
150*47397Scael.It \&%A
15143081ScaelBill Tuthill
152*47397Scael.It \&%T
15343081ScaelRefer \(em A Bibliography System
154*47397Scael.It \&%I
15543081ScaelComputing Services
156*47397Scael.It \&%C
15743081ScaelBerkeley
158*47397Scael.It \&%D
15943081Scael1982
160*47397Scael.It \&%O
161*47397ScaelUNX 4.3.5.
162*47397Scael.El
16343081Scael.Sh FILES
164*47397Scael.Bl -tag -width promptfile -compact
165*47397Scael.It Pa promptfile
16643081Scaeloptional file to define prompting
167*47397Scael.El
16843081Scael.Sh SEE ALSO
16943081Scael.Xr refer 1 ,
17043081Scael.Xr sortbib 1 ,
17143081Scael.Xr roffbib 1 ,
17243081Scael.Xr indxbib 1 ,
17343081Scael.Xr lookbib 1
174*47397Scael.Sh AUTHORS
175*47397Scael.An Al Stangenberger, Bill Tuthill
17643081Scael.Sh HISTORY
177*47397ScaelThe
178*47397Scael.Nm
179*47397Scaelcommand appeared in
180*47397Scael.Bx 4.2 .
181