1=head1 NAME
2
3bib2xml - A perl script that generates an XML file for a BibTeX database
4
5
6=head1 SYNOPSYS
7
8bib2xml [options] F<file> [F<file> ...]
9
10=head1 DESCRIPTION
11
12bib2xml is a script which permits to generate a XML file for
13the entries of BibTeX files.
14
15The generated XML file is compliant with the DTD from http://bibtexml.sf.net
16
17The bib2xml command is equivalent to:
18bib2html [options] F<file> [F<file> ...] -g XML
19
20=head1 OPTIONS
21
22=over 4
23
24=item B<-[no]b>
25
26=item B<--[no]bibtex>
27
28This option permits to generate, or not, a verbatim of the
29BibTeX entry code.
30
31=item B<--[no]checknames>
32
33This option permits to check if the some author's names are
34similar and generates a set of warnings about each of them.
35
36=item B<--cvs>
37
38If specified, this option disables the deletion of the subfiles
39'.cvs', 'CVS' and 'CVSROOT' in the output directory.
40
41=item B<-d> I<name>[=I<value>]
42
43See B<--generatorparam>.
44
45=item B<--doctitle> I<text>
46
47Sets the title that appears in the main page.
48
49=item B<-f>
50
51=item B<--force>
52
53Forces to overwrite into the output directory.
54
55=item B<-g> I<class>
56
57=item B<--generator> I<class>
58
59Sets the generator to use. I<class> must be a valid Perl class.
60
61=item B<--generatorparam> I<name>[=I<value>]
62
63Sets a generator param. It must be a I<key>=I<value> pair or
64simply a I<name>.
65Example: "target=thisdirectory" defines the parameter target
66with corresponding value "thisdirectory". The specified
67parameters which are not supported by the generator are
68ignored.
69
70=item B<--generatorparams>
71
72Shows the list of supported parameters, and their
73semantics for the current generator.
74
75=item B<--genlist>
76
77Shows the list of supported generators.
78
79=item B<-?>
80
81=item B<-h>
82
83Show the list of available options.
84
85=item B<--help>
86
87See B<--man>.
88
89=item B<--jabref>
90
91The generator will translate JabRef's groups
92into Bib2HTML's domains.
93
94=item B<--lang> I<name>
95
96Sets the language used by the generator.
97
98=item B<--langlist>
99
100Shows the list of supported language.
101
102=item B<--man>
103
104=item B<--manual>
105
106Show the manual page.
107
108=item B<-o> F<file>
109
110=item B<--output> F<file>
111
112Sets the directory or the F<file> in which the documentation will be put.
113
114=item B<-p> F<file>
115
116=item B<--preamble> F<file>
117
118Sets the name of the F<file> to read to include some TeX preambles.
119You could use this option to dynamicaly defined some unsupported
120LaTeX commands.
121
122=item B<--protect> F<shell_wildcard>
123
124If specified, this option disables the deletion in the target
125directory of the subfiles that match the specified shell
126expression.
127
128=item B<-q>
129
130Don't be verbose: only error messages are displayed.
131
132=item B<--[no]sortw>
133
134Shows (or not) a sorted list of warnings.
135
136=item B<--stdout>
137
138Force the output of the generated files onto the standard output.
139This option is equivalent to C<-d stdout>.
140
141=item B<--svn>
142
143If specified, this option disables the deletion of the subfiles
144'.svn' and 'svn' in the output directory.
145
146=item B<--texcmd>
147
148Shows the list of supported LaTeX commands.
149
150=item B<--theme> I<name>
151
152Sets the theme used by the generator.
153
154=item B<--themelist>
155
156Shows the list of supported themes.
157
158=item B<-v>
159
160Be more verbose.
161
162=item B<--version>
163
164Show the version of this script.
165
166=item B<--[no]warning>
167
168If false, the warning are converted to errors.
169
170=item B<--windowtitle> I<text>
171
172Sets the title that appears as the window's title.
173
174=back
175
176=head1 LICENSE
177
178S<GNU Public License (GPL)>
179
180=head1 COPYRIGHT
181
182S<Copyright (c) 1998-06 St�phane Galland E<lt>galland@arakhne.orgE<gt>>
183
184=head1 CONTRIBUTORS
185
186=over
187
188=item S<Aurel GABRIS E<lt>L<gabrisa@optics.szfki.kfki.hu>E<gt>>
189
190=item S<Gasper JAKLIC E<lt>L<gasper.jaklic@fmf.uni-lj.si>E<gt>>
191
192=item S<Tobias LOEW E<lt>L<loew@mathematik.tu-darmstadt.de>E<gt>>
193
194=item S<Joao LOURENCO E<lt>L<joao.lourenco@di.fct.unl.pt>E<gt>>
195
196=item S<Dimitris MICHAIL E<lt>L<michail@mpi-sb.mpg.de>E<gt>>
197
198=item S<Luca PAOLINI E<lt>L<paolini@di.unito.it>E<gt>>
199
200=item S<Norbert PREINING E<lt>L<preining@logic.at>E<gt>>
201
202=item S<Cristian RIGAMONTI E<lt>L<cri@linux.it>E<gt>>
203
204=item S<Sebastian RODRIGUEZ E<lt>L<sebastian.rodriguez@utbm.fr>E<gt>>
205
206=item S<Martin P.J. ZINSER E<lt>L<zinser@zinser.no-ip.info>E<gt>>
207
208=item S<Olivier HUGHES E<lt>L<olivier.hugues@gmail.com>E<gt>>
209
210=back
211
212=head1 SEE ALSO
213
214L<bib2html>, L<latex>, L<bibtex>
215