runtexfile(1)

📦 version 76526, in arch rolling, fedora 44, ubuntu resolute, ubuntu stonking

✨ runtexfile — the manual page bestie 💖

okay so you found runtexfile(1) in the runtexfile man page and you're like "what is this diva doing" — don't worry, I got you. grab a boba, sit down, we're doing this together 🫶

🌸 NAME 🌸

runtexfile — running a LaTeX document and get the command sequence from the document itself. no cap, the doc tells the script what to do. it's giving self-sufficient queen 👑

🎀 SYNOPSIS 🎀

runtexfile [options] <filename>

🦋 DESCRIPTION 🦋

so here's the vibe: this command parses comment lines in a latex document which start with %! HV and executes the following commands. literally the document is the boss and runtexfile just does what it says.

for example:

%! HV lualatex --shell-escape

In this case the <filename> given by the script will be used. like, it's not gonna invent a filename out of nowhere, bestie, it uses yours 💅

✨ OPTIONS ✨

  • -h, --help — obvious ... :-) (it tells you how to use it, that's the whole thing)
  • -V, --version — obvious ... :-) (it tells you which version you got)
  • -v, --verbose — Give more informations into a log file. more tea in the log, basically 🍓
  • <filename> — Must be the name of the main LaTeX document without the extension if it is .tex. so like, drop the .tex, okay? the extension is not invited to this party 🙈

💜 EXAMPLES 💜

$ runtexfile test2

runs the testfile test2.tex — iconic, effortless, no notes.

and here's a whole real run, look at her go 🔥:

voss>examples:$ runtexfile test2
runtexfile version 0.02
Main file: test2
Filename = test2
running: lualatex --interaction=nonstopmode --shell-escape test2
Filename = test2
running: biber  test2
Filename = test2
running: lualatex --interaction=nonstopmode --shell-escape test2
Filename = test2
running: xindex  test2
Special filename = test2.vwx
running: xindex  --config DIN2 -l DE -o test2.vwd test2.vwx
Special filename = test2.dbx
running: xindex  --config DIN2 -l DE -o test2.dbd test2.dbx
Filename = test2
running: lualatex --interaction=nonstopmode --shell-escape test2
Filename = test2
running: lualatex --interaction=nonstopmode --shell-escape test2

look at that pipeline. lualatex, biber, lualatex, xindex, xindex, lualatex, lualatex. she ATE. 💅✨

🌈 See also 🌈

See runtexfile-doc.pdf for more details — if you want the full lore, the pdf is the extended cut, iykyk 📖

💀 BUGS 💀

No known bugs. periodt. flawless behavior, we love to see it 👑

🌸 AUTHOR 🌸

Herbert Voß (hvoss@tug.org) — the main character who wrote this 🫶

🎀 LICENSE 🎀

Permission is granted to copy, distribute and/or modify this software under the terms of the LaTeX Project Public License, version 1.3.

ngl that's the whole page bestie, go run your .tex file and let the document tell you what to do for once 💖

okay bye ilysm, this was runtexfile version 0.06, dated 8 oct 2025, straight from the runtexfile man page — mwah, see you in the next man page 🌈⭐🧚

📦 where this page comes from