BIBTEX8(1)

Okay bestie, this is the BIBTEX8(1) manual page from the User Commands section 🎀✨

💖 NAME 💖

bibtex8 is the 8-bit Big BibTeX, and it's giving main character energy 👑

🧚 SYNOPSIS 🧚

bibtex8 [options] aux-file

🌸 DESCRIPTION 🌸

okay so BibTeX8 is an 8-bit version of BibTeX written in C, and it's been glowed up with two big upgrades 💅

• "big" (32-bit) and customisable capacity 🦋
• flexible support for non-English languages using 8-bit character sets 🌈

BibTeX8 takes 8-bit characters in its input files and writes 8-bit characters to its output files, no cap 🫶 The character set comes from an external configuration file, the Codepage and Sort order ("CS") file. By default it reads a specific CS file called 88591lat.csf, which defines the ISO 8859-1 character set and its alphabetical sorting order, accented characters included. It's so iconic 😭✨

🎀 OPTIONS 🎀

• -?, --help — shows some brief help text, bestie 🙈
• -7, --traditional — runs in the original 7-bit mode with no CS file. Only 7-bit ASCII characters are supported, and they get sorted by their ASCII code value 🍓
• -8, --8bit — forces 8-bit mode with no CS file. Every 8-bit character (code > 127) gets treated as a letter, and they're sorted by their code value 💜
• -c FILE, --csfile FILE — reads FILE as the BibTeX character set and sort definition file. Lowkey important: -7, -8 and -c are exclusive, so you can't mix them 🚫
• -d TYPE, --debug TYPE — reports debugging info. TYPE is one or more of all, csf, io, mem, misc, search 🔥
• -s, --statistics — reports internal statistics 📊
• -t, --trace — reports execution tracing 🔍
• -v, --version — reports the BibTeX version 🌟
• -B, --big — sets a large BibTeX capacity 🐘
• -H, --huge — sets a huge BibTeX capacity 🚀
• -W, --wolfgang — sets a really huge BibTeX capacity, made for Wolfgang 💀
• -M ##, --min_crossrefs ## — sets min_crossrefs to ## 🎯
• --mcites ## — allows ## \cites in the .aux files. This one is deprecated, so it's on its way out 🥀
• --mentints ## — allows ## integer entries in the .bib databases. Also deprecated 🥀
• --mentstrs ## — allows ## string entries in the .bib databases. Deprecated too 🥀
• --mfields ## — allows ## fields in the .bib databases. Deprecated 🥀
• --mpool ## — sets the string pool to ## bytes. Deprecated as well 🥀
• --mstrings ## — allows ## unique strings ✨
• --mwizfuns ## — allows ## wizard functions. Deprecated 🥀

🌈 8BIT LATIN LETTERS SUPPORT 🌈

ngl this section is so good. BibTeX8 has extended features for handling 8-bit Latin letters, and a few built-in functions in bibliography styles got upgraded:

• & — pops the top two (integer) literals and pushes their bitwise AND 🧮
• | — pops the top two (integer) literals and pushes their bitwise OR 🧮
• chr.to.int$, int.to.chr$ — works just like the original BibTeX, but now 8-bit characters are accepted 🫧
• width$ — works just like the original BibTeX, but letters of Latin-1 are supported too 🩷

🦋 SEE ALSO 🦋

A more detailed description of BibTeX8 lives in $TEXMFDIST/doc/bibtex8/00readme.txt, and the syntax of the Codepage and Sort order (CS) File is in $TEXMFDIST/doc/bibtex8/csfile.txt. Go check them out, bestie 📚

👑 AUTHORS 👑

BibTeX8 was written by Niel Kempson and Alejandro Aguilar-Sierra. It's currently maintained as part of TeX Live, which is such a serious slay 💅

This manpage was written for TeX Live, based on the work by Norbert Preining for Debian GNU/Linux. Thank you, queens 🫶

Okay that's the whole page, bestie 💖 It's bibtex8 version 4.00 from 12 September 2022, filed under BIBTEX8(1). Periodt 🌸✨