diff options
author | Karl Berry <karl@freefriends.org> | 2020-07-24 21:59:43 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2020-07-24 21:59:43 +0000 |
commit | 964620929cf5bde4bdc779ce1ec5aeb618895552 (patch) | |
tree | fa6f73a89310e0b71aab528f7910cbf24e70e576 /Master/texmf-dist/doc/man | |
parent | 2d7d576af0d3493a4806b6ec730d43824550e4ab (diff) |
spix (24jul20)
git-svn-id: svn://tug.org/texlive/trunk@55933 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/man')
-rw-r--r-- | Master/texmf-dist/doc/man/man1/spix.1 | 48 | ||||
-rw-r--r-- | Master/texmf-dist/doc/man/man1/spix.man1.pdf | bin | 0 -> 18170 bytes |
2 files changed, 48 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/man/man1/spix.1 b/Master/texmf-dist/doc/man/man1/spix.1 new file mode 100644 index 00000000000..e2ade137ec4 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/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). diff --git a/Master/texmf-dist/doc/man/man1/spix.man1.pdf b/Master/texmf-dist/doc/man/man1/spix.man1.pdf Binary files differnew file mode 100644 index 00000000000..9dd5f8e9ff1 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/spix.man1.pdf |