xref: /csrg-svn/old/refer/addbib/addbib.1 (revision 51121)
143081Scael.\" Copyright (c) 1983, 1990 The Regents of the University of California.
243081Scael.\" All rights reserved.
319701Smckusick.\"
447397Scael.\" %sccs.include.redist.man%
519701Smckusick.\"
6*51121Scael.\"     @(#)addbib.1	6.5 (Berkeley) 09/13/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
1647397Scael.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
6147397ScaelOptions avilable:
62*51121Scael.Bl -tag -width flag
6347397Scael.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 .
7047397Scael.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 .
8047397Scael.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.
8847397Scael.Pp
8947397Scael.Bl -tag -width "%Y,Z " -compact -offset indent
9047397Scael.It \&%A
9143081ScaelAuthor's name
9247397Scael.It \&%B
9343081ScaelBook containing article referenced
9447397Scael.It \&%C
9543081ScaelCity (place of publication)
9647397Scael.It \&%D
9743081ScaelDate of publication
9847397Scael.It \&%E
9943081ScaelEditor of book containing article referenced
10047397Scael.It \&%F
10143081ScaelFootnote number or label (supplied by
10243081Scael.Xr refer )
10347397Scael.It \&%G
10443081ScaelGovernment order number
10547397Scael.It \&%H
10643081ScaelHeader commentary, printed before reference
10747397Scael.It \&%I
10843081ScaelIssuer (publisher)
10947397Scael.It \&%J
11043081ScaelJournal containing article
11147397Scael.It \&%K
11243081ScaelKeywords to use in locating reference
11347397Scael.It \&%L
11443081ScaelLabel field used by
11543081Scael.Fl k
11643081Scaeloption of
11743081Scael.Xr refer
11847397Scael.It \&%M
11943081ScaelMemorandum label
12047397Scael.It \&%N
12143081ScaelNumber within volume
12247397Scael.It \&%O
12343081ScaelOther commentary, printed at end of reference
12447397Scael.It \&%P
12543081ScaelPage number(s)
12647397Scael.It \&%Q
12743081ScaelCorporate or Foreign Author (unreversed)
12847397Scael.It \&%R
12943081ScaelReport, paper, or thesis (unpublished)
13047397Scael.It \&%S
13143081ScaelSeries title
13247397Scael.It \&%T
13343081ScaelTitle of article or book
13447397Scael.It \&%V
13543081ScaelVolume number
13647397Scael.It \&%X
13743081ScaelAbstract \(em used by
13843081Scael.Xr roffbib ,
13943081Scaelnot by
14043081Scael.Xr refer
14147397Scael.It \&%Y,Z
14243081Scaelignored by
14343081Scael.Xr refer
14447397Scael.El
14543081Scael.Pp
14619701SmckusickExcept for `A', each field should be given just once.
14719701SmckusickOnly relevant fields should be supplied.
14843081Scael.Sh EXAMPLES
14947397Scael.Bl -tag -width \&%Y,Z -compact -offset indent
15047397Scael.It \&%A
15143081ScaelBill Tuthill
15247397Scael.It \&%T
15343081ScaelRefer \(em A Bibliography System
15447397Scael.It \&%I
15543081ScaelComputing Services
15647397Scael.It \&%C
15743081ScaelBerkeley
15847397Scael.It \&%D
15943081Scael1982
16047397Scael.It \&%O
16147397ScaelUNX 4.3.5.
16247397Scael.El
16343081Scael.Sh FILES
16447397Scael.Bl -tag -width promptfile -compact
16547397Scael.It Pa promptfile
16643081Scaeloptional file to define prompting
16747397Scael.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
17447397Scael.Sh AUTHORS
17547397Scael.An Al Stangenberger, Bill Tuthill
17643081Scael.Sh HISTORY
17747397ScaelThe
17847397Scael.Nm
17947397Scaelcommand appeared in
18047397Scael.Bx 4.2 .
181