[latexrefman-commits] [SCM] latexrefman updated: r669 - trunk
karl at gnu.org.ua
karl at gnu.org.ua
Sat Jun 30 00:24:18 CEST 2018
Author: karl
Date: 2018-06-30 01:24:18 +0300 (Sat, 30 Jun 2018)
New Revision: 669
Modified:
trunk/ChangeLog
trunk/aspell.en.pws
trunk/common.texi
trunk/latex2e.texi
Log:
command line -options
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2018-06-29 20:11:54 UTC (rev 668)
+++ trunk/ChangeLog 2018-06-29 22:24:18 UTC (rev 669)
@@ -1,6 +1,18 @@
+2018-06-29 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (Command line options) <-interaction>: use metavar
+ to avoid overfull box in index. Use - for printed output, and no
+ @ftable.
+ (common.texi): minimize url.
+
+2018-06-28 Karl Berry <karl at freefriends.org>
+
+ * latex2e.texi (Command line): both - and -- work in TL,
+ and, I hope, in MiKTeX.
+
2018-06-29 Jim Hefferon <jhefferon at smcvt.edu>
- * latex2e.texi (Many sections) Uner- and under-full lines in PDF
+ * latex2e.texi (Many sections) Under- and under-full lines in PDF
are gone.
2018-06-29 Jim Hefferon <jhefferon at smcvt.edu>
Modified: trunk/aspell.en.pws
===================================================================
--- trunk/aspell.en.pws 2018-06-29 20:11:54 UTC (rev 668)
+++ trunk/aspell.en.pws 2018-06-29 22:24:18 UTC (rev 669)
@@ -56,6 +56,7 @@
eng
env
envlab
+errorstop
errorstopmode
eth
executivepaper
Modified: trunk/common.texi
===================================================================
--- trunk/common.texi 2018-06-29 20:11:54 UTC (rev 668)
+++ trunk/common.texi 2018-06-29 22:24:18 UTC (rev 669)
@@ -1,16 +1,18 @@
- at set LTXREFMAN_HOME_PAGE http://puszcza.gnu.org.ua/software/latexrefman/
- at set LTXREFMAN_BUGS latexrefman@@tug.org
- at clear HAS-MATH
- at iftex
- at set HAS-MATH
- at macro iftexthenelse {then,else}
-\then\@c
- at end macro
- at end iftex
- at ifnottex
- at macro iftexthenelse {then,else}
-\else\@c
- at end macro
- at end ifnottex
-
-
+ at c $Id$
+ at c Public domain.
+ at set LTXREFMAN_HOME_PAGE puszcza.gnu.org.ua/software/latexrefman
+ at set LTXREFMAN_BUGS latexrefman@@tug.org
+ at clear HAS-MATH
+ at iftex
+ at set HAS-MATH
+ at macro iftexthenelse {then,else}
+\then\@c
+ at end macro
+ at end iftex
+ at ifnottex
+ at macro iftexthenelse {then,else}
+\else\@c
+ at end macro
+ at end ifnottex
+
+
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2018-06-29 20:11:54 UTC (rev 668)
+++ trunk/latex2e.texi 2018-06-29 22:24:18 UTC (rev 669)
@@ -177,7 +177,7 @@
@node About this document
@chapter About this document
- at findex @url{@value{LTXREFMAN_HOME_PAGE}} @r{home page}
+ at cindex home page for manual
This is an unofficial reference manual for the @LaTeX{}2e document
preparation system, which is a macro package for the @TeX{}
typesetting program (@pxref{Overview}). This document's home page is
@@ -10044,7 +10044,7 @@
@end example
@noindent
-The only differnece is that with the @code{equation} environment,
+The only difference is that with the @code{equation} environment,
@LaTeX{} puts a formula number alongside the formula, which by default
has the form @samp{(@var{arabic number})}. The construct @code{\[
@var{math} \]} is equivalent to @code{\begin@{displaymath@} @var{math}
@@ -17757,12 +17757,13 @@
or @code{dvilualatex}, then you will get DVI. The description here
assumes pdf at LaTeX{}.
- at xref{Command line options} for a selection of the most useful command
-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}).
+ at xref{Command line options}, for a selection of the most useful
+command 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 you gave no arguments or options then @command{pdflatex} prompts for
input from the terminal. You can escape from this by entering
@@ -17782,34 +17783,40 @@
@node Command line options
@section Command line options
-These are the options relevant to ordinary document authoring. For a
-full list, try the command line command @samp{latex --help}.
+ at cindex options, command line
+These are the command-line options relevant to ordinary document
+authoring. For a full list, try running @samp{latex --help} from the
+command line.
+
With many implementations you can specify command line options by
-prefixing them with @samp{-} or @samp{--}. This is the case for
-both @TeX{} Live and Mac at TeX{}, and MiK at TeX{}.
+prefixing them with @samp{-} or @samp{--}. This is the case for
+both @TeX{} Live (and Mac at TeX{}) and MiK at TeX{}. We will use both
+conventions interchangeably.
- at ftable @code
+ at table @code
@findex --version @r{command-line option}
- at item version
+ at 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,
and exit.
@findex --help @r{command-line option}
- at item help
+ at item -help
Give a brief usage message that is useful as a prompt and exit.
@findex --interaction @r{command-line option}
- at item interaction=[batchmode|nonstopmode|scrollmode|errorstopmode]
- 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.
+ at item -interaction=@var{mode}
+ at TeX{} compiles a document in one of four interaction modes:
+ at code{batchmode}, @code{nonstopmode}, @code{scrollmode},
+ at code{errorstopmode}. 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
+ at dfn{scroll mode}, @TeX{} only stops for missing files or keyboard
+input.
For instance, starting @LaTeX{} with this command line
@@ -17818,10 +17825,10 @@
@end example
@noindent
-eliminates most command line output.
+eliminates most terminal output.
@findex --jobname @r{command-line option}
- at item jobname=@var{string}
+ at item -jobname=@var{string}
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}.
@@ -17835,7 +17842,7 @@
line input} for an example of its use.
@findex --output-directory @r{command-line option}
- at item output-directory=@var{directory}
+ at item -output-directory=@var{directory}
Write files in the directory @var{directory}. It must already exist.
@findex --shell-escape @r{command-line option}
@@ -17868,24 +17875,26 @@
error but the log file says @samp{runsystem(ls -l)...disabled}.
@findex --halt-on-error @r{command-line option}
- at item halt-on-error
+ at item -halt-on-error
Stop processing at the first error.
@findex --file-line-error @r{command-line option}
@findex --no-file-line-error @r{command-line option}
- at item file-line-error
- at item no-file-line-error
+ at item -file-line-error
+ at item -no-file-line-error
Enable or disable @code{@var{filename}:@var{lineno}:@var{error}}-style
error messages. These are only available with @TeX{} Live or Mac at TeX{}.
- at end ftable
+ at end table
@node Command line input
@section Command line input
+ at cindex input, on command line
+
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
+ at var{argument}} you can specify arbitrary @LaTeX{} input by starting
+ at var{argument} with a backslash. This allows you to do some special
effects.
@PkgIndex{hyperref}
More information about the latexrefman-commits
mailing list