summaryrefslogtreecommitdiff
path: root/Master/texmf/doc
diff options
context:
space:
mode:
authorNorbert Preining <preining@logic.at>2009-07-09 13:41:44 +0000
committerNorbert Preining <preining@logic.at>2009-07-09 13:41:44 +0000
commit7f7122590e18e97d139a17f81ddde179348aa284 (patch)
tree0840b85ffd65188960737ebf883b97fc76281283 /Master/texmf/doc
parente0644d56399498ee7154a4b21015d152c1e2414c (diff)
update luatex.1 from the added luatex.man in the source directory
git-svn-id: svn://tug.org/texlive/trunk@14203 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf/doc')
-rw-r--r--Master/texmf/doc/man/man1/luatex.1282
1 files changed, 249 insertions, 33 deletions
diff --git a/Master/texmf/doc/man/man1/luatex.1 b/Master/texmf/doc/man/man1/luatex.1
index a7fb23a14ec..553cbc518c1 100644
--- a/Master/texmf/doc/man/man1/luatex.1
+++ b/Master/texmf/doc/man/man1/luatex.1
@@ -1,50 +1,266 @@
-.TH "LUATEX" "1" "2007.03.22" "Norbert Preining" "TeX"
-.SH "NAME"
-luatex, texlua, texluac \- An extended version of pdfTeX using Lua as an embedded scripting language
-.SH "SYNOPSIS"
-luatex \-\-lua=FILE [OPTION]... [TEXNAME[.tex]] [COMMANDS]
+.TH LUATEX 1 "2009.04.22" "luatex 0.40" "Web2C @VERSION@"
+.\"=====================================================================
+.if n .ds MF Metafont
+.if t .ds MF M\s-2ETAFONT\s0
+.if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP
+.if n .ds TX TeX
+.if n .ds WB Web
+.if t .ds WB W\s-2EB\s0
+.\"=====================================================================
+.SH NAME
+luatex, texlua, texluac \- An extended version of pdfTeX using Lua as
+an embedded scripting language
+.\"=====================================================================
+.SH SYNOPSIS
+.B luatex
+[\-\-lua=\fIFILE\fR] [\fIOPTION\fR]... [\fITEXNAME\fR[.tex]] [\fICOMMANDS\fR]
-luatex \-\-lua=FILE [OPTION]... FIRST\-LINE
+.B luatex
+[\-\-lua=\fIFILE\fR] [\fIOPTION\fR]... \fI\eFIRST\-LINE\fR
-luatex \-\-lua=FILE [OPTION]... &FMT ARGS
-.SH "DESCRIPTION"
-Run luaTeX on TEXNAME, usually creating TEXNAME.pdf. Any remaining COMMANDS are processed as luaTeX input, after TEXNAME is read.
+.B luatex
+[\-\-lua=\fIFILE\fR] [\fIOPTION\fR]... \fB&\fIFMT ARGS\fR
+.\"=====================================================================
+.SH DESCRIPTION
+Run the lua\*(TX typesetter on \fITEXNAME\fR, usually creating
+TEXNAME.pdf. Any
+remaining \fICOMMANDS\fR are processed as lua\*(TX input, after TEXNAME
+is read.
-Alternatively, if the first non\-option argument begins with a backslash, interpret all non\-option arguments as a line of luaTeX input.
+Alternatively, if the first non\-option argument begins with a backslash,
+interpret all non\-option arguments as a line of lua\*(TX input.
-Alternatively, if the first non\-option argument begins with a &, the next word is taken as the FMT to read, overriding all else. Any remaining arguments are processed as above.
+Alternatively, if the first non\-option argument begins with a \fB&\fR,
+the
+next word is taken as the \fIFMT\fR to read, overriding all else. Any
+remaining arguments are processed as above.
If no arguments or options are specified, prompt for input.
-If called as texlua it acts as lua interpreter.
+If called as \fBtexlua\fR it acts as lua interpreter.
+If called as \fBtexluac\fR it acts as lua bytecode compiler.
+
+Lua\*(TX is an extended version of pdf\*(TX with Unicode and OpenType
+font support, embeded \fBLua\fR scripting language, the \fBe-\*(TX\fR
+and \fBOmega\fR extensions, as well as integrated MetaPost engine, that
+can create \fIPDF\fR files as well as \fIDVI\fR files.
+For more information about luatex, see http://www.luatex.org, you can
+read Lua\*(TX manual using texdoc utility (\fBtexdoc luatex\fR).
-If called as texluac it acts as lua bytecode compiler.
+All Lua\*(TX text input and output is considered to be Unicode text.
+In \fIDVI\fR mode, lua\*(TX can be used as a complete replacement for
+the \*(TX engine.
+
+In \fIPDF\fR mode, lua\*(TX can natively handle the \fIPDF\fR, \fIJPG\fR,
+\fIJBIG2\fR, and \fIPNG\fR graphics formats. lua\*(TX cannot include
+PostScript or Encapsulated PostScript (EPS) graphics files; first convert
+them to PDF using \fBepstopdf\fR (1).
+
+.\"=====================================================================
.SH "OPTIONS"
-This version of luatex understands the following command line options.
-.TP
-\fB\-\-lua=FILE\fR the lua initialization file
-.TP
-\fB\-\-luaonly\fR run a lua file, then exit
-.TP
-\fB\-\-safer\fR disable some easily exploitable lua commands
-.TP
-\fB\-\-fmt=FORMAT\fR load the format file FORMAT
-.TP
-\fB\-\-ini\fR be initex, for dumping formats
-.TP
-\fB\-\-help\fR display this help and exit
-.TP
-\fB\-\-version\fR output version information and exit
+When the Lua\*(TX executable starts, it looks for the \fB\-\-lua\fR
+commandline option.
+If there is no \fB\-\-lua\fR option, the commandline is interpreted in a
+similar fashion as in traditional pdf\*(TX and Aleph. But if the option
+is present, Lua\*(TX will enter an alternative mode of commandline parsing
+in comparison to the standard web2c programs. The presence of \fB--lua\fR
+makes most of other options unreliable, because the lua initialization
+file can disable kpathsea and/or hook functions into various callbacks.
+.ig
+Here is the list of possibly affected switches/functionality, and why:
+..
+.TP
+.BI "\-\-lua=" FILE
+.rb
+The lua initialization file.
+.PP
+The following two options alter the executable behaviour:
+.TP
+.B \-\-luaonly
+.rb
+Start Lua\*(TX as a Lua interpreter. In this mode, it will set Lua's
+\fIarg[0]\fR to the found script name, pushing preceding options in
+negative values and the rest of the commandline in the positive values,
+just like the Lua interpreter. Lua\*(TX will exit immediately after
+executing the specified Lua script.
+.TP
+.BI \-\-luaconly
+.rb
+Start Lua\*(TX as a Lua byte compiler. In this mode, Lua\*(TX is exactly
+like \fBluac\fR from the standalone Lua distribution, except that it
+does not have the \fB\-l\fR switch, and that it accepts (but ignores)
+the \fB\-\-luaconly\fR switch.
+.PP
+Then the regular web2c options:
+.TP
+.B \-\-debug\-format
+.br
+Debug format loading.
+.TP
+.B \-\-draftmode
+.rb
+Sets \epdfdraftmode so lua\*(TX doesn't write a PDF and doesn't read
+any included images, thus speeding up execution.
+.TP
+.B \-\-enable\-write18
+.br
+Synonym for \fB\-\-shell\-escape\fR.
+.TP
+.B \-\-disable\-write18
+.br
+Synonym for \fB\-\-no\-shell\-escape\fR.
+.TP
+.B \-\-shell\-escape
+.br
+Enable the
+.BI \ewrite18{ command }
+construct, and Lua functions \fBos.execute()\fR, \fBos.exec()\fR,
+\fBos.spawn()\fR, and \fBio.popen()\fR. The \fIcommand\fR can be any
+shell command. This construct is normally disallowed for security
+reasons.
+.TP
+.B \-\-no\-shell-escape
+.br
+Disable the
+.BI \ewrite18{ command }
+construct and the other Lua functions, even if it is enabled in the
+\fItexmf.cnf\fR file.
+.TP
+.B \-\-shell-restricted
+.rb
+Enable restricted version of \fB\ewrite18\fR, \fBos.execute()\fR,
+\fBos.exec()\fR, \fBos.spawn()\fR, and \fBio.popen()\fR, only commands
+listed in \fItexmf.cnf\fR file are allowed.
+.TP
+.B \-\-file\-line\-error
+.rb
+Print error messages in the form \fIfile:line:error\fR which is similar
+to the way many compilers format them.
+.TP
+.B \-\-no\-file\-line\-error
+.rb
+Disable printing error messages in the \fIfile:line:error\fR style.
+.TP
+.BI "\-\-fmt=" FORMAT
+.rb
+Use \fIFORMAT\fR as the name of the format to be used, instead of the
+name by which lua\*(TX was called or a \fI%&\fR line.
+.TP
+.B \-\-help
+.rb
+Print help message and exit.
+.TP
+.B \-\-ini
+.rb
+Start in \fIINI\fR mode, which is used to dump formats. The \fIINI\fR
+mode can be used for typesetting, but no format is preloaded, and basic
+initializations like setting catcodes may be required.
+.TP
+.BI "\-\-interaction=" MODE
+.rb
+Sets the interaction mode. The \fIMODE\fR can be either
+.IR batchmode ,
+.IR nonstopmode ,
+.IR scrollmode ,
+and
+.IR errorstopmode .
+The meaning of these modes is the same as that of the corresponding
+\ecommands.
+.TP
+.BI "\-\-jobname=" NAME
+.rb
+Use \fINAME\fR for the job name, instead of deriving it from the name
+of the input file.
+.TP
+.BI "\-\-kpathsea-debug=" BITMASK
+.rb
+Sets path searching debugging flags according to the \fIBITMASK\fR.
+See the \fIKpathsea\fR manual for details.
+.TP
+.BI "\-\-mktex=" FMT
+.rb
+Enable mktex\fIFMT\fR generation, where \fIFMT\fR must be either \fItex\fR
+or \fItfm\fR.
+.TP
+.B \-\-nosocket
+.rb
+Disable the luasocket (network) library.
+.TP
+.TP
+.BI "\-\-output\-comment=" STRING
+.rb
+In \fIDVI\fR mode, use \fISTRING\fR for the \fIDVI\fR file comment
+instead of the date. This option is ignored in\fIPDF\fR mode.
+.TP
+.BI "\-\-output\-directory=" DIRECTORY
+.rb
+Write output files in \fIDIRECTORY\fR instead of the current directory.
+Look up input files in \fIDIRECTORY\fR first, then along the normal
+search path.
+.TP
+.BI "\-\-output\-format=" FORMAT
+.rb
+Set the output format mode, where \fIFORMAT\fR must be either \fIpdf\fR
+or \fIdvi\fR.
+This also influences the set of graphics formats understood by lua\*(TX.
+.TP
+.BI "\-\-progname=" NAME
+.rb
+Pretend to be program \fINAME\fR (only for kpathsea).
+.TP
+.B \-\-recorder
+.rb
+Enable the filename recorder.
+This leaves a trace of the files opened for input and output
+in a file with extension \fI.fls\fR.
+.TP
+.B \-\-safer
+.rb
+Disable some Lua commands that can easily be abused by a malicious
+document.
+.TP
+.BI "\-\-synctex=" NUMBER
+.rb
+Enable/disable Sync\*(TX extension.
+.TP
+.B \-\-version
+.rb
+Print version information and exit.
+.TP
+.B \-\-credits
+.rb
+Print credits and version details.
+.TP
+The following options are ignored:
+.TP
+.BR "\-\-8bit" ,\ "\-\-etex" ,\ "\-\-parse\-first\-line" ,\
+"\-\-no\-parse\-first\-line"
+.rb
+These are always on.
+.TP
+.BI "\-\-default\-translate\-file=" TCXNAME , \ "\-\-translate\-file="
+TCXNAME
+.rb
+These are always off.
+
+.\"=====================================================================
.SH "SEE ALSO"
.BR pdftex (1),
.BR etex (1),
.BR aleph (1),
+.BR omega (1),
.BR lua (1).
.\"=====================================================================
.SH "AUTHORS"
-The primary authors of luatex are Hartmut Henkel, Taco
-Hoekwater, and Hans Hagen, with help from Martin Schr\[:o]der,
-Karel Skoupy, and Han The Thanh.
-This man page was written by Norbert Preining for the
-Debian Operating System.
+The primary authors of Lua\*(TX are Hartmut Henkel, Taco Hoekwater,
+and Hans Hagen, with help from Martin Schr\[:o]der, Karel Skoupy, and
+Han The Thanh.
+.PP
+\*(TX was designed by Donald E. Knuth, who implemented it using his
+\*(WB system for Pascal programs.
+It was ported to Unix at Stanford by Howard Trickey, and at Cornell by
+Pavel Curtis.
+The version now offered with the Unix \*(TX distribution is that generated
+by the \*(WB to C system (\fBweb2c\fR), originally written by Tomas
+Rokicki and Tim Morgan.