perltex --version (return code: 0)
pdfTeX 3.14159265-2.6-1.40.16 (TeX Live 2015/Debian)
kpathsea version 6.2.1
Copyright 2015 Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
There is NO warranty. Redistribution of this software is
covered by the terms of both the pdfTeX copyright and
the Lesser GNU General Public License.
For more information about these matters, see the file
named COPYING and the pdfTeX source.
Primary author of pdfTeX: Peter Breitenlohner (eTeX)/Han The Thanh (pdfTeX).
Compiled with libpng 1.6.17; using libpng 1.6.17
Compiled with zlib 1.2.8; using zlib 1.2.8
Compiled with poppler version 0.41.0
perltex --help (return code: 0)
Usage:
perltex [--help] [--latex=*program*] [--[no]safe] [--permit=*feature*]
[--makesty] [*latex options*]
Options:
perltex accepts the following command-line options:
--help
Display basic usage information.
--latex=*program*
Specify a program to use instead of latex. For example,
"--latex=pdflatex" would typeset the given document using pdflatex
instead of ordinary latex.
--[no]safe
Enable or disable sandboxing. With the default of --safe, perltex
executes the code from a "\perlnewcommand" or "\perlrenewcommand"
macro within a protected environment that prohibits ``unsafe''
operations such as accessing files or executing external programs.
Specifying --nosafe gives the LaTeX document *carte blanche* to
execute any arbitrary Perl code, including that which can harm the
user's files. See Safe for more information.
--permit=*feature*
Permit particular Perl operations to be performed. The --permit
option, which can be specified more than once on the command line,
enables finer-grained control over the perltex sandbox. See Opcode
for more information.
--makesty
Generate a LaTeX style file called noperltex.sty. Replacing the
document's "\usepackage{perltex}" line with "\usepackage{noperltex}"
produces the same output but does not require PerlTeX, making the
document suitable for distribution to people who do not have PerlTeX
installed. The disadvantage is that noperltex.sty is specific to the
document that produced it. Any changes to the document's PerlTeX
macro definitions or macro invocations necessitates rerunning
perltex with the --makesty option.
These options are then followed by whatever options are normally passed
to latex (or whatever program was specified with "--latex"), including,
for instance, the name of the .tex file to compile.