1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
|
User Commands ams2bib(1)
NAME
ams2bib - convert AmSTeX bibliography into BibTeX
SYNOPSIS
ams2bib [-o file.bib] file[.tex]
DESCRIPTION
ams2bib takes a file consisting of AmSTeX bibliography
entries and produces a file consisting of the same biblio
graphic entries, but in BibTeX format.
OPTIONS
-o file[.bib]
Specify the name of the BibTeX file to produce. The
default is to use name.bib, where name is file,
stripped of any filename extension.
-h Display a brief help message.
USAGE
The only non-option command-line parameter is the name of an
input file. If no filename extension is given, the default
extension tex is assumed. This file must consist of AmSTeX
bibliography entries.
The output file consists of BibTeX bibliographic entries.
The kind of BibTeX entry produced depends on the correspond
ing AmSTeX entry. If the AmSTeX entry contains \book, then
a Book BibTeX entry is produced. Otherwise, if the AmSTeX
entry contains \inbook, then a InCollection BibTeX entry is
produced. Otherwise, if the AmSTeX entry contains \paper,
then an Article BibTeX entry is produced. If none of these
three AmSTeX control sequence is contained, then the AmSTeX
entry is considered to be in error.
Note that a key is automatically generated for each BibTeX
entry. This key consists of all the authors' names cate
nated together, followed by the date found in the \year
field. If this would result in duplicate keys, then an
alphabetic letter ("b", "c", etc.) is appended to the key.
Users who want to use other kinds of automatically-generated
keys should consider using Gerd Neugebauer's bibtool, which
is available via CTAN (http://www.ctan.org).
SEE ALSO
amstex(1), bibtool(1), bibtex(1), latex(1), tex(1).
LIMITATIONS
One of the main differences between AmSTeX and BibTeX is
that BibTeX provides a greater variety bibliographic entries
than does AmSTeX. This means that an AmSTeX bibliography
will often use ad hoc methods in cases where a BibTeX bibli
ography can be more straightforward. In such situations,
the user will have to make corrections by hand. For exam
ple, unpublished articles and technical reports have stan
dard BibTeX bibliographic entries, but are usually done in
AmSTeX by adding information to the \paperinfo field; hence,
unpublished articles and technical reports will need to be
edited by hand.
Error checking is minimal. ams2bib only does the usual com
mand-line parameter checking. In particular, the syntax of
the AmSTeX file is not checked.
As mentioned above, duplicate keys would normally result if
the authors and year match for more than one entry. This is
resolved by appending an alphabetic letter to the key. At
most nine such additional letters ("b" through "j") are
added.
AUTHOR
Copyright (c) Arthur G. Werschulz 2000. ams2bib may be
freely redistributed under the Gnu Public License. Send
mail to agw@cs.columbia.edu if you have any questions or
suggestions.
|