Debian Codegraph @

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

raw
1 .TH BIBTEX8 "1" "12 September 2022" "bibtex8 4.00" "User Commands"
2 .SH NAME
3 bibtex8 \- 8-bit Big BibTeX
4 .SH SYNOPSIS
5 .B bibtex8
6 [\fIoptions\fR] \fIaux-file\fR
7 .SH DESCRIPTION
8 .PP
9 .B BibTeX8
10 is an 8-bit implementation of BibTeX written in C.
11 It has been enhanced by adding the following features:
12 .PP
13 - "big" (32-bit) and customisable capacity
14 .PP
15 - flexible support for non-English languages using 8-bit character sets
16 .PP
17 .B BibTeX8
18 accepts 8-bit characters in its input files, and writes 8-bit
19 characters to its output files. The character set is defined by an
20 external configuration file --- the Codepage and Sort order ("CS") file.
21 By default, it reads a specific CS file "88591lat.csf", which defines
22 ISO 8859-1 character set and its alphabetical sorting order including
23 accented characters.
24 .SH OPTIONS
25 .TP
26 \fB\-?\fR \fB\-\-help\fR
27 display some brief help text.
28 .TP
29 \fB\-7\fR \fB\-\-traditional\fR
30 operate in the original 7\-bit mode, no CS file used.
31 Only 7\-bit ASCII characters are supported, and they are
32 sorted by ASCII code value.
33 .TP
34 \fB\-8\fR \fB\-\-8bit\fR
35 force 8\-bit mode, no CS file used.
36 All 8\-bit characters (code > 127) are treated as letters,
37 and they are sorted by their code value.
38 .TP
39 \fB\-c\fR \fB\-\-csfile\fR FILE
40 read FILE as the BibTeX character set
41 and sort definition file.
42 Note that options \fB\-7\fR, \fB\-8\fR and \fB\-c\fR are exclusive.
43 .TP
44 \fB\-d\fR \fB\-\-debug\fR TYPE
45 report debugging information. TYPE is one
46 or more of all, csf, io, mem, misc, search.
47 .TP
48 \fB\-s\fR \fB\-\-statistics\fR
49 report internal statistics.
50 .TP
51 \fB\-t\fR \fB\-\-trace\fR
52 report execution tracing.
53 .TP
54 \fB\-v\fR \fB\-\-version\fR
55 report BibTeX version.
56 .TP
57 \fB\-B\fR \fB\-\-big\fR
58 set large BibTeX capacity.
59 .TP
60 \fB\-H\fR \fB\-\-huge\fR
61 set huge BibTeX capacity.
62 .TP
63 \fB\-W\fR \fB\-\-wolfgang\fR
64 set really huge BibTeX capacity for Wolfgang.
65 .TP
66 \fB\-M\fR \fB\-\-min_crossrefs\fR ##
67 set min_crossrefs to ##.
68 .TP
69 \fB\-\-mcites\fR ##
70 allow ## \ecites in the .aux files (deprecated).
71 .TP
72 \fB\-\-mentints\fR ##
73 allow ## integer entries in the .bib databases (deprecated).
74 .TP
75 \fB\-\-mentstrs\fR ##
76 allow ## string entries in the .bib databases (deprecated).
77 .TP
78 \fB\-\-mfields\fR ##
79 allow ## fields in the .bib databases (deprecated).
80 .TP
81 \fB\-\-mpool\fR ##
82 set the string pool to ## bytes (deprecated).
83 .TP
84 \fB\-\-mstrings\fR ##
85 allow ## unique strings.
86 .TP
87 \fB\-\-mwizfuns\fR ##
88 allow ## wizard functions (deprecated).
89
90 .SH 8BIT LATIN LETTERS SUPPORT
91 .PP
92 .B BibTeX8
93 supports extended features to handle 8bit latin letters.
94 Several built-in functions in bibliography styles are enhanced as follows.
95 .TP
96 \fB&\fR
97 Pops the top two (integer) literals and pushes their bitwise AND.
98 .TP
99 \fB|\fR
100 Pops the top two (integer) literals and pushes their bitwise OR.
101 .TP
102 \fBchr.to.int$\fR, \fBint.to.chr$\fR
103 The function is the same as original BibTeX but 8bit characters are accepted.
104 .TP
105 \fBwidth$\fR
106 The function is the same as original BibTeX but letters of Latin-1 are supported.
107 .SH SEE ALSO
108 More detailed description of
109 .B BibTeX8
110 is available at $TEXMFDIST/doc/bibtex8/00readme.txt.
111 The syntax of Codepage and Sort order (CS) File can be found at
112 $TEXMFDIST/doc/bibtex8/csfile.txt.
113 .SH AUTHORS
114 .B BibTeX8
115 was written by Niel Kempson and Alejandro Aguilar-Sierra. It is currently
116 maintained as part of TeX Live.
117 .PP
118 This manpage was written for TeX Live, based on the work
119 by Norbert Preining for Debian GNU/Linux.