diff options
Diffstat (limited to 'Master/texmf/doc/man/man1/luatex.1')
-rw-r--r-- | Master/texmf/doc/man/man1/luatex.1 | 251 |
1 files changed, 0 insertions, 251 deletions
diff --git a/Master/texmf/doc/man/man1/luatex.1 b/Master/texmf/doc/man/man1/luatex.1 deleted file mode 100644 index 696e26d52f8..00000000000 --- a/Master/texmf/doc/man/man1/luatex.1 +++ /dev/null @@ -1,251 +0,0 @@ -.TH LUATEX 1 "12 April 2011" "luatex 0.70" "Web2C 2012" -.\"===================================================================== -.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 -.RB [ \-\-lua=\fIFILE\fP ] -.RI [ OPTION ].\|.\|. -.RI [ TEXNAME [ \fB.tex\fP ]] -.RI [ COMMANDS ] -.br -.B luatex -.RB [ \-\-lua=\fIFILE\fP ] -.RI [ OPTION ].\|.\|. -.BI \e FIRST\-LINE -.br -.B luatex -.RB [ \-\-lua=\fIFILE\fP ] -.RI [ OPTION ].\|.\|. -.BI & FMT -.RI [ ARGS ] -.\"===================================================================== -.SH DESCRIPTION -Run the lua\*(TX typesetter on -.IR TEXNAME , -usually creating -.IR TEXNAME\fB.pdf\fP . -Any remaining -.I COMMANDS -are processed as lua\*(TX input, after -.I TEXNAME -is read. - -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 \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 \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). - -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" -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 -The lua initialization file. -.PP -The following two options alter the executable behaviour: -.TP -.B \-\-luaonly -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 -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 -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 -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 -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 -Disable printing error messages in the \fIfile:line:error\fR style. -.TP -.BI "\-\-fmt=" FORMAT -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 -Print help message and exit. -.TP -.B \-\-ini -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 -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 -Use \fINAME\fR for the job name, instead of deriving it from the name -of the input file. -.TP -.BI "\-\-kpathsea-debug=" BITMASK -Sets path searching debugging flags according to the \fIBITMASK\fR. -See the \fIKpathsea\fR manual for details. -.TP -.BI "\-\-mktex=" FMT -Enable mktex\fIFMT\fR generation, where \fIFMT\fR must be either \fItex\fR -or \fItfm\fR. -.TP -.B \-\-nosocket -Disable the luasocket (network) library. -.TP -.TP -.BI "\-\-output\-comment=" STRING -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 -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 -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 -Pretend to be program \fINAME\fR (only for kpathsea). -.TP -.B \-\-recorder -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 -Disable some Lua commands that can easily be abused by a malicious -document. -.TP -.BI "\-\-synctex=" NUMBER -Enable/disable Sync\*(TX extension. -.TP -.B \-\-version -Print version information and exit. -.TP -.B \-\-credits -Print credits and version details. -.TP -The following options are ignored: -.TP -.BR \-\-8bit ,\ \-\-etex ,\ \-\-parse\-first\-line ,\ \-\-no\-parse\-first\-line -These are always on. -.TP -.BR \-\-default\-translate\-file=\fITCXNAME\fP ,\ \-\-translate\-file=\fITCXNAME\fP -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 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. |