|
|
1.1 root 1: .TH ADDBIB 1 "18 July 1983"
2: .UC 4
3: .SH NAME
4: addbib \- create or extend bibliographic database
5: .SH SYNOPSIS
6: \fBaddbib\fP [ \fB\-p\fP promptfile ] [ \fB\-a\fP ] database
7: .SH DESCRIPTION
8: When this program starts up, answering ``y''
9: to the initial ``Instructions?'' prompt yields directions;
10: typing ``n'' or \s-2RETURN\s0 skips them.
11: .I Addbib
12: then prompts for various bibliographic fields,
13: reads responses from the terminal,
14: and sends output records to a
15: .I database.
16: A null response (just \s-2RETURN\s0) means to leave out that field.
17: A minus sign (\-) means to go back to the previous field.
18: A trailing backslash allows a field to be continued on the next line.
19: The repeating ``Continue?'' prompt allows the user
20: either to resume by typing ``y'' or \s-2RETURN\s0,
21: to quit the current session by typing ``n'' or ``q'',
22: or to edit the
23: .I database
24: with any system editor \fI(vi, ex, edit, ed).\fP
25: .PP
26: The
27: .B \-a
28: option suppresses prompting for an abstract;
29: asking for an abstract is the default.
30: Abstracts are ended with a \s-2CTRL\s0-d.
31: The
32: .B \-p
33: option causes
34: .I addbib
35: to use a new prompting skeleton, defined in
36: .I promptfile.
37: This file should contain prompt strings, a tab,
38: and the key-letters to be written to the
39: .I database.
40: .PP
41: The most common key-letters and their meanings are given below.
42: .I Addbib
43: insulates you from these key-letters,
44: since it gives you prompts in English,
45: but if you edit the bibliography file later on,
46: you will need to know this information.
47: .sp
48: .nf
49: %A Author's name
50: %B Book containing article referenced
51: %C City (place of publication)
52: %D Date of publication
53: %E Editor of book containing article referenced
54: %F Footnote number or label (supplied by \fIrefer\fP\|)
55: %G Government order number
56: %H Header commentary, printed before reference
57: %I Issuer (publisher)
58: %J Journal containing article
59: %K Keywords to use in locating reference
60: %L Label field used by \fB\-k\fP option of \fIrefer\fP
61: %M Bell Labs Memorandum (undefined)
62: %N Number within volume
63: %O Other commentary, printed at end of reference
64: %P Page number(s)
65: %Q Corporate or Foreign Author (unreversed)
66: %R Report, paper, or thesis (unpublished)
67: %S Series title
68: %T Title of article or book
69: %V Volume number
70: %X Abstract \(em used by \fIroffbib\fP, not by \fIrefer\fP
71: %Y,Z ignored by \fIrefer\fP
72: .fi
73: .sp
74: Except for `A', each field should be given just once.
75: Only relevant fields should be supplied.
76: An example is:
77: .sp
78: .nf
79: %A Bill Tuthill
80: %T Refer \(em A Bibliography System
81: %I Computing Services
82: %C Berkeley
83: %D 1982
84: %O \s-1UNX\s0 4.3.5.
85: .fi
86: .sp
87: .SH FILES
88: .DT
89: promptfile optional file to define prompting
90: .SH SEE ALSO
91: refer(1), sortbib(1), roffbib(1), indxbib(1), lookbib(1)
92: .SH AUTHORS
93: Al Stangenberger, Bill Tuthill
94: .SH BUGS
95: Gets into a loop if not used with the -a flag.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.