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

[karl at gnu.org.ua]

Author: karl
Date: 2020-03-14 23:14:13 +0200 (Sat, 14 Mar 2020)
New Revision: 759

Modified:
   trunk/ChangeLog
   trunk/latex2e.texi
Log:
\read exception for non-interactive jobs; \jobname is not current filename; other tweaks

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2020-03-11 22:52:27 UTC (rev 758)
+++ trunk/ChangeLog	2020-03-14 21:14:13 UTC (rev 759)
@@ -1,3 +1,10 @@
+2020-03-14  Karl Berry  <karl at freefriends.org>
+
+	* latex2e.texi (\read): exception for non-interactive jobs.
+	(interaction modes): new anchor.
+	Some "file name" -> "filename".
+	Todo: non-ASCII \write; \nonstopmode etc.
+
 2020-03-11  Karl Berry  <karl at freefriends.org>
 
 	* latex2e.texi (output directory): new anchor, for the

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2020-03-11 22:52:27 UTC (rev 758)
+++ trunk/latex2e.texi	2020-03-14 21:14:13 UTC (rev 759)
@@ -18,6 +18,8 @@
 @c xx merge permuted-index
 @c xx merge latex-manual from savannah
 @c xx merge display style math
+ at c xx \write of non-ASCII chars (vincent mail of 14 Mar 2020 21:39:41)
+ at c xx \nonstopmode etc., if they are officially supported by LaTeX?
 @c xx JH explain nfss somewhere
 @c xx JH expand BiBTeX
 @c xx JH expand theorem, AMS math
@@ -1121,8 +1123,8 @@
 @end enumerate
 
 
- at item \IfFileExists@{@var{file name}@}@{@var{true code}@}@{@var{false code}@}
- at item \InputIfFileExists@{@var{file name}@}@{@var{true code}@}@{@var{false code}@}
+ at item \IfFileExists@{@var{filename}@}@{@var{true code}@}@{@var{false code}@}
+ at item \InputIfFileExists@{@var{filename}@}@{@var{true code}@}@{@var{false code}@}
 @findex \IfFileExists
 @findex \InputIfFileExists
 Execute @var{true code} if @LaTeX{} finds the file @file{@var{file
@@ -1343,12 +1345,12 @@
 than the given date.  (Although, in practice package users only rarely
 include a date, and class users almost never do.)
 
- at item \ProvidesFile@{@var{file name}@}[@var{additional information}]
+ at item \ProvidesFile@{@var{filename}@}[@var{additional information}]
 @findex \ProvidesFile
 Declare a file other than the main class and package files, such as
 configuration files or font definition files.  Put this command in that
 file and you get in the log a string like @code{File: test.config
-2017/10/12 config file for test.cls} for @var{file name} equal to
+2017/10/12 config file for test.cls} for @var{filename} equal to
 @samp{test.config} and @var{additional information} equal to
 @samp{2017/10/12 config file for test.cls}.
 
@@ -16101,7 +16103,7 @@
 @code{\includegraphics} command).
 
 @item draft
-For each graphic file, it is not shown but instead the file name is
+For each graphic file, it is not shown but instead its file name is
 printed in a box of the correct size.  In order to determine the size,
 the file must be present.
 
@@ -16211,7 +16213,7 @@
 
 @noindent
 for each of the listed directories, @LaTeX{} concatenates it with the
-file name and searches for the result, checking for @file{pix/lion.png}
+filename and searches for the result, checking for @file{pix/lion.png}
 and then @file{../pix/lion.png}.  This algorithm means that the
 @code{\graphicspath} command does not recursively search subdirectories:
 if you issue @code{\graphicspath@{@{a/@}@}} and the graphic is in
@@ -16261,7 +16263,7 @@
 @end example
 
 @noindent
-Because the file name @file{lion} does not have a period, @LaTeX{} uses
+Because the filename @file{lion} does not have a period, @LaTeX{} uses
 the extension list.  For each directory in the graphics path
 (@pxref{\graphicspath}), @LaTeX{} will try the extensions in the order
 given.  If it does not find such a file after trying all the directories
@@ -19592,17 +19594,20 @@
 \closein\recipientfile
 @end example
 
-If @var{number} is outside the range from 0 to at tie{}15 or if no file of
-that number is open, or if the file has ended, then @code{\read} will
-take input from the terminal.  Note, though, that the natural way in
- at LaTeX{} to take input from the terminal is @code{\typein}
-(@pxref{\typein}).
+If @var{number} is outside the range from 0 to at tie{}15 or if no file
+of that number is open, or if the file has ended, then @code{\read}
+will take input from the terminal (or exit if interaction is not
+allowed, e.g., @code{\nonstopmode}; @pxref{interaction modes}).
+(However, the natural way in @LaTeX{} to take input from the terminal
+is @code{\typein} (@pxref{\typein}.)
 
-To read in an entire file at once use @code{\input} (@pxref{\input}) or
- at code{\include} (@pxref{\include & \includeonly}).
+To read an entire file as additional @LaTeX{} source, use
+ at code{\input} (@pxref{\input}) or @code{\include} (@pxref{\include &
+\includeonly}).
 
 @PkgIndex{datatool}
-A common reason to want to read from a data file is to do mail merge.
+ at cindex mail merges
+A common reason to want to read from a data file is to do mail merges.
 CTAN has a number of packages for that; one is @file{datatool}.
 
 
@@ -19731,9 +19736,10 @@
 @file{@var{basefile}.jh}, writes @samp{Hello World!} and a newline to
 it, and closes that file.
 
+ at findex \jobname
 @example
 \newwrite\myfile
-\immediate\openout\myfile=\jobname.jh   % \jobname is current file name
+\immediate\openout\myfile=\jobname.jh   % \jobname is the main filename
   ...
 \immediate\write\myfile@{Hello world!@}
   ...
@@ -19894,10 +19900,10 @@
 the end of line following @samp{I@}}).
 
 While @code{\message} allows you more control over formatting
-interaction lines, a gotcha is that @LaTeX{} may mess up your formatting
-because it inserts line breaks depending on what it has already put
-out. Contrast this document body, where the @samp{Two} has moved, to the
-one given above.
+interaction lines, a gotcha is that @LaTeX{} may mess up your
+formatting because it inserts line breaks depending on what it has
+already written. Contrast this document body, where the @samp{Two} has
+moved, to the one given above.
 
 @example
 before\message@{One@}\message@{Two Three@}\message@{Four^^JI@}
@@ -20114,6 +20120,7 @@
 @item -help
 Give a brief usage message that is useful as a prompt and exit.
 
+ at anchor{interaction modes}
 @findex --interaction @r{command-line option}
 @item -interaction=@var{mode}
 @TeX{} compiles a document in one of four interaction modes:
@@ -20310,7 +20317,7 @@
 @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,
+The last scenario is that you mistyped the filename.  For instance,
 instead of @code{pdflatex test} you might type @code{pdflatex tste}.
 
 @example