[latexrefman-commits] [SCM] latexrefman updated: r666 - trunk
jimhefferon at gnu.org.ua
jimhefferon at gnu.org.ua
Thu Jun 28 20:51:27 CEST 2018
Author: jimhefferon
Date: 2018-06-28 21:51:27 +0300 (Thu, 28 Jun 2018)
New Revision: 666
Modified:
trunk/ChangeLog
trunk/latex2e.html
trunk/latex2e.info
trunk/latex2e.pdf
trunk/latex2e.texi
Log:
Improve Command line, add examples for commands on command line and errors
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2018-06-28 15:31:06 UTC (rev 665)
+++ trunk/ChangeLog 2018-06-28 18:51:27 UTC (rev 666)
@@ -1,3 +1,10 @@
+2018-06-28 Jim Hefferon <jhefferon at smcvt.edu>
+
+ * latex2e.texi (Command line) Fix synopsis calling syntax. Added
+ examples of putting commands on the command line,
+ and of recovering from errors. This finishes latex-info; I have
+ removed it from the todo's.
+
2018-06-27 Jim Hefferon <jhefferon at smcvt.edu>
* latex2e.texi (Terminal input/output) Added synopsis, examples.
Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html 2018-06-28 15:31:06 UTC (rev 665)
+++ trunk/latex2e.html 2018-06-28 18:51:27 UTC (rev 666)
@@ -871,7 +871,7 @@
<p>LaTeX is defined to be a set of commands that are run by a TeX
implementation (see <a href="#Overview">Overview</a>). This section gives a terse
-overview of the main programs.
+overview of the main programs (see also <a href="#Command-line">Command line</a>).
</p>
<dl compact="compact">
<dt><code>latex</code></dt>
@@ -18685,7 +18685,12 @@
</dt>
<dd><a name="index-euro-symbol"></a>
<a name="index-currency_002c-euro"></a>
-<p>€ Euro symbol.
+<a name="index-package_002c-eurosym"></a>
+<a name="index-eurosym-package"></a>
+
+<p>The Euro symbol: €. For an alternative glyph design, try the
+<samp>eurosym</samp> package; also, most fonts nowadays come with their own
+Euro symbol (Unicode U+20AC).
</p>
</dd>
<dt><code>\textexclamdown <span class="roman">(or <code>!`</code>)</span></code>
@@ -19636,7 +19641,7 @@
above.
</p>
<p>To make the table of contents LaTeX stores the information in an
-auxillary file named <samp><var>root-file</var>.toc</samp> (see <a href="#Splitting-the-input">Splitting the input</a>). For example, this LaTeX file <samp>test.tex</samp>
+auxiliary file named <samp><var>root-file</var>.toc</samp> (see <a href="#Splitting-the-input">Splitting the input</a>). For example, this LaTeX file <samp>test.tex</samp>
</p>
<div class="example">
<pre class="example">\documentclass{article}
@@ -19702,7 +19707,7 @@
</td></tr>
<tr><td align="left" valign="top">• <a href="#g_t_005caddtocontents" accesskey="2">\addtocontents</a>:</td><td> </td><td align="left" valign="top">Add text directly to table of contents file, etc.
</td></tr>
-<tr><td align="left" valign="top">• <a href="#g_t_005cnofiles" accesskey="3">\nofiles</a>:</td><td> </td><td align="left" valign="top">Prevent writing to auxillary files
+<tr><td align="left" valign="top">• <a href="#g_t_005cnofiles" accesskey="3">\nofiles</a>:</td><td> </td><td align="left" valign="top">Prevent writing to auxiliary files.
</td></tr>
</table>
@@ -19735,7 +19740,7 @@
<pre class="example">\addcontentsline{toc}{section}{\protect\textbf{Appendices}}
</pre></div>
-<p>It wll appear at the same indentation level as the sections, will be in
+<p>It will appear at the same indentation level as the sections, will be in
boldface, and will be assigned the page number associated with the point
where it appears in the input file.
</p>
@@ -19887,7 +19892,7 @@
<pre class="example">\nofiles
</pre></div>
-<p>Prevent LaTeX from writing any auxillary files. The only output will
+<p>Prevent LaTeX from writing any auxiliary files. The only output will
be the <samp>.log</samp> and <samp>.pdf</samp> (or <samp>.dvi</samp>) files. This command
must go in the preamble.
</p>
@@ -19903,7 +19908,7 @@
...
</pre></div>
-<p>LaTeX will not erase any existing auxillary files, so if you insert
+<p>LaTeX will not erase any existing auxiliary files, so if you insert
the <code>\nofiles</code> command after you have run the file and gotten
a <samp>.toc</samp> then the table of contents page will continue to show
the old information.
@@ -21238,65 +21243,53 @@
<a name="index-command-line"></a>
-<p>Synopsis, one of:
+<p>Synopsis (from a terminal command line):
</p>
<div class="example">
-<pre class="example">pdflatex
-pdflatex <var>option</var> ... <var>latex-filename</var> <var>commands</var>
-pdflatex <var>option</var> ... <var>latex-filename</var>.tex <var>commands</var>
-pdflatex <var>option</var> ... <var>first-line-with-backslash</var>
+<pre class="example">pdflatex <var>options</var> <var>argument</var>
</pre></div>
-<p>or, less often, one of:
+<p>Run LaTeX on <var>argument</var>. In place of <code>pdflatex</code> you can
+also use <code>xelatex</code>, or <code>lualatex</code>, or <code>dviluatex</code>, or
+<code>latex</code>.
</p>
-<div class="example">
-<pre class="example">latex
-latex <var>option</var> ... <var>latex-filename</var> <var>commands</var>
-latex <var>option</var> ... <var>latex-filename</var>.tex <var>commands</var>
-latex <var>option</var> ... <var>first-line-with-backslash</var>
-</pre></div>
-
-<p>Run LaTeX on the input file <samp><var>latex-filename</var>.tex</samp>.
+<p>For example, this will run LaTeX on the file <samp>thesis.tex</samp>,
+creating the output <samp>thesis.pdf</samp>.
</p>
-<p>This will run LaTeX on the file <samp>thesis.tex</samp>, creating the
-output <samp>thesis.pdf</samp>.
-</p>
<div class="example">
-<pre class="example"><code>pdflatex</code> thesis
+<pre class="example">pdflatex thesis
</pre></div>
<p><a name="index-_002etex_002c-default-extension"></a>
-As in that example, <samp>.tex</samp> is the default file extension.
+Note that <samp>.tex</samp> is the default file extension.
</p>
-<p>The synopsis shows two commands, <code>pdflatex</code> and <code>latex</code>.
-The original TeX program output a custom format, DVI. pdfTeX is a
-modification of that program. It is completely backward compatible.
-But it can output directly to PDF and so can take advantage of PDF’s
-extra features such as hyperlinks, support for modern image formats such
-as JPG and PNG, and ubiquitous viewing programs. In short, if you run
-<code>pdflatex</code> then you will by default get PDF and have access to
-all its modern features, while if you run <code>latex</code> then you will
-get DVI. The description here assumes pdfLaTeX.
+<p>pdfTeX is a development of the original TeX program, as are
+XeTeX and LuaTeX (see <a href="#TeX-engines">TeX engines</a>). They are completely
+backward compatible. But the original program had a custom output
+format, DVI, while the newer ones can output directly to PDF. This
+allows them to take advantage of the extra features in PDF such as
+hyperlinks, support for modern image formats such as JPG and PNG, and
+ubiquitous viewing programs. In short, if you run <code>pdflatex</code> or
+<code>xelatex</code> or <code>lualatex</code> then you will by default get PDF
+and have access to all its modern features. If you run <code>latex</code>,
+or <code>dvilualatex</code>, then you will get DVI. The description here
+assumes pdfLaTeX.
</p>
-<p>If your command line invocation has no arguments or options at all then
-<code>pdflatex</code> prompts the user for input from the terminal (escape
-from this by entering <code><control>-D</code>).
-</p>
<p>See <a href="#Command-line-options">Command line options</a> for a selection of the most useful command
-line options.
+line options. As to <var>argument</var>, the usual case is that it does not
+begin with a backslash, so the system takes it to be the name of a file
+and it compiles that file. If <var>argument</var> begins with a backslash
+then the system will interpret it as a line of LaTeX input, which can
+be used for special effects (see <a href="#Command-line-input">Command line input</a>).
</p>
-<p>If the first non-option argument begins with a backslash then all such
-arguments are interpreted as a line of LaTeX input (see <a href="#Command-line-input">Command line input</a>). If it does not begin with a backslash then
-<code>pdflatex</code> assumes it is the name of a file, which will be the
-job file. In this case, any remaining <var>commands</var> are processed as
-<code>pdflatex</code> commands.
+<p>If you gave no arguments or options then <code>pdflatex</code> prompts for
+input from the terminal. You can escape from this by entering
+<code><control>-D</code>.
</p>
<p>If LaTeX finds an error in your document then by default it stops and
asks you about it. See <a href="#Recovering-from-errors">Recovering from errors</a> for an outline of what
to do.
</p>
-<p>See <a href="#TeX-engines">TeX engines</a> for other system commands invoking LaTeX.
-</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="#Command-line-options" accesskey="1">Command line options</a>:</td><td> </td><td align="left" valign="top">Read text from the terminal.
</td></tr>
@@ -21316,67 +21309,75 @@
<a name="Command-line-options-1"></a>
<h3 class="section">28.1 Command line options</h3>
-<a name="index-_002d_002dhelp-command_002dline-option"></a>
-<p>With many implementations you can specify command line options
-by prefixing them with ‘<samp>-</samp>’ or ‘<samp>--</samp>’.
-For instance, use ‘<samp>-</samp>’ for TeX Live on GNU/Linux or MacTeX on Apple,
-and use ‘<samp>--</samp>’ for MikTeX on Windows.
-These are the options relevant to ordinary document authoring. For a
+<p>These are the options relevant to ordinary document authoring. For a
full list, try the command line command ‘<samp>latex --help</samp>’.
</p>
+<p>With many implementations you can specify command line options by
+prefixing them with ‘<samp>-</samp>’ or ‘<samp>--</samp>’. This is the case for
+both TeX Live and MacTeX, and MiKTeX.
+</p>
<dl compact="compact">
+<dd><a name="index-_002d_002dversion-command_002dline-option"></a>
+</dd>
<dt><code>version</code>
<a name="index-version"></a>
</dt>
<dd><p>Show the current version, like ‘<samp>pdfTeX 3.14159265-2.6-1.40.16 (TeX
-Live 2015/Debian)</samp>’, along with a small amount of additional information,
+Live 2015/Debian)</samp>’ along with a small amount of additional information,
and exit.
</p>
+<a name="index-_002d_002dhelp-command_002dline-option"></a>
</dd>
<dt><code>help</code>
<a name="index-help"></a>
</dt>
-<dd><p>Give a brief usage message that is useful as a prompt, and exit.
+<dd><p>Give a brief usage message that is useful as a prompt and exit.
</p>
+<a name="index-_002d_002dinteraction-command_002dline-option"></a>
</dd>
<dt><code>interaction=[batchmode|nonstopmode|scrollmode|errorstopmode]</code>
<a name="index-interaction_003d_005bbatchmode_007cnonstopmode_007cscrollmode_007cerrorstopmode_005d"></a>
</dt>
-<dd><p>When TeX is compiling a document it does so in one of four modes. In
-<em>errorstop mode</em> (the default), TeX stops at each error and asks
-for user intervention. In <em>batch mode</em> it prints nothing on the
-terminal, errors are scrolled as if the user hit <code><return></code> at
-every error, and missing files cause the job to abort. In <em>nonstop
-mode</em> diagnostic message appear on the terminal but as in batch mode
-there is no user interaction. In <em>scroll mode</em> TeX only stops
-for missing files or keyboard input.
+<dd><p>TeX compiles a document in one of four modes. In <em>errorstop
+mode</em> (the default), TeX stops at each error and asks for user
+intervention. In <em>batch mode</em> it prints nothing on the terminal,
+errors are scrolled as if the user hit <code><return></code> at every error,
+and missing files cause the job to abort. In <em>nonstop mode</em>
+diagnostic message appear on the terminal but as in batch mode there is
+no user interaction. In <em>scroll mode</em> TeX only stops for missing
+files or keyboard input.
</p>
<p>For instance, starting LaTeX with the command line <code>pdflatex
-interaction=batchmode <var>filename</var></code> eliminates most command line
-output.https://tex.stackexchange.com/a/128190/121234
+output.
</p>
+<a name="index-_002d_002djobname-command_002dline-option"></a>
</dd>
<dt><code>jobname=<var>string</var></code>
<a name="index-jobname_003dstring"></a>
</dt>
-<dd><p>Set the value of TeX’s <code>jobname</code> to the string. The most
-obvious effect of this is that the output file will then be
+<dd><p>Set the value of TeX’s <code>jobname</code> to the string. The log file
+and output file will then be named <samp><var>string</var>.log</samp> and
<samp><var>string</var>.pdf</samp>.
</p>
<p>When you run <code><code>pdflatex</code> <var>options</var> <var>argument</var></code>, if
<var>argument</var> does not start with a backslash then TeX considers it
-the name of a tile inputs that file. Otherwise <code>pdflatex</code> waits
-for the first <code>\input</code> instruction and the name of the input file
-will be the job name, used for name of the log file and the output file.
-This option short-circuits that process and directly specifies the name.
-See <a href="#Command-line-input">Command line input</a> for an example of its use.
+the name of a file to input. Otherwise it waits for the first
+<code>\input</code> instruction and the name of the input file will be the job
+name. This is used to name the log file the output file. This option
+overrides that process and directly specifies the name. See <a href="#Command-line-input">Command line input</a> for an example of its use.
</p>
+<a name="index-_002d_002doutput_002ddirectory-command_002dline-option"></a>
</dd>
<dt><code>output-directory=<var>directory</var></code>
<a name="index-output_002ddirectory_003ddirectory"></a>
</dt>
-<dd><p>Use the existing directory <var>directory</var> to write files in.
+<dd><p>Write files in the directory <var>directory</var>. It must already exist.
</p>
+<a name="index-_002d_002dshell_002descape-command_002dline-option"></a>
+<a name="index-_002d_002dno_002dshell_002descape-command_002dline-option"></a>
+<a name="index-_002d_002denable_002dwrite18-command_002dline-option"></a>
+<a name="index-_002d_002ddisable_002dwrite18-command_002dline-option"></a>
</dd>
<dt><code>shell-escape</code>
<a name="index-shell_002descape"></a>
@@ -21391,8 +21392,8 @@
<a name="index-disable_002dwrite18"></a>
</dt>
<dd><p>Enable or disable <code>\write18{<var>shell command</var>}</code>. The first two
-are available with TeX Live or MacTeX while the second two come
-with MikTeX.
+options are for with TeX Live or MacTeX while the second two are
+for MiKTeX.
</p>
<a name="index-package_002c-sagetex"></a>
<a name="index-sagetex-package"></a>
@@ -21406,19 +21407,22 @@
<p>But with this functionality enabled, security issues could happen if you
compiled a LaTeX file from the Internet. By default <code>\write18</code>
is disabled. (More precisely, by default TeX Live, MacTeX, and
-MikTeX allow the execution of a limited number of TeX-related
+MiKTeX only allow the execution of a limited number of TeX-related
programs, which they distribute.)
</p>
-<p>If you call <code>\write18{ls -l}</code> with the option
-<code>no-shell-escape</code> then you do not get an error, but the log file
-says ‘<samp>runsystem(ls -l)...disabled</samp>’.
+<p>If you invoke LaTeX with the option <code>no-shell-escape</code>, and in
+your document you call <code>\write18{ls -l}</code>, then you do not get an
+error but the log file says ‘<samp>runsystem(ls -l)...disabled</samp>’.
</p>
+<a name="index-_002d_002dhalt_002don_002derror-command_002dline-option"></a>
</dd>
<dt><code>halt-on-error</code>
<a name="index-halt_002don_002derror"></a>
</dt>
<dd><p>Stop processing at the first error.
</p>
+<a name="index-_002d_002dfile_002dline_002derror-command_002dline-option"></a>
+<a name="index-_002d_002dno_002dfile_002dline_002derror-command_002dline-option"></a>
</dd>
<dt><code>file-line-error</code>
<a name="index-file_002dline_002derror"></a>
@@ -21441,16 +21445,59 @@
<a name="Command-line-input-1"></a>
<h3 class="section">28.2 Command line input</h3>
-<p>As part of the command line invocation of LaTeX you can also specify
-arbitrary input by starting with a backslash. For example,
-this loads the package <samp>graphicx</samp> with the option <code>draft</code>.
+<p>As part of the command line invocation <code>pdflatex <var>options</var>
+<var>argument</var></code> you can specify arbitrary input by starting
+<var>argument</var> with a backslash. This allows you to do some special
+effects.
</p>
+<a name="index-package_002c-hyperref-2"></a>
+<a name="index-hyperref-package-2"></a>
+
+<p>For example, this file (which uses the <samp>hyperref</samp> package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+</p>
<div class="example">
+<pre class="example">\ifdefined\paperversion % in preamble
+\newcommand{\urlcolor}{black}
+\else
+\newcommand{\urlcolor}{blue}
+\fi
+\usepackage[colorlinks=true,urlcolor=\urlcolor]{hyperref}
+ ...
+\href{https://www.ctan.org}{CTAN} % in body
+ ...
+</pre></div>
+
+<p>Compiling this document <samp>book.tex</samp> with the command line
+<code>pdflatex test</code> will give the ‘<samp>CTAN</samp>’ link in blue. But
+compiling it with <code>pdflatex "\def\paperversion{}\input test.tex"</code>
+has the link in black. (Note the use of double quotes to prevent
+interpretation of the symbols by the command line shell; your system may
+do this differently.)
+</p>
+<p>In a similar way, from the single file <samp>main.tex</samp> you can compile
+two different versions.
+</p>
+<div class="example">
+<pre class="example">pdflatex -jobname=students "\def\student{}\input{main}"
+pdflatex -jobname=teachers "\def\teachers{}\input{main}"
+</pre></div>
+
+<p>The <code>jobname</code> option is there because otherwise both files would be
+called <samp>main.pdf</samp> and the second would overwrite the first.
+</p>
+<p>A final example. This loads the package <samp>graphicx</samp> with the option
+<code>draft</code>
+</p>
+<div class="example">
<pre class="example">pdflatex -jobname=myfile "\RequirePackage[draft]{graphicx} \input{myfile.tex}"
</pre></div>
-<p>The graphic files are read for their size information, but not incorporated
-into the PDF.
+<p>so the graphic files are read for their size information but not
+incorporated into the PDF. (The <code>jobname</code> option is needed because
+otherwise the output file would be <samp>graphicx.pdf</samp>, as
+<code>\RequirePackage</code> does an <code>\input</code> of its own.)
</p>
<hr>
@@ -21462,14 +21509,50 @@
<a name="Recovering-from-errors-1"></a>
<h3 class="section">28.3 Recovering from errors</h3>
+<p>If LaTeX finds an error in your document then it gives you an error
+message and prompts you with a question mark, <code>?</code>. For instance,
+running LaTeX on this file
+</p>
+<div class="example">
+<pre class="example">\newcommand{\NP}{\ensuremath{\textbf{NP}}}
+The \PN{} problem is a million dollar one.
+</pre></div>
+
+<p>causes it show this, and wait for input.
+</p>
+<div class="example">
+<pre class="example">! Undefined control sequence.
+l.5 The \PN
+ {} problem is a million dollar one.
+?
+</pre></div>
+
+<p>The simplest thing is to enter ‘<samp>x</samp>’ and <code><return></code> and fix the
+typo. You could instead enter ‘<samp>?</samp>’ and <code><return></code> to see other
+options.
+</p>
<a name="index-_002a-prompt"></a>
<a name="index-prompt_002c-_002a"></a>
<a name="index-_005cstop"></a>
-<p>If LaTeX stops in the middle of the document and gives you a
-‘<samp>*</samp>’ prompt, it is waiting for input. You can type <code>\stop</code>
-(and return) and it will prematurely end the document.
+<p>There are two other error scenarios. The first is that you forgot to
+include the <code>\end{document}</code> or misspelled it. In this case
+LaTeX gives you a ‘<samp>*</samp>’ prompt. You can get back to the command
+line by typing <code>\stop</code> and <code><return></code>.
</p>
+<p>The last scenario is that you mistyped the file name. For instance,
+instead of <code>pdflatex test</code> you might type <code>pdflatex tste</code>.
+</p>
+<div class="example">
+<pre class="example">! I can't find file `tste'.
+<*> tste
+
+(Press Enter to retry, or Control-D to exit)
+Please type another input file name:
+</pre></div>
+<p>The simplest thing is to enter <code><Contol></code> and ‘<samp>d</samp>’ (holding
+them down at the same time), and just fix the command line.
+</p>
<hr>
<a name="Document-templates"></a>
@@ -22130,6 +22213,7 @@
<tr><td></td><td valign="top"><a href="#index-eth_002c-Icelandic-letter">eth, Icelandic letter</a>:</td><td> </td><td valign="top"><a href="#Additional-Latin-letters">Additional Latin letters</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-etoolbox-package"><code>etoolbox</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-euro-symbol">euro symbol</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-eurosym-package"><code>eurosym</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-ex">ex</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exclamation-point_002c-upside_002ddown">exclamation point, upside-down</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-exponent">exponent</a>:</td><td> </td><td valign="top"><a href="#Subscripts-_0026-superscripts">Subscripts & superscripts</a></td></tr>
@@ -22226,6 +22310,7 @@
<tr><td></td><td valign="top"><a href="#index-hungarian-umlaut-accent">hungarian umlaut accent</a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperref-package"><code>hyperref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyperref-package-1"><code>hyperref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-hyperref-package-2"><code>hyperref</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#Command-line-input">Command line input</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-defining">hyphenation, defining</a>:</td><td> </td><td valign="top"><a href="#g_t_005chyphenation">\hyphenation</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-discretionary">hyphenation, discretionary</a>:</td><td> </td><td valign="top"><a href="#g_t_005cdiscretionary">\discretionary</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-hyphenation_002c-forcing">hyphenation, forcing</a>:</td><td> </td><td valign="top"><a href="#g_t_005c_002d-_0028hyphenation_0029">\- (hyphenation)</a></td></tr>
@@ -22462,6 +22547,7 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-enumitem"><span class="roman">package</span>, <code>enumitem</code></a>:</td><td> </td><td valign="top"><a href="#list">list</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-envlab"><span class="roman">package</span>, <code>envlab</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmakelabels">\makelabels</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-etoolbox"><span class="roman">package</span>, <code>etoolbox</code></a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-eurosym"><span class="roman">package</span>, <code>eurosym</code></a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-fancyhdr"><span class="roman">package</span>, <code>fancyhdr</code></a>:</td><td> </td><td valign="top"><a href="#Page-styles">Page styles</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-fancyhdr-1"><span class="roman">package</span>, <code>fancyhdr</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagestyle">\pagestyle</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-fancyvrb"><span class="roman">package</span>, <code>fancyvrb</code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
@@ -22472,6 +22558,7 @@
<tr><td></td><td valign="top"><a href="#index-package_002c-geometry-1"><span class="roman">package</span>, <code>geometry</code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cfootnotemark">\footnotemark</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref-1"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagenumbering">\pagenumbering</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-hyperref-2"><span class="roman">package</span>, <code>hyperref</code></a>:</td><td> </td><td valign="top"><a href="#Command-line-input">Command line input</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cpart">\part</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst-1"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cchapter">\chapter</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-package_002c-indentfirst-2"><span class="roman">package</span>, <code>indentfirst</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005csection">\section</a></td></tr>
@@ -22960,7 +23047,18 @@
<tr><td></td><td valign="top"><a href="#index-_0026"><code>&</code></a>:</td><td> </td><td valign="top"><a href="#tabular">tabular</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Command-Index_fn_symbol-2">-</a></th><td></td><td></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002ddisable_002dwrite18-command_002dline-option"><code>--disable-write18 <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002denable_002dwrite18-command_002dline-option"><code>--enable-write18 <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dfile_002dline_002derror-command_002dline-option"><code>--file-line-error <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dhalt_002don_002derror-command_002dline-option"><code>--halt-on-error <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002d_002dhelp-command_002dline-option"><code>--help <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dinteraction-command_002dline-option"><code>--interaction <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002djobname-command_002dline-option"><code>--jobname <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dfile_002dline_002derror-command_002dline-option"><code>--no-file-line-error <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dshell_002descape-command_002dline-option"><code>--no-shell-escape <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002doutput_002ddirectory-command_002dline-option"><code>--output-directory <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dshell_002descape-command_002dline-option"><code>--shell-escape <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-_002d_002dversion-command_002dline-option"><code>--version <span class="roman">command-line option</span></code></a>:</td><td> </td><td valign="top"><a href="#Command-line-options">Command line options</a></td></tr>
<tr><td colspan="4"> <hr></td></tr>
<tr><th><a name="Command-Index_fn_symbol-3">.</a></th><td></td><td></td></tr>
<tr><td></td><td valign="top"><a href="#index-_002eaux-file"><code>.aux <span class="roman">file</span></code></a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info 2018-06-28 15:31:06 UTC (rev 665)
+++ trunk/latex2e.info 2018-06-28 18:51:27 UTC (rev 666)
@@ -156,8 +156,8 @@
* Menu:
-* Starting and ending:: The standard beginning and end of a document.
-* Output files:: Files produced.
+* Starting and ending:: The standard beginning and end of a document.
+* Output files:: Files produced.
* TeX engines:: Programs that can compile TeX and LaTeX.
* LaTeX command syntax:: General syntax of LaTeX commands.
@@ -249,7 +249,7 @@
LaTeX is defined to be a set of commands that are run by a TeX
implementation (*note Overview::). This section gives a terse overview
-of the main programs.
+of the main programs (see also *note Command line::).
'latex'
'pdflatex'
@@ -12597,8 +12597,11 @@
- En-dash (used for ranges, as in 'See pages 12--14').
'\texteuro'
- Euro Euro symbol.
+ The Euro symbol: Euro. For an alternative glyph design, try the
+ 'eurosym' package; also, most fonts nowadays come with their own
+ Euro symbol (Unicode U+20AC).
+
'\textexclamdown (or '!`')'
! Upside down exclamation point.
@@ -13165,7 +13168,7 @@
'\newpage' command after the '\tableofcontents' command, as above.
To make the table of contents LaTeX stores the information in an
-auxillary file named 'ROOT-FILE.toc' (*note Splitting the input::). For
+auxiliary file named 'ROOT-FILE.toc' (*note Splitting the input::). For
example, this LaTeX file 'test.tex'
\documentclass{article}
@@ -13214,7 +13217,7 @@
* \addcontentsline:: Add an entry to table of contents, etc.
* \addtocontents:: Add text directly to table of contents file, etc.
-* \nofiles:: Prevent writing to auxillary files
+* \nofiles:: Prevent writing to auxiliary files.
File: latex2e.info, Node: \addcontentsline, Next: \addtocontents, Up: Table of contents etc.
@@ -13233,7 +13236,7 @@
\addcontentsline{toc}{section}{\protect\textbf{Appendices}}
-It wll appear at the same indentation level as the sections, will be in
+It will appear at the same indentation level as the sections, will be in
boldface, and will be assigned the page number associated with the point
where it appears in the input file.
@@ -13342,7 +13345,7 @@
\nofiles
- Prevent LaTeX from writing any auxillary files. The only output will
+ Prevent LaTeX from writing any auxiliary files. The only output will
be the '.log' and '.pdf' (or '.dvi') files. This command must go in the
preamble.
@@ -13356,7 +13359,7 @@
\chapter{...}
...
-LaTeX will not erase any existing auxillary files, so if you insert the
+LaTeX will not erase any existing auxiliary files, so if you insert the
'\nofiles' command after you have run the file and gotten a '.toc' then
the table of contents page will continue to show the old information.
@@ -14280,58 +14283,45 @@
28 Command line
***************
-Synopsis, one of:
+Synopsis (from a terminal command line):
- pdflatex
- pdflatex OPTION ... LATEX-FILENAME COMMANDS
- pdflatex OPTION ... LATEX-FILENAME.tex COMMANDS
- pdflatex OPTION ... FIRST-LINE-WITH-BACKSLASH
+ pdflatex OPTIONS ARGUMENT
- or, less often, one of:
+ Run LaTeX on ARGUMENT. In place of 'pdflatex' you can also use
+'xelatex', or 'lualatex', or 'dviluatex', or 'latex'.
- latex
- latex OPTION ... LATEX-FILENAME COMMANDS
- latex OPTION ... LATEX-FILENAME.tex COMMANDS
- latex OPTION ... FIRST-LINE-WITH-BACKSLASH
+ For example, this will run LaTeX on the file 'thesis.tex', creating
+the output 'thesis.pdf'.
- Run LaTeX on the input file 'LATEX-FILENAME.tex'.
-
- This will run LaTeX on the file 'thesis.tex', creating the output
-'thesis.pdf'.
-
pdflatex thesis
-As in that example, '.tex' is the default file extension.
+Note that '.tex' is the default file extension.
- The synopsis shows two commands, 'pdflatex' and 'latex'. The
-original TeX program output a custom format, DVI. pdfTeX is a
-modification of that program. It is completely backward compatible.
-But it can output directly to PDF and so can take advantage of PDF's
-extra features such as hyperlinks, support for modern image formats such
-as JPG and PNG, and ubiquitous viewing programs. In short, if you run
-'pdflatex' then you will by default get PDF and have access to all its
-modern features, while if you run 'latex' then you will get DVI. The
-description here assumes pdfLaTeX.
+ pdfTeX is a development of the original TeX program, as are XeTeX and
+LuaTeX (*note TeX engines::). They are completely backward compatible.
+But the original program had a custom output format, DVI, while the
+newer ones can output directly to PDF. This allows them to take
+advantage of the extra features in PDF such as hyperlinks, support for
+modern image formats such as JPG and PNG, and ubiquitous viewing
+programs. In short, if you run 'pdflatex' or 'xelatex' or 'lualatex'
+then you will by default get PDF and have access to all its modern
+features. If you run 'latex', or 'dvilualatex', then you will get DVI.
+The description here assumes pdfLaTeX.
- If your command line invocation has no arguments or options at all
-then 'pdflatex' prompts the user for input from the terminal (escape
-from this by entering '<control>-D').
-
*Note Command line options:: for a selection of the most useful
-command line options.
+command line options. As to ARGUMENT, the usual case is that it does
+not begin with a backslash, so the system takes it to be the name of a
+file and it compiles that file. If ARGUMENT begins with a backslash
+then the system will interpret it as a line of LaTeX input, which can be
+used for special effects (*note Command line input::).
- If the first non-option argument begins with a backslash then all
-such arguments are interpreted as a line of LaTeX input (*note Command
-line input::). If it does not begin with a backslash then 'pdflatex'
-assumes it is the name of a file, which will be the job file. In this
-case, any remaining COMMANDS are processed as 'pdflatex' commands.
+ If you gave no arguments or options then 'pdflatex' prompts for input
+from the terminal. You can escape from this by entering '<control>-D'.
If LaTeX finds an error in your document then by default it stops and
asks you about it. *Note Recovering from errors:: for an outline of
what to do.
- *Note TeX engines:: for other system commands invoking LaTeX.
-
* Menu:
* Command line options:: Read text from the terminal.
@@ -14344,56 +14334,57 @@
28.1 Command line options
=========================
-With many implementations you can specify command line options by
-prefixing them with '-' or '--'. For instance, use '-' for TeX Live on
-GNU/Linux or MacTeX on Apple, and use '--' for MikTeX on Windows. These
-are the options relevant to ordinary document authoring. For a full
-list, try the command line command 'latex --help'.
+These are the options relevant to ordinary document authoring. For a
+full list, try the command line command 'latex --help'.
+ With many implementations you can specify command line options by
+prefixing them with '-' or '--'. This is the case for both TeX Live and
+MacTeX, and MiKTeX.
+
'version'
Show the current version, like 'pdfTeX 3.14159265-2.6-1.40.16 (TeX
- Live 2015/Debian)', along with a small amount of additional
+ Live 2015/Debian)' along with a small amount of additional
information, and exit.
'help'
- Give a brief usage message that is useful as a prompt, and exit.
+ Give a brief usage message that is useful as a prompt and exit.
'interaction=[batchmode|nonstopmode|scrollmode|errorstopmode]'
- When TeX is compiling a document it does so in one of four modes.
- In "errorstop mode" (the default), TeX stops at each error and asks
- for user intervention. In "batch mode" it prints nothing on the
- terminal, errors are scrolled as if the user hit '<return>' at
- every error, and missing files cause the job to abort. In "nonstop
- mode" diagnostic message appear on the terminal but as in batch
- mode there is no user interaction. In "scroll mode" TeX only stops
- for missing files or keyboard input.
+ TeX compiles a document in one of four modes. In "errorstop mode"
+ (the default), TeX stops at each error and asks for user
+ intervention. In "batch mode" it prints nothing on the terminal,
+ errors are scrolled as if the user hit '<return>' at every error,
+ and missing files cause the job to abort. In "nonstop mode"
+ diagnostic message appear on the terminal but as in batch mode
+ there is no user interaction. In "scroll mode" TeX only stops for
+ missing files or keyboard input.
For instance, starting LaTeX with the command line 'pdflatex
-interaction=batchmode FILENAME' eliminates most command line
- output.https://tex.stackexchange.com/a/128190/121234
+ output.
'jobname=STRING'
- Set the value of TeX's 'jobname' to the string. The most obvious
- effect of this is that the output file will then be 'STRING.pdf'.
+ Set the value of TeX's 'jobname' to the string. The log file and
+ output file will then be named 'STRING.log' and 'STRING.pdf'.
When you run 'pdflatex OPTIONS ARGUMENT', if ARGUMENT does not
- start with a backslash then TeX considers it the name of a tile
- inputs that file. Otherwise 'pdflatex' waits for the first
- '\input' instruction and the name of the input file will be the job
- name, used for name of the log file and the output file. This
- option short-circuits that process and directly specifies the name.
- *Note Command line input:: for an example of its use.
+ start with a backslash then TeX considers it the name of a file to
+ input. Otherwise it waits for the first '\input' instruction and
+ the name of the input file will be the job name. This is used to
+ name the log file the output file. This option overrides that
+ process and directly specifies the name. *Note Command line
+ input:: for an example of its use.
'output-directory=DIRECTORY'
- Use the existing directory DIRECTORY to write files in.
+ Write files in the directory DIRECTORY. It must already exist.
'shell-escape'
'no-shell-escape'
'enable-write18'
'disable-write18'
- Enable or disable '\write18{SHELL COMMAND}'. The first two are
- available with TeX Live or MacTeX while the second two come with
- MikTeX.
+ Enable or disable '\write18{SHELL COMMAND}'. The first two options
+ are for with TeX Live or MacTeX while the second two are for
+ MiKTeX.
Sometimes you want to run external system commands from inside a
LaTeX file. For instance the package 'sagetex' allows you to have
@@ -14404,12 +14395,12 @@
But with this functionality enabled, security issues could happen
if you compiled a LaTeX file from the Internet. By default
'\write18' is disabled. (More precisely, by default TeX Live,
- MacTeX, and MikTeX allow the execution of a limited number of
+ MacTeX, and MiKTeX only allow the execution of a limited number of
TeX-related programs, which they distribute.)
- If you call '\write18{ls -l}' with the option 'no-shell-escape'
- then you do not get an error, but the log file says 'runsystem(ls
- -l)...disabled'.
+ If you invoke LaTeX with the option 'no-shell-escape', and in your
+ document you call '\write18{ls -l}', then you do not get an error
+ but the log file says 'runsystem(ls -l)...disabled'.
'halt-on-error'
Stop processing at the first error.
@@ -14425,14 +14416,48 @@
28.2 Command line input
=======================
-As part of the command line invocation of LaTeX you can also specify
-arbitrary input by starting with a backslash. For example, this loads
-the package 'graphicx' with the option 'draft'.
+As part of the command line invocation 'pdflatex OPTIONS ARGUMENT' you
+can specify arbitrary input by starting ARGUMENT with a backslash. This
+allows you to do some special effects.
+ For example, this file (which uses the 'hyperref' package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+
+ \ifdefined\paperversion % in preamble
+ \newcommand{\urlcolor}{black}
+ \else
+ \newcommand{\urlcolor}{blue}
+ \fi
+ \usepackage[colorlinks=true,urlcolor=\urlcolor]{hyperref}
+ ...
+ \href{https://www.ctan.org}{CTAN} % in body
+ ...
+
+Compiling this document 'book.tex' with the command line 'pdflatex test'
+will give the 'CTAN' link in blue. But compiling it with 'pdflatex
+"\def\paperversion{}\input test.tex"' has the link in black. (Note the
+use of double quotes to prevent interpretation of the symbols by the
+command line shell; your system may do this differently.)
+
+ In a similar way, from the single file 'main.tex' you can compile two
+different versions.
+
+ pdflatex -jobname=students "\def\student{}\input{main}"
+ pdflatex -jobname=teachers "\def\teachers{}\input{main}"
+
+The 'jobname' option is there because otherwise both files would be
+called 'main.pdf' and the second would overwrite the first.
+
+ A final example. This loads the package 'graphicx' with the option
+'draft'
+
pdflatex -jobname=myfile "\RequirePackage[draft]{graphicx} \input{myfile.tex}"
-The graphic files are read for their size information, but not
-incorporated into the PDF.
+so the graphic files are read for their size information but not
+incorporated into the PDF. (The 'jobname' option is needed because
+otherwise the output file would be 'graphicx.pdf', as '\RequirePackage'
+does an '\input' of its own.)
File: latex2e.info, Node: Recovering from errors, Prev: Command line input, Up: Command line
@@ -14440,10 +14465,40 @@
28.3 Recovering from errors
===========================
-If LaTeX stops in the middle of the document and gives you a '*' prompt,
-it is waiting for input. You can type '\stop' (and return) and it will
-prematurely end the document.
+If LaTeX finds an error in your document then it gives you an error
+message and prompts you with a question mark, '?'. For instance,
+running LaTeX on this file
+ \newcommand{\NP}{\ensuremath{\textbf{NP}}}
+ The \PN{} problem is a million dollar one.
+
+ causes it show this, and wait for input.
+
+ ! Undefined control sequence.
+ l.5 The \PN
+ {} problem is a million dollar one.
+ ?
+
+The simplest thing is to enter 'x' and '<return>' and fix the typo. You
+could instead enter '?' and '<return>' to see other options.
+
+ There are two other error scenarios. The first is that you forgot to
+include the '\end{document}' or misspelled it. In this case LaTeX gives
+you a '*' prompt. You can get back to the command line by typing
+'\stop' and '<return>'.
+
+ The last scenario is that you mistyped the file name. For instance,
+instead of 'pdflatex test' you might type 'pdflatex tste'.
+
+ ! I can't find file `tste'.
+ <*> tste
+
+ (Press Enter to retry, or Control-D to exit)
+ Please type another input file name:
+
+The simplest thing is to enter '<Contol>' and 'd' (holding them down at
+the same time), and just fix the command line.
+
File: latex2e.info, Node: Document templates, Next: Concept Index, Prev: Command line, Up: Top
@@ -14697,7 +14752,7 @@
* Menu:
* * prompt: Recovering from errors.
- (line 6)
+ (line 23)
* *-form of environment commands: \newenvironment & \renewenvironment.
(line 27)
* *-form of sectioning commands: Sectioning. (line 31)
@@ -14751,8 +14806,8 @@
* aring: Additional Latin letters.
(line 12)
* arrays, math: array. (line 6)
-* arrow, left, in text: Text symbols. (line 137)
-* arrow, right, in text: Text symbols. (line 172)
+* arrow, left, in text: Text symbols. (line 140)
+* arrow, right, in text: Text symbols. (line 175)
* ascender height: Text symbols. (line 101)
* ASCII circumflex, in text: Text symbols. (line 66)
* ASCII tilde, in text: Text symbols. (line 69)
@@ -14836,7 +14891,7 @@
* centered asterisk, in text: Text symbols. (line 72)
* centered equations: Document class options.
(line 57)
-* centered period, in text: Text symbols. (line 144)
+* centered period, in text: Text symbols. (line 147)
* centering text, declaration for: \centering. (line 6)
* centering text, environment for: center. (line 6)
* Centimeter: Units of length. (line 24)
@@ -14988,22 +15043,22 @@
* double dagger, in text <1>: Text symbols. (line 111)
* double dot accent, math: Math accents. (line 23)
* double guillemets: Text symbols. (line 31)
-* double left quote: Text symbols. (line 150)
+* double left quote: Text symbols. (line 153)
* double low-9 quotation mark: Text symbols. (line 53)
-* double quote, straight base: Text symbols. (line 166)
-* double right quote: Text symbols. (line 153)
+* double quote, straight base: Text symbols. (line 169)
+* double right quote: Text symbols. (line 156)
* double spacing: Low-level font commands.
(line 118)
* double vertical bar, in text: Text symbols. (line 81)
* doublestruck: Blackboard bold. (line 6)
* e-dash: Text symbols. (line 122)
-* e-TeX: TeX engines. (line 12)
+* e-TeX: TeX engines. (line 13)
* ellipses: Ellipses. (line 6)
* ellipsis: Text symbols. (line 37)
* em: Units of length. (line 38)
* em-dash: Text symbols. (line 117)
-* em-dash, three-quarters: Text symbols. (line 175)
-* em-dash, two-thirds: Text symbols. (line 181)
+* em-dash, three-quarters: Text symbols. (line 178)
+* em-dash, two-thirds: Text symbols. (line 184)
* emphasis: Font styles. (line 59)
* enclosure list: \encl. (line 6)
* end of document hook: \AtEndDocument. (line 6)
@@ -15035,8 +15090,9 @@
* etoolbox package: Class and package commands.
(line 110)
* euro symbol: Text symbols. (line 125)
+* eurosym package: Text symbols. (line 125)
* ex: Units of length. (line 38)
-* exclamation point, upside-down: Text symbols. (line 128)
+* exclamation point, upside-down: Text symbols. (line 131)
* exponent: Subscripts & superscripts.
(line 6)
* extended Latin: Additional Latin letters.
@@ -15048,7 +15104,7 @@
* fancyhdr package <1>: \pagestyle. (line 13)
* fancyvrb package: tabbing. (line 145)
* fancyvrb package <1>: verbatim. (line 37)
-* feminine ordinal symbol: Text symbols. (line 141)
+* feminine ordinal symbol: Text symbols. (line 144)
* figure number, cross referencing: \ref. (line 6)
* figures, footnotes in: minipage. (line 112)
* figures, inserting: figure. (line 6)
@@ -15128,7 +15184,7 @@
* graphics, scaling <1>: \resizebox. (line 6)
* grave accent: Accents. (line 42)
* grave accent, math: Math accents. (line 29)
-* greater than symbol, in text: Text symbols. (line 131)
+* greater than symbol, in text: Text symbols. (line 134)
* greek letters: Math symbols. (line 6)
* group, and environments: Environments. (line 18)
* ha'c<ek accent, math: Math accents. (line 20)
@@ -15146,6 +15202,7 @@
* hungarian umlaut accent: Accents. (line 67)
* hyperref package: \footnotemark. (line 48)
* hyperref package <1>: \pagenumbering. (line 45)
+* hyperref package <2>: Command line input. (line 10)
* hyphenation, defining: \hyphenation. (line 6)
* hyphenation, discretionary: \discretionary. (line 6)
* hyphenation, forcing: \- (hyphenation). (line 6)
@@ -15214,11 +15271,11 @@
* layout, page parameters for: Page layout parameters.
(line 6)
* left angle quotation marks: Text symbols. (line 31)
-* left arrow, in text: Text symbols. (line 137)
+* left arrow, in text: Text symbols. (line 140)
* left brace, in text: Text symbols. (line 87)
* left quote: Text symbols. (line 41)
-* left quote, double: Text symbols. (line 150)
-* left quote, single: Text symbols. (line 156)
+* left quote, double: Text symbols. (line 153)
+* left quote, single: Text symbols. (line 159)
* left-hand equation numbers: Document class options.
(line 63)
* left-justifying text: \raggedright. (line 6)
@@ -15229,7 +15286,7 @@
* lengths, defining and using: Lengths. (line 6)
* lengths, predefined: Predefined lengths. (line 6)
* lengths, setting: \setlength. (line 6)
-* less than symbol, in text: Text symbols. (line 134)
+* less than symbol, in text: Text symbols. (line 137)
* letters, accented: Accents. (line 6)
* letters, additional Latin: Additional Latin letters.
(line 6)
@@ -15270,7 +15327,7 @@
(line 6)
* LR mode: Modes. (line 16)
* ltugboat class: tugboat template. (line 6)
-* LuaTeX: TeX engines. (line 29)
+* LuaTeX: TeX engines. (line 30)
* m-width: Units of length. (line 38)
* macro package, LaTeX as: Overview. (line 11)
* macron accent: Accents. (line 34)
@@ -15283,7 +15340,7 @@
* making a title page: titlepage. (line 6)
* making paragraphs: Making paragraphs. (line 6)
* marginal notes: Marginal notes. (line 6)
-* masculine ordinal symbol: Text symbols. (line 141)
+* masculine ordinal symbol: Text symbols. (line 144)
* matching brackets: \left & \right. (line 6)
* matching parentheses: \left & \right. (line 6)
* math accents: Math accents. (line 6)
@@ -15362,7 +15419,7 @@
(line 6)
* options, package <1>: Class and package commands.
(line 66)
-* ordinals, feminine and masculine: Text symbols. (line 141)
+* ordinals, feminine and masculine: Text symbols. (line 144)
* oslash: Additional Latin letters.
(line 44)
* outer paragraph mode: Modes. (line 46)
@@ -15414,6 +15471,7 @@
* package, envlab: \makelabels. (line 49)
* package, etoolbox: Class and package commands.
(line 110)
+* package, eurosym: Text symbols. (line 125)
* package, fancyhdr: Page styles. (line 12)
* package, fancyhdr <1>: \pagestyle. (line 13)
* package, fancyvrb: tabbing. (line 145)
@@ -15426,6 +15484,7 @@
(line 44)
* package, hyperref: \footnotemark. (line 48)
* package, hyperref <1>: \pagenumbering. (line 45)
+* package, hyperref <2>: Command line input. (line 10)
* package, indentfirst: \part. (line 50)
* package, indentfirst <1>: \chapter. (line 57)
* package, indentfirst <2>: \section. (line 60)
@@ -15455,7 +15514,7 @@
(line 80)
* package, polyglossia <3>: \index. (line 56)
* package, sagetex: Command line options.
- (line 57)
+ (line 58)
* package, setspace: Low-level font commands.
(line 118)
* package, showidx: Indexes. (line 32)
@@ -15518,9 +15577,9 @@
(line 6)
* PDF graphic files <1>: \includegraphics. (line 6)
* pdfTeX: Output files. (line 20)
-* pdfTeX engine: TeX engines. (line 12)
+* pdfTeX engine: TeX engines. (line 13)
* period, abbreviation-ending: \@. (line 6)
-* period, centered, in text: Text symbols. (line 144)
+* period, centered, in text: Text symbols. (line 147)
* period, sentence-ending: \@. (line 6)
* period, spacing after: \@. (line 6)
* pica: Units of length. (line 14)
@@ -15551,14 +15610,14 @@
* preamble, defined: Starting and ending. (line 19)
* predefined lengths: Predefined lengths. (line 6)
* prompt, *: Recovering from errors.
- (line 6)
+ (line 23)
* pronunciation: Overview. (line 24)
* quad: Spacing in math mode.
(line 50)
-* question mark, upside-down: Text symbols. (line 147)
+* question mark, upside-down: Text symbols. (line 150)
* quotation marks, French: Text symbols. (line 31)
-* quote, single straight: Text symbols. (line 162)
-* quote, straight base: Text symbols. (line 166)
+* quote, single straight: Text symbols. (line 165)
+* quote, straight base: Text symbols. (line 169)
* quoted text with paragraph indentation, displaying: quotation & quote.
(line 6)
* quoted text without paragraph indentation, displaying: quotation & quote.
@@ -15572,7 +15631,7 @@
(line 6)
* reference, forward: Cross references. (line 27)
* references, resolving forward: Output files. (line 33)
-* registered symbol: Text symbols. (line 169)
+* registered symbol: Text symbols. (line 172)
* relation, text above: \stackrel. (line 6)
* remarks in the margin: Marginal notes. (line 6)
* reporting bugs: About this document. (line 21)
@@ -15580,11 +15639,11 @@
* resizing: \scalebox. (line 6)
* resizing <1>: \resizebox. (line 6)
* right angle quotation marks: Text symbols. (line 31)
-* right arrow, in text: Text symbols. (line 172)
+* right arrow, in text: Text symbols. (line 175)
* right brace, in text: Text symbols. (line 90)
* right quote: Text symbols. (line 56)
-* right quote, double: Text symbols. (line 153)
-* right quote, single: Text symbols. (line 159)
+* right quote, double: Text symbols. (line 156)
+* right quote, single: Text symbols. (line 162)
* right-hand equation numbers: Document class options.
(line 63)
* right-justifying text: \raggedleft. (line 6)
@@ -15604,7 +15663,7 @@
(line 6)
* running header and footer style: \pagestyle. (line 6)
* sagetex package: Command line options.
- (line 57)
+ (line 58)
* sans serif font: Font styles. (line 86)
* Scaled point: Units of length. (line 36)
* scaling: \scalebox. (line 6)
@@ -15632,10 +15691,10 @@
* simulating typed text: verbatim. (line 6)
* single angle quotation marks: Text symbols. (line 31)
* single guillemets: Text symbols. (line 31)
-* single left quote: Text symbols. (line 156)
+* single left quote: Text symbols. (line 159)
* single low-9 quotation mark: Text symbols. (line 53)
-* single quote, straight: Text symbols. (line 162)
-* single right quote: Text symbols. (line 159)
+* single quote, straight: Text symbols. (line 165)
+* single right quote: Text symbols. (line 162)
* siunitx package: ~. (line 32)
* sizes of text: Font sizes. (line 6)
* skip register, plain TeX: \newlength. (line 6)
@@ -15658,7 +15717,7 @@
(line 6)
* spacing, inter-sentence: \frenchspacing. (line 6)
* spacing, inter-sentence <1>: \normalsfcodes. (line 6)
-* Spanish ordinals, feminine and masculine: Text symbols. (line 141)
+* Spanish ordinals, feminine and masculine: Text symbols. (line 144)
* special characters: Reserved characters. (line 6)
* special characters <1>: Additional Latin letters.
(line 6)
@@ -15677,9 +15736,9 @@
* starting on a right-hand page: \clearpage & \cleardoublepage.
(line 6)
* sterling symbol: Text symbols. (line 49)
-* straight double quote, base: Text symbols. (line 166)
-* straight quote, base: Text symbols. (line 166)
-* straight single quote: Text symbols. (line 162)
+* straight double quote, base: Text symbols. (line 169)
+* straight quote, base: Text symbols. (line 169)
+* straight single quote: Text symbols. (line 165)
* stretch, infinite horizontal: \hfill. (line 6)
* stretch, infinite vertical: \vfill. (line 6)
* stretch, omitting vertical: \raggedbottom. (line 6)
@@ -15743,7 +15802,7 @@
(line 6)
* thorn, Icelandic letter: Additional Latin letters.
(line 56)
-* three-quarters em-dash: Text symbols. (line 175)
+* three-quarters em-dash: Text symbols. (line 178)
* tie: ~. (line 6)
* tie-after accent: Accents. (line 81)
* TikZ package: \strut. (line 62)
@@ -15768,12 +15827,12 @@
(line 87)
* today's date: \today. (line 6)
* tombstone: \rule. (line 13)
-* trademark symbol: Text symbols. (line 178)
+* trademark symbol: Text symbols. (line 181)
* transcript file: Output files. (line 28)
* TrueType fonts: TeX engines. (line 6)
* TUGboat template: tugboat template. (line 6)
* two-column output: \twocolumn. (line 6)
-* two-thirds em-dash: Text symbols. (line 181)
+* two-thirds em-dash: Text symbols. (line 184)
* type styles: Font styles. (line 6)
* typed text, simulating: verbatim. (line 6)
* typeface sizes: Font sizes. (line 6)
@@ -15786,7 +15845,7 @@
* underbar: Accents. (line 51)
* underlining: Over- and Underlining.
(line 6)
-* underscore, in text: Text symbols. (line 184)
+* underscore, in text: Text symbols. (line 187)
* Unicode input, native: TeX engines. (line 6)
* units, of length: Units of length. (line 6)
* unofficial nature of this manual: About this document. (line 17)
@@ -15809,7 +15868,7 @@
* vertical space before paragraphs: \parindent & \parskip.
(line 6)
* visible space: \verb. (line 12)
-* visible space symbol, in text: Text symbols. (line 187)
+* visible space symbol, in text: Text symbols. (line 190)
* weights, of fonts: Low-level font commands.
(line 58)
* white space: Spaces. (line 6)
@@ -15820,7 +15879,7 @@
* writing external files: filecontents. (line 6)
* writing letters: Letters. (line 6)
* x-height: Units of length. (line 38)
-* XeTeX: TeX engines. (line 38)
+* XeTeX: TeX engines. (line 39)
* xindy program: makeindex. (line 153)
@@ -15833,8 +15892,30 @@
* Menu:
* &: tabular. (line 32)
+* --disable-write18 command-line option: Command line options.
+ (line 50)
+* --enable-write18 command-line option: Command line options.
+ (line 50)
+* --file-line-error command-line option: Command line options.
+ (line 77)
+* --halt-on-error command-line option: Command line options.
+ (line 74)
* --help command-line option: Command line options.
- (line 6)
+ (line 18)
+* --interaction command-line option: Command line options.
+ (line 21)
+* --jobname command-line option: Command line options.
+ (line 35)
+* --no-file-line-error command-line option: Command line options.
+ (line 77)
+* --no-shell-escape command-line option: Command line options.
+ (line 50)
+* --output-directory command-line option: Command line options.
+ (line 47)
+* --shell-escape command-line option: Command line options.
+ (line 50)
+* --version command-line option: Command line options.
+ (line 13)
* .aux file: Output files. (line 33)
* .dvi file: Output files. (line 10)
* .lof file: Output files. (line 43)
@@ -15845,11 +15926,11 @@
* .lot file <1>: Table of contents etc..
(line 6)
* .pdf file: Output files. (line 20)
-* .tex, default extension: Command line. (line 27)
+* .tex, default extension: Command line. (line 18)
* .toc file: Output files. (line 43)
* .toc file <1>: Table of contents etc..
(line 6)
-* .xdv file: TeX engines. (line 38)
+* .xdv file: TeX engines. (line 39)
* 10pt option: Document class options.
(line 14)
* 11pt option: Document class options.
@@ -16726,7 +16807,7 @@
* \star: Math symbols. (line 695)
* \stepcounter: \stepcounter. (line 6)
* \stop: Recovering from errors.
- (line 6)
+ (line 23)
* \strut: \strut. (line 6)
* \subparagraph: Sectioning. (line 6)
* \subparagraph <1>: \subsubsection & \paragraph & \subparagraph.
@@ -16782,48 +16863,48 @@
* \textemdash (or ---): Text symbols. (line 116)
* \textendash (or --): Text symbols. (line 121)
* \texteuro: Text symbols. (line 124)
-* \textexclamdown (or !`): Text symbols. (line 127)
+* \textexclamdown (or !`): Text symbols. (line 130)
* \textfloatsep: Floats. (line 123)
* \textfloatsep <1>: Floats. (line 124)
* \textfraction: Floats. (line 102)
* \textfraction <1>: Floats. (line 103)
-* \textgreater: Text symbols. (line 130)
+* \textgreater: Text symbols. (line 133)
* \textheight: Page layout parameters.
(line 91)
* \textheight <1>: Page layout parameters.
(line 92)
* \textit: Font styles. (line 33)
-* \textleftarrow: Text symbols. (line 136)
-* \textless: Text symbols. (line 133)
+* \textleftarrow: Text symbols. (line 139)
+* \textless: Text symbols. (line 136)
* \textmd: Font styles. (line 36)
* \textnormal: Font styles. (line 57)
-* \textordfeminine: Text symbols. (line 139)
-* \textordmasculine: Text symbols. (line 140)
+* \textordfeminine: Text symbols. (line 142)
+* \textordmasculine: Text symbols. (line 143)
* \textparagraph: Text symbols. (line 44)
-* \textperiodcentered: Text symbols. (line 143)
-* \textquestiondown (or ?`): Text symbols. (line 146)
-* \textquotedblleft (or ``): Text symbols. (line 149)
-* \textquotedblright (or ''): Text symbols. (line 152)
-* \textquoteleft (or `): Text symbols. (line 155)
-* \textquoteright (or '): Text symbols. (line 158)
-* \textquotesingle: Text symbols. (line 161)
-* \textquotestraightbase: Text symbols. (line 164)
-* \textquotestraightdblbase: Text symbols. (line 165)
-* \textregistered: Text symbols. (line 168)
-* \textrightarrow: Text symbols. (line 171)
+* \textperiodcentered: Text symbols. (line 146)
+* \textquestiondown (or ?`): Text symbols. (line 149)
+* \textquotedblleft (or ``): Text symbols. (line 152)
+* \textquotedblright (or ''): Text symbols. (line 155)
+* \textquoteleft (or `): Text symbols. (line 158)
+* \textquoteright (or '): Text symbols. (line 161)
+* \textquotesingle: Text symbols. (line 164)
+* \textquotestraightbase: Text symbols. (line 167)
+* \textquotestraightdblbase: Text symbols. (line 168)
+* \textregistered: Text symbols. (line 171)
+* \textrightarrow: Text symbols. (line 174)
* \textrm: Font styles. (line 30)
* \textsc: Font styles. (line 51)
* \textsection: Text symbols. (line 59)
* \textsf: Font styles. (line 48)
* \textsl: Font styles. (line 45)
* \textsterling: Text symbols. (line 48)
-* \textthreequartersemdash: Text symbols. (line 174)
-* \texttrademark: Text symbols. (line 177)
+* \textthreequartersemdash: Text symbols. (line 177)
+* \texttrademark: Text symbols. (line 180)
* \texttt: Font styles. (line 54)
-* \texttwelveudash: Text symbols. (line 180)
-* \textunderscore: Text symbols. (line 183)
+* \texttwelveudash: Text symbols. (line 183)
+* \textunderscore: Text symbols. (line 186)
* \textup: Font styles. (line 42)
-* \textvisiblespace: Text symbols. (line 186)
+* \textvisiblespace: Text symbols. (line 189)
* \textwidth: Page layout parameters.
(line 99)
* \textwidth <1>: Page layout parameters.
@@ -16986,7 +17067,7 @@
* description: \newglossaryentry. (line 46)
* description environment: description. (line 6)
* disable-write18: Command line options.
- (line 52)
+ (line 53)
* displaymath environment: displaymath. (line 6)
* displaymath environment <1>: Math formulas. (line 6)
* document environment: document. (line 6)
@@ -16997,7 +17078,7 @@
* dvitype command: Output files. (line 10)
* em: Units of length. (line 38)
* enable-write18: Command line options.
- (line 51)
+ (line 52)
* enumerate environment: enumerate. (line 6)
* environment, abstract: abstract. (line 6)
* environment, array: array. (line 6)
@@ -17035,13 +17116,13 @@
* eqnarray environment: eqnarray. (line 6)
* equation environment: equation. (line 6)
* equation environment <1>: Math formulas. (line 6)
-* etex command: TeX engines. (line 12)
+* etex command: TeX engines. (line 13)
* ex: Units of length. (line 38)
* executivepaper option: Document class options.
(line 19)
* figure environment: figure. (line 6)
* file-line-error: Command line options.
- (line 76)
+ (line 77)
* filecontents environment: filecontents. (line 6)
* filecontents* environment: filecontents. (line 6)
* final option: Document class options.
@@ -17056,9 +17137,9 @@
* frame, separation from contents: \fbox & \framebox. (line 43)
* group_skip: makeindex. (line 57)
* halt-on-error: Command line options.
- (line 73)
+ (line 74)
* help: Command line options.
- (line 17)
+ (line 18)
* <http://puszcza.gnu.org.ua/software/latexrefman/> home page: About this document.
(line 6)
* in: Units of length. (line 17)
@@ -17067,7 +17148,7 @@
* indent_space: makeindex. (line 134)
* index, style file: makeindex. (line 18)
* interaction=[batchmode|nonstopmode|scrollmode|errorstopmode]: Command line options.
- (line 20)
+ (line 21)
* itemize environment: itemize. (line 6)
* item_0: makeindex. (line 81)
* item_01: makeindex. (line 90)
@@ -17077,7 +17158,7 @@
* item_x1: makeindex. (line 94)
* item_x2 <string>: makeindex. (line 104)
* jobname=STRING: Command line options.
- (line 34)
+ (line 35)
* landscape option: Document class options.
(line 49)
* latex command: Output files. (line 10)
@@ -17099,7 +17180,7 @@
* LR box: picture. (line 103)
* lrbox: lrbox. (line 6)
* lshort document: About this document. (line 41)
-* lualatex command: TeX engines. (line 29)
+* lualatex command: TeX engines. (line 30)
* makeindex: makeindex. (line 6)
* makeindex, style file: makeindex. (line 18)
* math environment: math. (line 6)
@@ -17109,9 +17190,9 @@
* mu: Units of length. (line 49)
* name: \newglossaryentry. (line 43)
* no-file-line-error: Command line options.
- (line 77)
+ (line 78)
* no-shell-escape: Command line options.
- (line 50)
+ (line 51)
* notitlepage option: Document class options.
(line 49)
* onecolumn option: Document class options.
@@ -17125,7 +17206,7 @@
* openright option: Document class options.
(line 78)
* output-directory=DIRECTORY: Command line options.
- (line 46)
+ (line 47)
* page_precedence: makeindex. (line 143)
* pc: Units of length. (line 14)
* pdflatex command: Output files. (line 20)
@@ -17140,7 +17221,7 @@
* secnumdepth: Sectioning. (line 61)
* secnumdepth counter: Sectioning. (line 62)
* shell-escape: Command line options.
- (line 49)
+ (line 50)
* slides class: Document classes. (line 11)
* sloppypar: sloppypar. (line 6)
* sort: \newglossaryentry. (line 55)
@@ -17171,10 +17252,10 @@
* verbatim environment: verbatim. (line 6)
* verse environment: verse. (line 6)
* version: Command line options.
- (line 12)
+ (line 13)
* xdvi command: Output files. (line 10)
-* xdvipdfmx: TeX engines. (line 38)
-* xelatex command: TeX engines. (line 38)
+* xdvipdfmx: TeX engines. (line 39)
+* xelatex command: TeX engines. (line 39)
* xindy: makeindex. (line 153)
@@ -17183,301 +17264,301 @@
Node: Top1701
Node: About this document3585
Node: Overview5445
-Node: Starting and ending6945
-Ref: Starting & ending7080
-Node: Output files8066
-Node: TeX engines10312
-Node: LaTeX command syntax12750
-Node: Environment14584
-Node: Declaration15657
-Node: \makeatletter and \makeatother16043
-Node: \@ifstar18236
-Node: Document classes21065
-Node: Document class options22388
-Node: Additional packages25470
-Node: Class and package construction26101
-Node: Class and package structure27553
-Node: Class and package commands29847
-Node: Fonts47372
-Ref: Typefaces47475
-Node: Font styles47803
-Node: Font sizes52231
-Node: Low-level font commands53462
-Node: Layout58569
-Node: \onecolumn59067
-Node: \twocolumn59429
-Node: \flushbottom63824
-Node: \raggedbottom64924
-Node: Page layout parameters65460
-Node: Floats71158
-Node: Sectioning77623
-Ref: Sectioning/secnumdepth80334
-Ref: Sectioning/tocdepth80945
-Node: \part81990
-Node: \chapter84178
-Node: \section87980
-Node: \subsection91272
-Node: \subsubsection & \paragraph & \subparagraph94000
-Node: \appendix96657
-Node: \frontmatter & \mainmatter & \backmatter97898
-Node: \@startsection99240
-Ref: \@startsection/name100561
-Ref: \@startsection/level101021
-Ref: \@startsection/indent101904
-Ref: \@startsection/beforeskip102167
-Ref: \@startsection/afterskip103688
-Ref: \@startsection/style104999
-Node: Cross references108834
-Node: \label110934
-Node: \pageref112731
-Node: \ref113531
-Node: Environments114408
-Node: abstract116411
-Node: array118000
-Node: center120395
-Node: \centering122123
-Node: description123567
-Node: displaymath125754
-Node: document127532
-Node: \AtBeginDocument127962
-Node: \AtEndDocument128586
-Node: enumerate129230
-Node: eqnarray132024
-Node: equation134019
-Node: figure134647
-Node: filecontents136722
-Node: flushleft138472
-Node: \raggedright139401
-Node: flushright140599
-Node: \raggedleft141262
-Node: itemize142052
-Node: letter145517
-Node: list145755
-Node: \item158573
-Node: trivlist159824
-Node: math161352
-Node: minipage161658
-Node: picture166515
-Node: \put172949
-Node: \multiput173427
-Node: \qbezier174147
-Node: \graphpaper175075
-Node: \line175872
-Node: \linethickness177651
-Node: \thinlines178100
-Node: \thicklines178511
-Node: \circle178895
-Node: \oval179435
-Node: \shortstack180414
-Node: \vector181816
-Node: \makebox (picture)182659
-Node: \framebox (picture)183588
-Node: \frame184383
-Node: \dashbox184782
-Node: quotation & quote185508
-Node: tabbing186404
-Node: table192409
-Node: tabular194434
-Node: \multicolumn201684
-Node: \vline205569
-Node: \cline206914
-Node: \hline207598
-Node: thebibliography208280
-Node: \bibitem210693
-Node: \cite212971
-Node: \nocite214624
-Node: Using BibTeX215113
-Node: theorem217060
-Node: titlepage217982
-Node: verbatim219265
-Node: \verb220775
-Node: verse222244
-Node: Line breaking223474
-Node: \\224840
-Node: \obeycr & \restorecr227289
-Node: \newline228089
-Node: \- (hyphenation)229027
-Node: \discretionary230668
-Node: \fussy & \sloppy231556
-Node: sloppypar232338
-Node: \hyphenation233477
-Node: \linebreak & \nolinebreak234062
-Node: Page breaking235133
-Node: \clearpage & \cleardoublepage237162
-Node: \newpage238640
-Node: \enlargethispage239933
-Node: \pagebreak & \nopagebreak240889
-Node: Footnotes242472
-Node: \footnote243618
-Node: \footnotemark246566
-Node: \footnotetext248911
-Node: Footnotes in section headings249512
-Node: Footnotes in a table250339
-Node: Footnotes of footnotes253217
-Node: Definitions253921
-Node: \newcommand & \renewcommand254798
-Node: \providecommand260012
-Node: \newcounter261161
-Node: \newlength262906
-Node: \newsavebox263766
-Node: \newenvironment & \renewenvironment264710
-Node: \newtheorem269835
-Node: \newfont273363
-Node: \protect274659
-Node: \ignorespaces & \ignorespacesafterend277045
-Node: Counters279791
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol281492
-Node: \usecounter284320
-Node: \value285183
-Node: \setcounter286112
-Node: \addtocounter286714
-Node: \refstepcounter287179
-Node: \stepcounter287837
-Node: \day & \month & \year288183
-Node: Lengths288997
-Node: Units of length293433
-Ref: Lengths/em294070
-Ref: Lengths/en294070
-Ref: Lengths/ex294070
-Node: \setlength294926
-Node: \addtolength295703
-Node: \settodepth296677
-Node: \settoheight297432
-Node: \settowidth298191
-Node: Predefined lengths298973
-Node: Making paragraphs299488
-Node: \par301143
-Node: \indent & \noindent302981
-Node: \parindent & \parskip304533
-Node: Marginal notes305571
-Node: Math formulas307370
-Node: Subscripts & superscripts311357
-Node: Math symbols313466
-Node: Blackboard bold339836
-Node: Calligraphic340611
-Node: \boldmath & \unboldmath341183
-Node: Ellipses342713
-Node: Math functions344867
-Node: Math accents346475
-Node: Over- and Underlining347374
-Node: Spacing in math mode349202
-Ref: Spacing in math mode/\thinspace350209
-Ref: Spacing in math mode/\quad350890
-Ref: Spacing in math mode/\qquad351146
-Node: Math miscellany351244
-Node: Colon character & \colon351803
-Node: \*352496
-Node: \frac353080
-Node: \left & \right353493
-Node: \sqrt354670
-Node: \stackrel355265
-Node: Modes355538
-Node: \ensuremath358152
-Node: Page styles358864
-Node: \maketitle359627
-Node: \pagenumbering362637
-Node: \pagestyle364574
-Node: \thispagestyle368079
-Node: Spaces368466
-Node: \enspace & \quad & \qquad369907
-Node: \hspace370854
-Node: \hfill372668
-Node: \hss373724
-Node: \spacefactor374421
-Node: \@377810
-Ref: \AT377910
-Node: \frenchspacing379853
-Node: \normalsfcodes380688
-Node: \(SPACE)380935
-Node: ~382570
-Node: \thinspace & \negthinspace385049
-Node: \/385992
-Node: \hrulefill & \dotfill387298
-Node: \bigskip & \medskip & \smallskip388634
-Node: \bigbreak & \medbreak & \smallbreak390526
-Node: \strut391511
-Node: \vspace394697
-Node: \vfill396254
-Node: \addvspace397132
-Node: Boxes399129
-Node: \mbox & \makebox399965
-Node: \fbox & \framebox403140
-Node: \parbox405664
-Node: \raisebox407944
-Node: \sbox & \savebox409602
-Node: lrbox412564
-Node: \usebox413386
-Node: Color413736
-Node: Color package options414580
-Node: Color models416226
-Node: Commands for color418535
-Node: Define colors418950
-Node: Colored text419665
-Node: Colored boxes422037
-Node: Colored pages423471
-Node: Graphics424164
-Node: Graphics package options426291
-Node: Graphics package configuration429044
-Node: \graphicspath429846
-Node: \DeclareGraphicsExtensions432769
-Node: \DeclareGraphicsRule434566
-Node: Commands for graphics437755
-Node: \includegraphics438260
-Node: \rotatebox451229
-Node: \scalebox454024
-Node: \resizebox455076
-Node: Special insertions456268
-Node: Reserved characters457070
-Node: Upper and lower case458271
-Node: Symbols by font position460186
-Node: Text symbols460806
-Node: Accents464654
-Node: Additional Latin letters466669
-Ref: Non-English characters466840
-Node: \rule467857
-Node: \today468974
-Node: Splitting the input469910
-Node: \endinput471462
-Node: \include & \includeonly472729
-Node: \input476953
-Node: Front/back matter477661
-Node: Table of contents etc.477994
-Node: \addcontentsline481686
-Node: \addtocontents484402
-Node: \nofiles485962
-Node: Indexes486694
-Node: \index488322
-Node: makeindex493391
-Node: \printindex499124
-Node: Glossaries499596
-Node: \newglossaryentry501570
-Node: \gls503039
-Node: Letters503836
-Node: \address507502
-Node: \cc508313
-Node: \closing508731
-Node: \encl509008
-Node: \location509423
-Node: \makelabels509687
-Node: \name511839
-Node: \opening512080
-Node: \ps512361
-Node: \signature512650
-Node: \telephone513867
-Node: Terminal input/output514232
-Node: \typein514497
-Node: \typeout515752
-Node: Command line516799
-Node: Command line options519136
-Node: Command line input522647
-Node: Recovering from errors523189
-Node: Document templates523521
-Node: beamer template523974
-Node: article template524628
-Node: book template525055
-Node: Larger book template525536
-Node: tugboat template527022
-Node: Concept Index529393
-Node: Command Index610866
+Node: Starting and ending6950
+Ref: Starting & ending7085
+Node: Output files8071
+Node: TeX engines10317
+Node: LaTeX command syntax12787
+Node: Environment14621
+Node: Declaration15694
+Node: \makeatletter and \makeatother16080
+Node: \@ifstar18273
+Node: Document classes21102
+Node: Document class options22425
+Node: Additional packages25507
+Node: Class and package construction26138
+Node: Class and package structure27590
+Node: Class and package commands29884
+Node: Fonts47409
+Ref: Typefaces47512
+Node: Font styles47840
+Node: Font sizes52268
+Node: Low-level font commands53499
+Node: Layout58606
+Node: \onecolumn59104
+Node: \twocolumn59466
+Node: \flushbottom63861
+Node: \raggedbottom64961
+Node: Page layout parameters65497
+Node: Floats71195
+Node: Sectioning77660
+Ref: Sectioning/secnumdepth80371
+Ref: Sectioning/tocdepth80982
+Node: \part82027
+Node: \chapter84215
+Node: \section88017
+Node: \subsection91309
+Node: \subsubsection & \paragraph & \subparagraph94037
+Node: \appendix96694
+Node: \frontmatter & \mainmatter & \backmatter97935
+Node: \@startsection99277
+Ref: \@startsection/name100598
+Ref: \@startsection/level101058
+Ref: \@startsection/indent101941
+Ref: \@startsection/beforeskip102204
+Ref: \@startsection/afterskip103725
+Ref: \@startsection/style105036
+Node: Cross references108871
+Node: \label110971
+Node: \pageref112768
+Node: \ref113568
+Node: Environments114445
+Node: abstract116448
+Node: array118037
+Node: center120432
+Node: \centering122160
+Node: description123604
+Node: displaymath125791
+Node: document127569
+Node: \AtBeginDocument127999
+Node: \AtEndDocument128623
+Node: enumerate129267
+Node: eqnarray132061
+Node: equation134056
+Node: figure134684
+Node: filecontents136759
+Node: flushleft138509
+Node: \raggedright139438
+Node: flushright140636
+Node: \raggedleft141299
+Node: itemize142089
+Node: letter145554
+Node: list145792
+Node: \item158610
+Node: trivlist159861
+Node: math161389
+Node: minipage161695
+Node: picture166552
+Node: \put172986
+Node: \multiput173464
+Node: \qbezier174184
+Node: \graphpaper175112
+Node: \line175909
+Node: \linethickness177688
+Node: \thinlines178137
+Node: \thicklines178548
+Node: \circle178932
+Node: \oval179472
+Node: \shortstack180451
+Node: \vector181853
+Node: \makebox (picture)182696
+Node: \framebox (picture)183625
+Node: \frame184420
+Node: \dashbox184819
+Node: quotation & quote185545
+Node: tabbing186441
+Node: table192446
+Node: tabular194471
+Node: \multicolumn201721
+Node: \vline205606
+Node: \cline206951
+Node: \hline207635
+Node: thebibliography208317
+Node: \bibitem210730
+Node: \cite213008
+Node: \nocite214661
+Node: Using BibTeX215150
+Node: theorem217097
+Node: titlepage218019
+Node: verbatim219302
+Node: \verb220812
+Node: verse222281
+Node: Line breaking223511
+Node: \\224877
+Node: \obeycr & \restorecr227326
+Node: \newline228126
+Node: \- (hyphenation)229064
+Node: \discretionary230705
+Node: \fussy & \sloppy231593
+Node: sloppypar232375
+Node: \hyphenation233514
+Node: \linebreak & \nolinebreak234099
+Node: Page breaking235170
+Node: \clearpage & \cleardoublepage237199
+Node: \newpage238677
+Node: \enlargethispage239970
+Node: \pagebreak & \nopagebreak240926
+Node: Footnotes242509
+Node: \footnote243655
+Node: \footnotemark246603
+Node: \footnotetext248948
+Node: Footnotes in section headings249549
+Node: Footnotes in a table250376
+Node: Footnotes of footnotes253254
+Node: Definitions253958
+Node: \newcommand & \renewcommand254835
+Node: \providecommand260049
+Node: \newcounter261198
+Node: \newlength262943
+Node: \newsavebox263803
+Node: \newenvironment & \renewenvironment264747
+Node: \newtheorem269872
+Node: \newfont273400
+Node: \protect274696
+Node: \ignorespaces & \ignorespacesafterend277082
+Node: Counters279828
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol281529
+Node: \usecounter284357
+Node: \value285220
+Node: \setcounter286149
+Node: \addtocounter286751
+Node: \refstepcounter287216
+Node: \stepcounter287874
+Node: \day & \month & \year288220
+Node: Lengths289034
+Node: Units of length293470
+Ref: Lengths/em294107
+Ref: Lengths/en294107
+Ref: Lengths/ex294107
+Node: \setlength294963
+Node: \addtolength295740
+Node: \settodepth296714
+Node: \settoheight297469
+Node: \settowidth298228
+Node: Predefined lengths299010
+Node: Making paragraphs299525
+Node: \par301180
+Node: \indent & \noindent303018
+Node: \parindent & \parskip304570
+Node: Marginal notes305608
+Node: Math formulas307407
+Node: Subscripts & superscripts311394
+Node: Math symbols313503
+Node: Blackboard bold339873
+Node: Calligraphic340648
+Node: \boldmath & \unboldmath341220
+Node: Ellipses342750
+Node: Math functions344904
+Node: Math accents346512
+Node: Over- and Underlining347411
+Node: Spacing in math mode349239
+Ref: Spacing in math mode/\thinspace350246
+Ref: Spacing in math mode/\quad350927
+Ref: Spacing in math mode/\qquad351183
+Node: Math miscellany351281
+Node: Colon character & \colon351840
+Node: \*352533
+Node: \frac353117
+Node: \left & \right353530
+Node: \sqrt354707
+Node: \stackrel355302
+Node: Modes355575
+Node: \ensuremath358189
+Node: Page styles358901
+Node: \maketitle359664
+Node: \pagenumbering362674
+Node: \pagestyle364611
+Node: \thispagestyle368116
+Node: Spaces368503
+Node: \enspace & \quad & \qquad369944
+Node: \hspace370891
+Node: \hfill372705
+Node: \hss373761
+Node: \spacefactor374458
+Node: \@377847
+Ref: \AT377947
+Node: \frenchspacing379890
+Node: \normalsfcodes380725
+Node: \(SPACE)380972
+Node: ~382607
+Node: \thinspace & \negthinspace385086
+Node: \/386029
+Node: \hrulefill & \dotfill387335
+Node: \bigskip & \medskip & \smallskip388671
+Node: \bigbreak & \medbreak & \smallbreak390563
+Node: \strut391548
+Node: \vspace394734
+Node: \vfill396291
+Node: \addvspace397169
+Node: Boxes399166
+Node: \mbox & \makebox400002
+Node: \fbox & \framebox403177
+Node: \parbox405701
+Node: \raisebox407981
+Node: \sbox & \savebox409639
+Node: lrbox412601
+Node: \usebox413423
+Node: Color413773
+Node: Color package options414617
+Node: Color models416263
+Node: Commands for color418572
+Node: Define colors418987
+Node: Colored text419702
+Node: Colored boxes422074
+Node: Colored pages423508
+Node: Graphics424201
+Node: Graphics package options426328
+Node: Graphics package configuration429081
+Node: \graphicspath429883
+Node: \DeclareGraphicsExtensions432806
+Node: \DeclareGraphicsRule434603
+Node: Commands for graphics437792
+Node: \includegraphics438297
+Node: \rotatebox451266
+Node: \scalebox454061
+Node: \resizebox455113
+Node: Special insertions456305
+Node: Reserved characters457107
+Node: Upper and lower case458308
+Node: Symbols by font position460223
+Node: Text symbols460843
+Node: Accents464844
+Node: Additional Latin letters466859
+Ref: Non-English characters467030
+Node: \rule468047
+Node: \today469164
+Node: Splitting the input470100
+Node: \endinput471652
+Node: \include & \includeonly472919
+Node: \input477143
+Node: Front/back matter477851
+Node: Table of contents etc.478184
+Node: \addcontentsline481877
+Node: \addtocontents484594
+Node: \nofiles486154
+Node: Indexes486886
+Node: \index488514
+Node: makeindex493583
+Node: \printindex499316
+Node: Glossaries499788
+Node: \newglossaryentry501762
+Node: \gls503231
+Node: Letters504028
+Node: \address507694
+Node: \cc508505
+Node: \closing508923
+Node: \encl509200
+Node: \location509615
+Node: \makelabels509879
+Node: \name512031
+Node: \opening512272
+Node: \ps512553
+Node: \signature512842
+Node: \telephone514059
+Node: Terminal input/output514424
+Node: \typein514689
+Node: \typeout515944
+Node: Command line516991
+Node: Command line options519048
+Node: Command line input522480
+Node: Recovering from errors524348
+Node: Document templates525685
+Node: beamer template526138
+Node: article template526792
+Node: book template527219
+Node: Larger book template527700
+Node: tugboat template529186
+Node: Concept Index531557
+Node: Command Index613322
End Tag Table
Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2018-06-28 15:31:06 UTC (rev 665)
+++ trunk/latex2e.texi 2018-06-28 18:51:27 UTC (rev 666)
@@ -15,7 +15,6 @@
@c xx ctan, distributions, components of TeX
@c xx classes and packages -- required, additional, useful; oberdiek; fonts
@c
- at c xx merge http://ctan.org/pkg/latex-info (CTAN package latex-info)
@c xx merge http://ctan.org/pkg/latex2e-reference
@c xx merge permuted-index
@c xx merge latex-manual from savannah
@@ -23,8 +22,7 @@
@c xx JH explain nfss somewhere
@c xx JH expand BiBTeX
@c xx JH expand theorem, AMS math
- at c xx JH add something on code listings
- at c xx JH \strut
+ at c xx JH something on code listings
@c xx JH ligatures
@c xx JH \xspace
@c xx JH \stretch
@@ -32,6 +30,7 @@
@c xx JH \phantom https://tex.stackexchange.com/questions/4519/how-do-i-create-an-invisible-character
@c xx JH \baselineskip https://texfaq.org/FAQ-baselinepar
@c xx JH \contentsline, \@@dottedtocline?
+ at c xx JH more on \write18, beyond what's mentioned in Command line.
@c
@c xx The typeset source2e has an index with all kernel
@c xx commands, though some are internal and shouldn't be included.
@@ -269,8 +268,8 @@
sensible, such as in plain text, write it as @samp{LaTeX}.
@menu
-* Starting and ending:: The standard beginning and end of a document.
-* Output files:: Files produced.
+* Starting and ending:: The standard beginning and end of a document.
+* Output files:: Files produced.
* @TeX{} engines:: Programs that can compile @TeX{} and @LaTeX{}.
* @LaTeX{} command syntax:: General syntax of @LaTeX{} commands.
@end menu
@@ -407,7 +406,7 @@
@LaTeX{} is defined to be a set of commands that are run by a @TeX{}
implementation (@pxref{Overview}). This section gives a terse
-overview of the main programs.
+overview of the main programs (see also at tie{}@ref{Command line}).
@table @code
@item latex
@@ -17552,75 +17551,56 @@
@node Command line
@chapter Command line
- at c https://tex.stackexchange.com/q/220091/121234
- at c backslashes on Windows https://tex.stackexchange.com/q/86707/121234
- at c texdoc https://tex.stackexchange.com/a/22967/121234
- at c example of passing options to a package https://tex.stackexchange.com/a/17236/121234
- at c etoolbox WR https://tex.stackexchange.com/a/5896/121234
@cindex command line
-Synopsis, one of:
+Synopsis (from a terminal command line):
@example
-pdflatex
-pdflatex @var{option} ... @var{latex-filename} @var{commands}
-pdflatex @var{option} ... @var{latex-filename}.tex @var{commands}
-pdflatex @var{option} ... @var{first-line-with-backslash}
+pdflatex @var{options} @var{argument}
@end example
-or, less often, one of:
+Run @LaTeX{} on @var{argument}. In place of @command{pdflatex} you can
+also use @command{xelatex}, or @code{lualatex}, or @code{dviluatex}, or
+ at code{latex}.
- at example
-latex
-latex @var{option} ... @var{latex-filename} @var{commands}
-latex @var{option} ... @var{latex-filename}.tex @var{commands}
-latex @var{option} ... @var{first-line-with-backslash}
- at end example
+For example, this will run @LaTeX{} on the file @file{thesis.tex},
+creating the output @file{thesis.pdf}.
-Run @LaTeX{} on the input file @file{@var{latex-filename}.tex}.
-
-This will run @LaTeX{} on the file @file{thesis.tex}, creating the
-output @file{thesis.pdf}.
-
@example
- at command{pdflatex} thesis
+pdflatex thesis
@end example
@noindent
@findex .tex, @r{default extension}
-As in that example, @file{.tex} is the default file extension.
+Note that @file{.tex} is the default file extension.
-The synopsis shows two commands, @command{pdflatex} and @code{latex}.
-The original @TeX{} program output a custom format, DVI. pdf at TeX{} is
-a modification of that program. It is completely backward compatible.
-But it can output directly to PDF and so can take advantage of the
-extra features in PDF such as hyperlinks, support for modern image
-formats such as JPG and PNG, and ubiquitous viewing programs. In
-short, if you run @command{pdflatex} then you will by default get PDF
-and have access to all its modern features, while if you run
- at command{latex} then you will get DVI. The description here assumes
-pdf at LaTeX{}.
+pdf at TeX{} is a development of the original @TeX{} program, as are
+Xe at TeX{} and Lua at TeX{} (@pxref{@TeX{} engines}). They are completely
+backward compatible. But the original program had a custom output
+format, DVI, while the newer ones can output directly to PDF. This
+allows them to take advantage of the extra features in PDF such as
+hyperlinks, support for modern image formats such as JPG and PNG, and
+ubiquitous viewing programs. In short, if you run @command{pdflatex} or
+ at command{xelatex} or @command{lualatex} then you will by default get PDF
+and have access to all its modern features. If you run @command{latex},
+or @code{dvilualatex}, then you will get DVI. The description here
+assumes pdf at LaTeX{}.
-If your command line invocation has no arguments or options at all then
- at command{pdflatex} prompts the user for input from the terminal (escape
-from this by entering @code{<control>-D}).
-
@xref{Command line options} for a selection of the most useful command
-line options.
+line options. As to @var{argument}, the usual case is that it does not
+begin with a backslash, so the system takes it to be the name of a file
+and it compiles that file. If @var{argument} begins with a backslash
+then the system will interpret it as a line of @LaTeX{} input, which can
+be used for special effects (@pxref{Command line input}).
-If the first non-option argument begins with a backslash then all such
-arguments are interpreted as a line of @LaTeX{} input (@pxref{Command
-line input}). If it does not begin with a backslash then
- at command{pdflatex} assumes it is the name of a file, which will be the
-job file. In this case, any remaining @var{commands} are processed as
- at command{pdflatex} commands.
+If you gave no arguments or options then @command{pdflatex} prompts for
+input from the terminal. You can escape from this by entering
+ at code{<control>-D}.
If @LaTeX{} finds an error in your document then by default it stops and
asks you about it. @xref{Recovering from errors} for an outline of what
to do.
- at xref{@TeX{} engines} for other system commands invoking @LaTeX{}.
-
@menu
* Command line options:: Read text from the terminal.
* Command line input:: Write text to the terminal.
@@ -17631,59 +17611,68 @@
@node Command line options
@section Command line options
- at findex --help @r{command-line option}
+These are the options relevant to ordinary document authoring. For a
+full list, try the command line command @samp{latex --help}.
+
With many implementations you can specify command line options by
-prefixing them with either @samp{-} or @samp{--}. This is the case for
-both @TeX{} Live and MiK at TeX{}. These are the options relevant to
-ordinary document authoring. For a full list, try the command line
-command @samp{latex --help}.
+prefixing them with @samp{-} or @samp{--}. This is the case for
+both @TeX{} Live and Mac at TeX{}, and MiK at TeX{}.
@ftable @code
+ at findex --version @r{command-line option}
@item version
Show the current version, like @samp{pdfTeX 3.14159265-2.6-1.40.16 (TeX
-Live 2015/Debian)}, along with a small amount of additional information,
+Live 2015/Debian)} along with a small amount of additional information,
and exit.
+ at findex --help @r{command-line option}
@item help
-Give a brief usage message that is useful as a prompt, and exit.
+Give a brief usage message that is useful as a prompt and exit.
+ at findex --interaction @r{command-line option}
@item interaction=[batchmode|nonstopmode|scrollmode|errorstopmode]
-When @TeX{} is compiling a document it does so in one of four modes. In
- at dfn{errorstopmode} (the default), @TeX{} stops at each error and asks
-for user intervention. In @dfn{batch mode} it prints nothing on the
-terminal, errors are scrolled as if the user hit @code{<return>} at
-every error, and missing files cause the job to abort. In @dfn{nonstop
-mode} diagnostic message appear on the terminal but as in batch mode
-there is no user interaction. In @dfn{scroll mode} @TeX{} only stops
-for missing files or keyboard input.
+ at TeX{} compiles a document in one of four modes. In @dfn{errorstop
+mode} (the default), @TeX{} stops at each error and asks for user
+intervention. In @dfn{batch mode} it prints nothing on the terminal,
+errors are scrolled as if the user hit @code{<return>} at every error,
+and missing files cause the job to abort. In @dfn{nonstop mode}
+diagnostic message appear on the terminal but as in batch mode there is
+no user interaction. In @dfn{scroll mode} @TeX{} only stops for missing
+files or keyboard input.
For instance, starting @LaTeX{} with the command line @code{pdflatex
-interaction=batchmode @var{filename}} eliminates most command line
-output.https://tex.stackexchange.com/a/128190/121234
+output.
+ at findex --jobname @r{command-line option}
@item jobname=@var{string}
-Set the value of @TeX{}'s @code{jobname} to the string. The most
-obvious effect of this is that the output file will then be
+Set the value of @TeX{}'s @code{jobname} to the string. The log file
+and output file will then be named @file{@var{string}.log} and
@file{@var{string}.pdf}.
When you run @code{@command{pdflatex} @var{options} @var{argument}}, if
@var{argument} does not start with a backslash then @TeX{} considers it
-the name of a tile inputs that file. Otherwise @command{pdflatex} waits
-for the first @code{\input} instruction and the name of the input file
-will be the job name, used for name of the log file and the output file.
-This option short-circuits that process and directly specifies the name.
- at xref{Command line input} for an example of its use.
+the name of a file to input. Otherwise it waits for the first
+ at code{\input} instruction and the name of the input file will be the job
+name. This is used to name the log file the output file. This option
+overrides that process and directly specifies the name. @xref{Command
+line input} for an example of its use.
+ at findex --output-directory @r{command-line option}
@item output-directory=@var{directory}
-Use the existing directory @var{directory} to write files in.
+Write files in the directory @var{directory}. It must already exist.
+ at findex --shell-escape @r{command-line option}
+ at findex --no-shell-escape @r{command-line option}
+ at findex --enable-write18 @r{command-line option}
+ at findex --disable-write18 @r{command-line option}
@item shell-escape
@itemx no-shell-escape
@itemx enable-write18
@itemx disable-write18
Enable or disable @code{\write18@{@var{shell command}@}}. The first two
-are available with @TeX{} Live or Mac at TeX{} while the second two come
-with MiK at TeX{}.
+options are for with @TeX{} Live or Mac at TeX{} while the second two are
+for MiK at TeX{}.
@PkgIndex{sagetex}
Sometimes you want to run external system commands from inside a
@@ -17695,16 +17684,19 @@
But with this functionality enabled, security issues could happen if you
compiled a @LaTeX{} file from the Internet. By default @code{\write18}
is disabled. (More precisely, by default @TeX{} Live, Mac at TeX{}, and
-MiK at TeX{} allow the execution of a limited number of @TeX{}-related
+MiK at TeX{} only allow the execution of a limited number of @TeX{}-related
programs, which they distribute.)
-If you call @code{\write18@{ls -l@}} with the option
- at code{no-shell-escape} then you do not get an error, but the log file
-says @samp{runsystem(ls -l)...disabled}.
+If you invoke @LaTeX{} with the option @code{no-shell-escape}, and in
+your document you call @code{\write18@{ls -l@}}, then you do not get an
+error but the log file says @samp{runsystem(ls -l)...disabled}.
+ at findex --halt-on-error @r{command-line option}
@item halt-on-error
Stop processing at the first error.
+ at findex --file-line-error @r{command-line option}
+ at findex --no-file-line-error @r{command-line option}
@item file-line-error
@item no-file-line-error
Enable or disable @code{@var{filename}:@var{lineno}:@var{error}}-style
@@ -17715,31 +17707,114 @@
@node Command line input
@section Command line input
-As part of the command line invocation of @LaTeX{} you can also specify
-arbitrary input by starting with a backslash. For example,
-this loads the package @file{graphicx} with the option @code{draft}.
+As part of the command line invocation @code{pdflatex @var{options}
+ at var{argument}} you can specify arbitrary input by starting
+ at var{argument} with a backslash. This allows you to do some special
+effects.
+ at PkgIndex{hyperref}
+For example, this file (which uses the @file{hyperref} package for
+hyperlinks) can produce two kinds of output, one for paper and one for a
+PDF.
+
@example
+\ifdefined\paperversion % in preamble
+\newcommand@{\urlcolor@}@{black@}
+\else
+\newcommand@{\urlcolor@}@{blue@}
+\fi
+\usepackage[colorlinks=true,urlcolor=\urlcolor]@{hyperref@}
+ ...
+\href@{https://www.ctan.org@}@{CTAN@} % in body
+ ...
+ at end example
+
+ at noindent
+Compiling this document @file{book.tex} with the command line
+ at code{pdflatex test} will give the @samp{CTAN} link in blue. But
+compiling it with @code{pdflatex "\def\paperversion@{@}\input test.tex"}
+has the link in black. (Note the use of double quotes to prevent
+interpretation of the symbols by the command line shell; your system may
+do this differently.)
+
+In a similar way, from the single file @file{main.tex} you can compile
+two different versions.
+
+ at c credit Paul Gaborit: https://tex.stackexchange.com/a/220101/121234
+ at example
+pdflatex -jobname=students "\def\student@{@}\input@{main@}"
+pdflatex -jobname=teachers "\def\teachers@{@}\input@{main@}"
+ at end example
+
+ at noindent
+The @code{jobname} option is there because otherwise both files would be
+called @file{main.pdf} and the second would overwrite the first.
+
+A final example. This loads the package @file{graphicx} with the option
+ at code{draft}
+
+ at c credit Herbert Voss: https://tex.stackexchange.com/a/17236/121234
+ at example
pdflatex -jobname=myfile "\RequirePackage[draft]@{graphicx@} \input@{myfile.tex@}"
@end example
@noindent
-The graphic files are read for their size information, but not incorporated
-into the PDF.
+so the graphic files are read for their size information but not
+incorporated into the PDF. (The @code{jobname} option is needed because
+otherwise the output file would be @file{graphicx.pdf}, as
+ at code{\RequirePackage} does an @code{\input} of its own.)
@node Recovering from errors
@section Recovering from errors
+If @LaTeX{} finds an error in your document then it gives you an error
+message and prompts you with a question mark, @code{?}. For instance,
+running @LaTeX{} on this file
+
+ at example
+\newcommand@{\NP@}@{\ensuremath@{\textbf@{NP@}@}@}
+The \PN@{@} problem is a million dollar one.
+ at end example
+
+causes it show this, and wait for input.
+
+ at example
+! Undefined control sequence.
+l.5 The \PN
+ @{@} problem is a million dollar one.
+?
+ at end example
+
+ at noindent
+The simplest thing is to enter @samp{x} and @code{<return>} and fix the
+typo. You could instead enter @samp{?} and @code{<return>} to see other
+options.
+
@cindex @samp{*} prompt
@cindex prompt, @samp{*}
@findex \stop
-If @LaTeX{} stops in the middle of the document and gives you a
- at samp{*} prompt, it is waiting for input. You can type @code{\stop}
-(and return) and it will prematurely end the document.
+There are two other error scenarios. The first is that you forgot to
+include the @code{\end@{document@}} or misspelled it. In this case
+ at LaTeX{} gives you a @samp{*} prompt. You can get back to the command
+line by typing @code{\stop} and @code{<return>}.
+The last scenario is that you mistyped the file name. For instance,
+instead of @code{pdflatex test} you might type @code{pdflatex tste}.
+ at example
+! I can't find file `tste'.
+<*> tste
+
+(Press Enter to retry, or Control-D to exit)
+Please type another input file name:
+ at end example
+ at noindent
+The simplest thing is to enter @code{<Contol>} and @samp{d} (holding
+them down at the same time), and just fix the command line.
+
+
@node Document templates
@appendix Document templates
More information about the latexrefman-commits
mailing list