SPIX(1)                     General Commands Manual                    SPIX(1)

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

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

DESCRIPTION
       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).

OPTIONS
       -n, --dry-run
              Print the commands that would be executed, but do not execute
              them.

       -h, --help
              Print help, and exit.

       --version
              Print version, and exit.

EXAMPLES
       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).

                                                                       SPIX(1)