DOKK / manpages / debian 12 / texlive-extra-utils / spix.1.en
SPIX(1) General Commands Manual SPIX(1)

spix - Compile a .tex file, executing commands that are set inside the file itself.

spix [--version] [-h] [-n] file

spix parses a .tex file to find lines starting with %$ (before the preambule). Those lines are shell commands that are executed by spix.

Commands are executed as-is, excepted that:

- command are run from the directory of the file given in argument;

- shell variables $texname and $basename are set to the name of the tex file (respectively with and without the .tex extension).

Print the commands that would be executed, but do not execute them.
Print help, and exit.
Print version, and exit.

Let foo.tex be the following file.

% Compile this file twice with lualatex.
%$ lualatex foo.tex
%$ lualatex foo.tex
\documentclass{article}
\begin{document}
Hello, world!
\end{document}


When running spix on this file, it is compiled twice using
    lualatex(1) (as written in lines 2 and 3 of the file).