LuaMetaTeX(1)

💖 LuaMetaTeX(1) — User Commands, bestie edition 💖

okay so listen. this is the manual page for luametatex, the next generation ConTeXt procession engine, and she's from the User Commands section of your local man pages. sit down, grab a snack, we're doing this 🍓

---

✨ NAME ✨

luametatex — next generation ConTeXt procession engine. that's it, that's the girl 👑

---

🌸 SYNOPSIS 🌸

luametatex --lua=FILE [OPTION]... [TEXNAME[.tex]] [COMMANDS]
luametatex --lua=FILE [OPTION]... RST-LINE
luametatex --lua=FILE [OPTION]... &FMT ARGS

---

🦋 DESCRIPTION 🦋

So you run LuaMetaTeX on TEXNAME, and she usually creates TEXNAME.pdf for you. iconic. any leftover COMMANDS? those get processed as luatex input, after TEXNAME has been read. order matters bestie, don't come for me 💅

alternatively — and this is the plot twist — if the first non-option argument starts with a backslash \, then LuaMetaTeX reads all the non-option arguments as one single input line. it's giving "we're doing this differently today" ✨

or, another option: if the first non-option argument starts with a &, then the next word gets taken as the FMT to read, and that overrides everything else. no cap. any arguments left after that get processed like we said above.

and if you give her literally no arguments and no options? she just prompts you for input. she's patient like that 🫶

the following regular options are understood:

• --credits — display credits and exit. a little bow at the end 🎀
• --fmt=FORMAT — load the format file FORMAT
• --help — display help and exit
• --ini — be iniluametatex, for dumping formats
• --jobname=STRING — set the job name to STRING
• --lua=FILE — load and execute a lua initialization script
• --version — display version and exit

Alternate behaviour models can be obtained by special switches:

• --luaonly — run a lua file, then exit. main character energy, no notes

loading libraries from Lua is blocked unless you explicitly permit it, so:

• --permitloadlib — permit loading of external libraries (coming)

heads up bestie: that's marked (coming) in the original, so don't @ me if it's not fully here yet 🙈

see the reference manual for more information about the startup process — she has lore 🧚

---

😭 REPORTING BUGS 😭

found a bug? email bug reports to dev-context@ntg.nl. be nice, be specific, include the details 💜

execute luametatex --credits for credits and version details.

⚠️ There is NO warranty. Redistribution of this software is covered by the terms of the GNU General Public License, version 2 or (at your option) any later version. For more information about these matters, see the file named COPYING and the LuaMetaTeX source.

• Functionality : level 20230310
• Support : context@ntg.nl
• Copyright : The Lua(Meta)TeX Team(s) (2005-2023+)

The LuaMetaTeX project is related to ConTeXt development. This macro package tightly integrates TeX and MetaPost in close cooperation with Lua. Updates will happen in sync with ConTeXt and when needed. Don't be fooled by unchanged dates: long term stability is the objective. 🫡

---

and that's the whole page, bestie!! this edition of the LuaMetaTeX man page is the LuaMetaTeX one, dated April 2023 — go forth and process your documents, you absolute icon 👑💖✨