-
Notifications
You must be signed in to change notification settings - Fork 0
/
med2bib.1
98 lines (94 loc) · 2.97 KB
/
med2bib.1
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
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
.\" Process this file with
.\" groff -man -Tascii foo.1
.\"
.TH "MED2BIB, TOC2BIB" 1 "MARCH 1998" Linux "User Manuals"
.SH NAME
med2bib, toc2bib \- convert MEDLINE and TOC/DOC records to BibTeX format
.SH SYNOPSIS
.BI "med2bib [" medline-file "] [" bibtex-file ]
.BI "toc2bib [" tocdoc-file "] [" bibtex-file ]
.SH DESCRIPTION
.B med2bib
converts MEDLINE full-record ASCII bibliographic entries for journal articles
into BibTeX entries.
.B toc2bib
converts TOC/DOC (the electronic literature search engine available at
Caltech) full-record entries.
All entries from
.I medline-file
or
.I tocdoc-file
are parsed, converted into BibTeX fields, and appended to the end of
.I bibtex-file
(no checking is done as to the nature of
.IR bibtex-file ).
If only one argument is given, it is the input, and stdout is the
output. If no argument is given, stdin is the input and stdout the
output (for pipes).
A key is automatically generated for each entry. It is used in
\\cite{key} commands in LaTeX files, to cite the entry. Key generation
rules are:
.TP
If one author, year YY:
.B AuthorYY
(e.g., Wilson80)
.TP
If two authors, year YY:
.B Author1_Author2YY
(e.g., Hubel_Wiesel62)
.TP
If more than two authors, year YY:
.B Author1_etalYY
(e.g., Koch_etal96)
.P
No checking for duplicate keys is done. Only article BibTeX entries
are generated, with fields: author, title, journal (abbreviated in
MEDLINE but not in TOC/DOC), volume, number, pages (in short-hand
format, e.g., 1234-6), month (MEDLINE only), year, abstract, keyword
(separated by
.BR | ),
address, note (contains MEDLINE notes (e.g., publication of an erratum) and
language if not English).
.SH OPTIONS
none.
.SH FILES
.I medline-file
and
.I tocdoc-file
are obtained as follows:
.TP
.B MEDLINE by telnet (if you have a password):
After your search is done, type:
.B mail med to you@domain.
Save the email (no need to strip the header) into
.I medline-file.
.TP
.B MEDLINE on the WWW:
Found at http://www4.ncbi.nlm.nih.gov/PubMed/. Display the results in
MEDLINE format, and save as UNIX text into
.IR medline-file .
.TP
.B TOC/DOC by telnet (if you have a password):
After your search is done, type:
.B e
(email), then
.B 4
(TOC/DOC full record) and then enter your email address. After you
receive the email, save it (no need to strip the header) into
.IR tocdoc-file .
.SH DIAGNOSTICS
For each entry processed, a citation in short-hand format is output to
stderr, to check for progress and bugs.
.SH BUGS
Many subtleties in formatting, or missing information in the MEDLINE
and TOC/DOC formats will create imperfect outputs. Please check the
documentation supplied with the programs. In particular, in
.BR toc2bib ,
a heuristic algorithm is used to convert back to usual form the
all-capitalized titles and journal names. The algorithm has many
failure modes, and won't process correctly most acronyms or chemical
formulas.
.SH AUTHOR
Laurent Itti <[email protected]>
The official distribution can be found on the WWW, at:
<http://www.klab.caltech.edu/~itti/bibtex/>