Debian Codegraph @

texmf-dist/doc/man/man1/bbl2bib.1

raw
1 .\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.42)
2 .\"
3 .\" Standard preamble:
4 .\" ========================================================================
5 .de Sp \" Vertical space (when we can't use .PP)
6 .if t .sp .5v
7 .if n .sp
8 ..
9 .de Vb \" Begin verbatim text
10 .ft CW
11 .nf
12 .ne \\$1
13 ..
14 .de Ve \" End verbatim text
15 .ft R
16 .fi
17 ..
18 .\" Set up some character translations and predefined strings. \*(-- will
19 .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
20 .\" double quote, and \*(R" will give a right double quote. \*(C+ will
21 .\" give a nicer C++. Capital omega is used to do unbreakable dashes and
22 .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff,
23 .\" nothing in troff, for use with C<>.
24 .tr \(*W-
25 .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
26 .ie n \{\
27 . ds -- \(*W-
28 . ds PI pi
29 . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
30 . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch
31 . ds L" ""
32 . ds R" ""
33 . ds C` ""
34 . ds C' ""
35 'br\}
36 .el\{\
37 . ds -- \|\(em\|
38 . ds PI \(*p
39 . ds L" ``
40 . ds R" ''
41 . ds C`
42 . ds C'
43 'br\}
44 .\"
45 .\" Escape single quotes in literal strings from groff's Unicode transform.
46 .ie \n(.g .ds Aq \(aq
47 .el .ds Aq '
48 .\"
49 .\" If the F register is >0, we'll generate index entries on stderr for
50 .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
51 .\" entries marked with X<> in POD. Of course, you'll have to process the
52 .\" output yourself in some meaningful fashion.
53 .\"
54 .\" Avoid warning from groff about undefined register 'F'.
55 .de IX
56 ..
57 .nr rF 0
58 .if \n(.g .if rF .nr rF 1
59 .if (\n(rF:(\n(.g==0)) \{\
60 . if \nF \{\
61 . de IX
62 . tm Index:\\$1\t\\n%\t"\\$2"
63 ..
64 . if !\nF==2 \{\
65 . nr % 0
66 . nr F 2
67 . \}
68 . \}
69 .\}
70 .rr rF
71 .\"
72 .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
73 .\" Fear. Run. Save yourself. No user-serviceable parts.
74 . \" fudge factors for nroff and troff
75 .if n \{\
76 . ds #H 0
77 . ds #V .8m
78 . ds #F .3m
79 . ds #[ \f1
80 . ds #] \fP
81 .\}
82 .if t \{\
83 . ds #H ((1u-(\\\\n(.fu%2u))*.13m)
84 . ds #V .6m
85 . ds #F 0
86 . ds #[ \&
87 . ds #] \&
88 .\}
89 . \" simple accents for nroff and troff
90 .if n \{\
91 . ds ' \&
92 . ds ` \&
93 . ds ^ \&
94 . ds , \&
95 . ds ~ ~
96 . ds /
97 .\}
98 .if t \{\
99 . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
100 . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
101 . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
102 . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
103 . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
104 . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
105 .\}
106 . \" troff and (daisy-wheel) nroff accents
107 .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
108 .ds 8 \h'\*(#H'\(*b\h'-\*(#H'
109 .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
110 .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
111 .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
112 .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
113 .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
114 .ds ae a\h'-(\w'a'u*4/10)'e
115 .ds Ae A\h'-(\w'A'u*4/10)'E
116 . \" corrections for vroff
117 .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
118 .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
119 . \" for low resolution devices (crt and lpr)
120 .if \n(.H>23 .if \n(.V>19 \
121 \{\
122 . ds : e
123 . ds 8 ss
124 . ds o a
125 . ds d- d\h'-1'\(ga
126 . ds D- D\h'-1'\(hy
127 . ds th \o'bp'
128 . ds Th \o'LP'
129 . ds ae ae
130 . ds Ae AE
131 .\}
132 .rm #[ #] #H #V #F C
133 .\" ========================================================================
134 .\"
135 .IX Title "bbl2bib 1"
136 .TH bbl2bib 1 "2025-09-25" "" "LATEX CROSSREFWARE"
137 .\" For nroff, turn off justification. Always turn off hyphenation; it makes
138 .\" way too many mistakes in technical documents.
139 .if n .ad l
140 .nh
141 .SH "NAME"
142 bbl2bib.pl \- convert thebibliography environment to a bib file
143 .SH "SYNOPSIS"
144 .IX Header "SYNOPSIS"
145 bbl2bib.pl [\-d] [\-u] [\fB\-o\fR \fIoutput\fR] \fIfile\fR
146 .SH "OPTIONS"
147 .IX Header "OPTIONS"
148 .IP "[\-d]" 4
149 .IX Item "[-d]"
150 Send debugging output to stdout
151 .IP "\fB\-o\fR \fIoutput\fR" 4
152 .IX Item "-o output"
153 Output file. If this option is not used, the name for the
154 output file is formed by changing the extension to \f(CW\*(C`.bib\*(C'\fR
155 .IP "\fB\-u\fR" 4
156 .IX Item "-u"
157 Do not clean \s-1URL\s0 fields.
158 .Sp
159 Normally \f(CW\*(C`bbl2bib\*(C'\fR recognizes \s-1URL\s0 fields of the kind
160 \&\f(CW\*(C`http://dx.doi.org\*(C'\fR and their variants and converts them to \s-1DOI\s0
161 fields (see also \fBbiburl2doi\fR\|(1) script). The switch \fB\-u\fR
162 suppresses this cleanup.
163 .SH "DESCRIPTION"
164 .IX Header "DESCRIPTION"
165 The script tries to reconstruct a \f(CW\*(C`bib\*(C'\fR file from the corresponding
166 \&\f(CW\*(C`thebibliography\*(C'\fR environment. One can argue that this operation is
167 akin to reconstructing a cow from the steak. The way the script does
168 it is searching for the entry in the \s-1MR\s0 database, and
169 creating the corresponding BibTeX fields.
170 .PP
171 The script reads a TeX or Bbl file and extracts from it the
172 \&\f(CW\*(C`thebibliography\*(C'\fR environment. For each bibitem it creates a plain
173 text bibliography entry, and then tries to match it in
174 the database.
175 .SH "INPUT FILE"
176 .IX Header "INPUT FILE"
177 We assume some structure of the input file:
178 .IP "1." 4
179 The bibliography is contained between the lines
180 .Sp
181 .Vb 1
182 \& \ebegin{thebibliography}...
183 .Ve
184 .Sp
185 and
186 .Sp
187 .Vb 1
188 \& \eend{thebibliography}
189 .Ve
190 .IP "2." 4
191 Each bibliography item starts from the line
192 .Sp
193 .Vb 1
194 \& \ebibitem[...]{....}
195 .Ve
196 .SH "EXAMPLES"
197 .IX Header "EXAMPLES"
198 .Vb 3
199 \& bbl2bib \-o \- file.tex > result.bib
200 \& bbl2bib \-o result.bib file.bbl
201 \& bbl2bib file.tex
202 .Ve
203 .SH "AUTHOR"
204 .IX Header "AUTHOR"
205 Boris Veytsman
206 .SH "COPYRIGHT AND LICENSE"
207 .IX Header "COPYRIGHT AND LICENSE"
208 Copyright (C) 2014\-2021 Boris Veytsman
209 .PP
210 This is free software. You may redistribute copies of it under the
211 terms of the \s-1GNU\s0 General Public License
212 <http://www.gnu.org/licenses/gpl.html>. There is \s-1NO WARRANTY,\s0 to the
213 extent permitted by law.