TEXJAVA(1)

💖 TEXJAVA — the texjava manual page, but make it a group chat 💖

okay bestie, sit down, hydrate, because this one is genuinely iconic. this is the texjava page from the texjava User Manual and it is short, sweet, and absolutely carrying the entire "your docs and your code will never fight again" agenda. 🫶

✨ NAME ✨

texjava — create a Java file from an associated LaTex file 🦋

like. that's the whole job. and she does it flawlessly. no notes.

✨ SYNOPSIS ✨

texjava [-(no)images] [-(no)html] [-(no)savelatex] [-(no)htmlonly]
[-htmltitle title] [-htmloutdir dir] [-master master] <fin> [<fout>]

so the way this works, bestie: you've got a bunch of flags that come in -(no) pairs — -images / -noimages, -html / -nohtml, -savelatex / -nosavelatex, -htmlonly / -nohtmlonly — so you can flip each one either way, slay 💅

then there's the ones that actually want a value from you:

• -htmltitle title — you're handing her a title 🎀
• -htmloutdir dir — you're telling her which dir to put the output in 🌸
• -master master — a master, she wants a master 👑

and then the positional girlies:

• <fin> — the input file, required, no skips allowed
• [<fout>] — the output file, optional, brackets say so fr fr

✨ DESCRIPTION ✨

Texjava (also known as Tcode) is a precondition for libssj-java (SSJ) that creates a Java file from an associated LaTeX file. 💖

here's the tea: all SSJ code is written in LaTeX format, with special commands sprinkled in that let Tcode extract the Java code straight out of the LaTeX file. no cap. the LaTeX file is the source of truth and she's just reaching in and pulling the Java out of it. 🧚

after that, Javadoc and LaTeX2HTML come through and create the HTML documentation. 🌈

and the payoff? this guarantees that the source code and its documentation will never diverge. 🎀 like, ever. they're literally the same file. the way that your code and your docs can never drift apart because they were never two separate things in the first place… that's main character energy, that's the whole point, periodt. 💅

ngl this is the most romantic thing a build tool has ever done. source and docs, together, forever, no divergence. 😭💖

✨ SEE ALSO ✨

• /usr/share/doc/tcode/tcode.pdf.gz 📄 — go read the PDF bestie, it's giving lore 🦋

and that's the page!! 🎉 this was texjava 20080917, dated April 7, 2014 — so yes she's a lil vintage but she ATE and she's still serving. 👑💜 ily, go write your LaTeX, your docs will thank you. ✨🌸