From a731c2c045c14b88099c4576c874b8df2990f2ea Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Sat, 25 Jul 2020 03:02:45 +0000 Subject: CTAN sync 202007250302 --- support/spix/spix.1 | 48 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 support/spix/spix.1 (limited to 'support/spix/spix.1') diff --git a/support/spix/spix.1 b/support/spix/spix.1 new file mode 100644 index 0000000000..e2ade137ec --- /dev/null +++ b/support/spix/spix.1 @@ -0,0 +1,48 @@ +.TH SPIX 1 +.SH NAME +spix \- Compile a .tex file, executing commands that are set inside the file itself. +.SH SYNOPSIS +.B spix +[\fB\--version\fR] +[\fB\-h\fR] +[\fB\-n\fR] +.IR file +.SH DESCRIPTION +.B spix +parses a .tex file to find lines starting with \fI%$\fR (before the preambule). +Those lines are shell commands that are executed by \fBspix\fR. +.PP +Commands are executed as-is, excepted that: +.RS +.PP +- command are run from the directory of the file given in argument; +.PP +- shell variables \fI$texname\fR and \fI$basename\fR are set to the name of the tex file (respectively with and without the .tex extension). +.RE +.SH OPTIONS +.TP +.BR \-n ", " \-\-dry\-run +Print the commands that would be executed, but do not execute them. +.TP +.BR \-h ", " \-\-help +Print help, and exit. +.TP +.BR \-\-version +Print version, and exit. +.SH EXAMPLES +Let \fIfoo.tex\fR be the following file. +.PP +.nf +.RS +% Compile this file twice with lualatex. +%$ lualatex foo.tex +%$ lualatex foo.tex + +\\documentclass{article} +\\begin{document} +Hello, world! +\\end{document} +.RE +.fi +.PP +When running \fBspix\fR on this file, it is compiled twice using \fBlualatex(1)\fR (as written in lines 2 and 3 of the file). -- cgit v1.2.3