[latexrefman-commits] [SCM] latexrefman updated: r846 - trunk

[karl at gnu.org.ua]

Author: karl
Date: 2020-11-30 04:08:39 +0200 (Mon, 30 Nov 2020)
New Revision: 846

Modified:
   trunk/ChangeLog
   trunk/aspell.en.pws
   trunk/latex2e.texi
Log:
command line --option=value description

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2020-11-30 01:57:18 UTC (rev 845)
+++ trunk/ChangeLog	2020-11-30 02:08:39 UTC (rev 846)
@@ -2,6 +2,12 @@
 
 	* latex2e.texi (\write18): mention the shellesc package.
 	Suggestion from Pablo Gonzalez L, 28 Nov 2020 20:31:49.
+	
+	(Command line interface): rename node from "Command line";
+	leave anchor behind. Reword extension description.
+	(Command line options): mention that option values can be
+	given either as separate arguments or with =.
+	Suggestion from Pablo Gonzalez L, 28 Nov 2020 20:49:00.
 
 2020-11-26  Karl Berry  <karl at freefriends.org>
 

Modified: trunk/aspell.en.pws
===================================================================
--- trunk/aspell.en.pws	2020-11-30 01:57:18 UTC (rev 845)
+++ trunk/aspell.en.pws	2020-11-30 02:08:39 UTC (rev 846)
@@ -266,3 +266,4 @@
 scrollmode
 grfext
 shellesc
+CLI

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2020-11-30 01:57:18 UTC (rev 845)
+++ trunk/latex2e.texi	2020-11-30 02:08:39 UTC (rev 846)
@@ -2,7 +2,7 @@
 @c $Id$
 @comment %**start of header (This is for running Texinfo on a region.)
 @setfilename latex2e.info
- at set UPDATED September 2020
+ at set UPDATED November 2020
 @include common.texi
 @settitle @LaTeX{}2e unofficial reference manual (@value{UPDATED})
 @comment %**end of header (This is for running Texinfo on a region.)
@@ -177,7 +177,7 @@
 * Front/back matter::		Tables of contents, glossaries, indexes.
 * Letters::			The @code{letter} class.
 * Input/output::        	User interaction.
-* Command line::                System-independent command-line behavior.
+* Command line interface::      Common command-line options.
 * Document templates::          Starter templates for various document classes.
 * Index::		        General index.
 @end menu
@@ -20257,10 +20257,12 @@
 same reason.
 
 
- at node Command line
- at chapter Command line
+ at node Command line interface
+ at chapter Command line interface
 
+ at anchor{Command line}@c old name
 @cindex command line
+ at cindex CLI
 
 Synopsis (from a terminal command line):
 
@@ -20283,17 +20285,18 @@
 @findex .tex, @r{default extension}
 Note that @file{.tex} is the default file name extension.
 
-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{}.
+pdf at TeX{} is an extension of the original @TeX{} program, as are
+Xe at TeX{} and Lua at TeX{} (@pxref{@TeX{} engines}).  The first two are
+completely backward compatible and the latter, almost so.  Perhaps the
+most fundamental new feature for all three is that the original @TeX{}
+output its own DVI format, 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
+ at command{pdflatex} or @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{}.
 
 @xref{Command line options}, for a selection of the most useful
 command line options. As to @var{argument}, the usual case is that it
@@ -20330,7 +20333,10 @@
 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{}.  We will use both
-conventions interchangeably.
+conventions interchangeably.  If an option takes a value, it can be
+specified either as a separate argument (@samp{--foo val}), or as one
+argument with an @samp{=} sign (@samp{--foo=val}), but there can be no
+spaces around the @samp{=}. We will generally use the @samp{=} syntax.
 
 @table @code
 @findex --version @r{command-line option}