BIBTEXU(1)

✨ NAME ✨

okay so this is BIBTEXU(1), the User Commands page, and the tool is bibtexu, aka UTF-8 Big BibTeX 💖

🎀 SYNOPSIS 🎀

bibtexu [options] aux-file

🌸 DESCRIPTION 🌸

okay bestie, BibTeXu is the Unicode-compliant version of BibTeX 😭✨ It's largely based on Niel Kempson's BibTeX8, and it gives you way better UTF-8 support by integrating the ICU library. So no more needing the Codepage and Sort order ("CS") file 🙅‍♀️ Instead, sorting and case-changing are controlled with command-line options. iconic, honestly 💅

🦋 OPTIONS 🦋

• -?, --help — shows some brief help text 🙈
• -d, --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 🏷️
• -l, --language LANG — uses language LANG to convert strings to lower case. This argument gets passed to the ICU library 🌍
• -o, --location LANG — uses language LANG for sorting. This argument also gets passed to the ICU library 🧚
• -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 ## 💜
• --mstrings ## — allows ## unique strings 🫶

🌈 UNICODE SUPPORT 🌈

okay so BibTeXu has extended features for handling Unicode characters ✨ Several built-in functions in bibliography styles get a glow-up, and here's the tea:

• & — pops the top two (integer) literals and pushes their bitwise AND 🧮
• | — pops the top two (integer) literals and pushes their bitwise OR 🧮
• add.period$ — pops the top (string) literal and adds a . to it if the last non}' character isn't a ., ?, !`, or a Unicode punctuation mark. The mark can be U+203C, U+203D, U+2047, U+2048, U+2049, U+3002, U+FF01, U+FF0E or U+FF1F. Then it pushes the resulting string 💅
• chr.to.int$ — pops the top (string) literal, makes sure it's a multibyte string of a single Unicode code point, converts it to the matching Unicode scalar value (integer), and pushes that integer 🔢
• int.to.chr$ — pops the top (integer) literal, treats it as the Unicode scalar value of a single code point, converts it to the matching single-character multibyte string, and pushes that string 🔤
• num.names$, format.name$ — same as original BibTeX, but an Ideographic/Fullwidth Comma (U+3001, U+FF0C) is accepted as a separator between persons on top of the " and " string. An Ideographic Space (U+3000) is also accepted between a family name and a given name, alongside the regular space " " 🎀
• substring$, text.length$, text.prefix$ — same as original BibTeX, but the unit of operand numbers is the Unicode code point 🌸
• change.case$ — same as original BibTeX, but letters from non-English Latin, Greek and Cyrillic are supported now 🌍
• width$ — same as original BibTeX, but letters of Latin-1, Latin Extended-A and CJK characters are supported 📏
• is.cjk.str$ — pops the top (string) literal and sets flag bits in an integer if CJK characters show up in the string, then pushes that integer. Otherwise it pushes 0. Flags 0x001, 0x002, 0x004, 0x008 and 0x800 match Hanzi (Kanji, Hanja), Kana, Hangul, Bopomofo and other CJK characters, respectively. For example, the integer 0x003 gets pushed if Hanzi and Kana characters are found in a popped string literal 🇯🇵
• is.kanji.str$ — same as is.cjk.str$, just kept around for compatibility with (u)pBibTeX 🫶

🦋 SEE ALSO 🦋

more detailed description of BibTeXu lives at $TEXMFDIST/doc/bibtexu/README. go read it when you're feeling nerdy 🤓

💜 AUTHORS 💜

BibTeXu was written by Yannis Haralambous and his students. It's maintained as part of TeX Live 🧚

this manpage was written for TeX Live 🎀

bye bestie 💖 you've been reading bibtexu 4.00, last updated 30 August 2022, and you literally just learned Unix like a pro ✨🫶