summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/man
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2020-07-24 21:59:43 +0000
committerKarl Berry <karl@freefriends.org>2020-07-24 21:59:43 +0000
commit964620929cf5bde4bdc779ce1ec5aeb618895552 (patch)
treefa6f73a89310e0b71aab528f7910cbf24e70e576 /Master/texmf-dist/doc/man
parent2d7d576af0d3493a4806b6ec730d43824550e4ab (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.148
-rw-r--r--Master/texmf-dist/doc/man/man1/spix.man1.pdfbin0 -> 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
new file mode 100644
index 00000000000..9dd5f8e9ff1
--- /dev/null
+++ b/Master/texmf-dist/doc/man/man1/spix.man1.pdf
Binary files differ