xref: /csrg-svn/old/refer/addbib/addbib.1 (revision 43081)
1*43081Scael.\" Copyright (c) 1983, 1990 The Regents of the University of California.
2*43081Scael.\" All rights reserved.
319701Smckusick.\"
419701Smckusick.\"
5*43081Scael.\"     @(#)addbib.1	6.2 (Berkeley) 06/11/90
6*43081Scael.\"
7*43081Scael.Dd
8*43081Scael.Os BSD 4.2
9*43081Scael.Dt ADDBIB 1
10*43081Scael.Sh NAME
11*43081Scael.Nm addbib
12*43081Scael.Nd create or extend bibliographic database
13*43081Scael.Sh SYNOPSIS
14*43081Scael.Nm addbib
15*43081Scael.Op Fl p Ar promptfile
16*43081Scael.Op Fl a
17*43081Scael.Ar database
18*43081Scael.Sh DESCRIPTION
19*43081ScaelWhen this program starts up, answering
20*43081Scael.Li y
21*43081Scaelto the initial
22*43081Scael.Li Instructions?
23*43081Scaelprompt yields directions;
24*43081Scaeltyping
25*43081Scael.Li n
26*43081Scaelor
27*43081Scael.Li RETURN
28*43081Scaelskips them.
29*43081Scael.Nm Addbib
3019701Smckusickthen prompts for various bibliographic fields,
3119701Smckusickreads responses from the terminal,
3219701Smckusickand sends output records to a
33*43081Scael.Ar database .
34*43081ScaelA null response (just
35*43081Scael.Li RETURN )
36*43081Scaelmeans to leave out that field.
37*43081ScaelA minus sign
38*43081Scael.Li (\-)
39*43081Scaelmeans to go back to the previous field.
4019701SmckusickA trailing backslash allows a field to be continued on the next line.
41*43081ScaelThe repeating
42*43081Scael.Li Continue?
43*43081Scaelprompt allows the user
44*43081Scaeleither to resume by typing
45*43081Scael.Li y
46*43081Scaelor
47*43081Scael.Li RETURN ,
48*43081Scaelto quit the current session by typing
49*43081Scael.Li n
50*43081Scaelor
51*43081Scael.Li q ,
5219701Smckusickor to edit the
53*43081Scael.Ar database
54*43081Scaelwith any system editor (.e.g.
55*43081Scael.Xr vi ,
56*43081Scael.Xr ex ,
57*43081Scael.Xr edit ,
58*43081Scael.Xr ed ) .
59*43081Scael.Pp
6019701SmckusickThe
61*43081Scael.Fl a
6219701Smckusickoption suppresses prompting for an abstract;
6319701Smckusickasking for an abstract is the default.
64*43081ScaelAbstracts are ended with a
65*43081Scael.Li CTRL-d .
6619701SmckusickThe
67*43081Scael.Fl p
6819701Smckusickoption causes
69*43081Scael.Nm addbib
7019701Smckusickto use a new prompting skeleton, defined in
71*43081Scael.Ar promptfile .
7219701SmckusickThis file should contain prompt strings, a tab,
7319701Smckusickand the key-letters to be written to the
74*43081Scael.Ar database .
75*43081Scael.Pp
7619701SmckusickThe most common key-letters and their meanings are given below.
77*43081Scael.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.
82*43081Scael.Dw \&%Y,Z
83*43081Scael.Dp \&%A
84*43081ScaelAuthor's name
85*43081Scael.Dp \&%B
86*43081ScaelBook containing article referenced
87*43081Scael.Dp \&%C
88*43081ScaelCity (place of publication)
89*43081Scael.Dp \&%D
90*43081ScaelDate of publication
91*43081Scael.Dp \&%E
92*43081ScaelEditor of book containing article referenced
93*43081Scael.Dp \&%F
94*43081ScaelFootnote number or label (supplied by
95*43081Scael.Xr refer )
96*43081Scael.Dp \&%G
97*43081ScaelGovernment order number
98*43081Scael.Dp \&%H
99*43081ScaelHeader commentary, printed before reference
100*43081Scael.Dp \&%I
101*43081ScaelIssuer (publisher)
102*43081Scael.Dp \&%J
103*43081ScaelJournal containing article
104*43081Scael.Dp \&%K
105*43081ScaelKeywords to use in locating reference
106*43081Scael.Dp \&%L
107*43081ScaelLabel field used by
108*43081Scael.Fl k
109*43081Scaeloption of
110*43081Scael.Xr refer
111*43081Scael.Dp \&%M
112*43081ScaelMemorandum label
113*43081Scael.Dp \&%N
114*43081ScaelNumber within volume
115*43081Scael.Dp \&%O
116*43081ScaelOther commentary, printed at end of reference
117*43081Scael.Dp \&%P
118*43081ScaelPage number(s)
119*43081Scael.Dp \&%Q
120*43081ScaelCorporate or Foreign Author (unreversed)
121*43081Scael.Dp \&%R
122*43081ScaelReport, paper, or thesis (unpublished)
123*43081Scael.Dp \&%S
124*43081ScaelSeries title
125*43081Scael.Dp \&%T
126*43081ScaelTitle of article or book
127*43081Scael.Dp \&%V
128*43081ScaelVolume number
129*43081Scael.Dp \&%X
130*43081ScaelAbstract \(em used by
131*43081Scael.Xr roffbib ,
132*43081Scaelnot by
133*43081Scael.Xr refer
134*43081Scael.Dp \&%Y,Z
135*43081Scaelignored by
136*43081Scael.Xr refer
137*43081Scael.Dp
138*43081Scael.Pp
13919701SmckusickExcept for `A', each field should be given just once.
14019701SmckusickOnly relevant fields should be supplied.
141*43081Scael.Sh EXAMPLES
142*43081Scael.Dw \&%Y,Z
143*43081Scael.Dp %A
144*43081ScaelBill Tuthill
145*43081Scael.Dp %T
146*43081ScaelRefer \(em A Bibliography System
147*43081Scael.Dp %I
148*43081ScaelComputing Services
149*43081Scael.Dp %C
150*43081ScaelBerkeley
151*43081Scael.Dp %D
152*43081Scael1982
153*43081Scael.Dp %O
154*43081Scael\s-1UNX\s0 4.3.5.
155*43081Scael.Dp
156*43081Scael.Sh FILES
157*43081Scael.Dw promptfile
158*43081Scael.Dp Pa promptfile
159*43081Scaeloptional file to define prompting
160*43081Scael.Sh SEE ALSO
161*43081Scael.Xr refer 1 ,
162*43081Scael.Xr sortbib 1 ,
163*43081Scael.Xr roffbib 1 ,
164*43081Scael.Xr indxbib 1 ,
165*43081Scael.Xr lookbib 1
166*43081Scael.Sh HISTORY
167*43081Scaelappeared in 4.2 BSD.
168*43081Scael.Sh AUTHORS
16919701SmckusickAl Stangenberger, Bill Tuthill
170