From eaea0d35a703f47bc759ec85ecc1533c8aacc404 Mon Sep 17 00:00:00 2001
From: Karl Berry
Date: Fri, 13 Mar 2020 17:38:53 +0000
Subject: texinfo manual updates for 2020
git-svn-id: svn://tug.org/texlive/trunk@54279 c570f23f-e606-0410-a88d-b1316a301751
---
Master/texmf-dist/doc/web2c/web2c.html | 270 +++++++++++++++++++++++----------
Master/texmf-dist/doc/web2c/web2c.pdf | Bin 464712 -> 469172 bytes
2 files changed, 188 insertions(+), 82 deletions(-)
(limited to 'Master/texmf-dist/doc/web2c')
diff --git a/Master/texmf-dist/doc/web2c/web2c.html b/Master/texmf-dist/doc/web2c/web2c.html
index 7d2c557a111..4ef7146223a 100644
--- a/Master/texmf-dist/doc/web2c/web2c.html
+++ b/Master/texmf-dist/doc/web2c/web2c.html
@@ -4,7 +4,7 @@
an implementation of Donald Knuth's TeX system.
Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
-2004, 2005, 2007, 2008, 2009 Karl Berry & Olaf Weber.
+2004, 2005, 2007, 2008, 2009, 2010-2020 Karl Berry & Olaf Weber.
Permission is granted to make and distribute verbatim copies of this
manual provided the copyright notice and this permission notice are
@@ -19,7 +19,7 @@ permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual
into another language, under the above conditions for modified versions,
except that this permission notice may be stated in a translation -->
-
+
Web2c: A TeX implementation
@@ -97,7 +97,12 @@ ul.no-bullet {list-style: none}
3.5.2.3 Hardware and memory dumps
3.5.3 Editor invocation
- 3.5.4 \input
filenames
+ 3.5.4 \input
filenames
+
4 TeX: Typesetting
@@ -168,7 +173,7 @@ ul.no-bullet {list-style: none}
Appendix A Legalisms
Appendix B References
- Index
+ Index
@@ -181,8 +186,8 @@ Next: Introduction, Up: This document describes how to install and use the programs in the Web2c
implementation of the TeX system, especially for Unix systems. It
-corresponds to Web2c version 2019, released in
-February 2019.
+corresponds to Web2c version 2020, released in
+March 2020.
@@ -223,8 +228,8 @@ Next: Installation, Previou
-This manual corresponds to version 2019 of Web2c, released in
-February 2019.
+
This manual corresponds to version 2020 of Web2c, released in
+March 2020.
@@ -1038,7 +1043,7 @@ control some array sizes and other features are described in
• Editor invocation | | The ‘e’ response at errors.
|
-• \input filenames | | ~ and $ expansion in TeX/MF/MP.
+ |
• \input filenames | | Filename delimiters and Kpathsea expansion.
|
@@ -1345,9 +1350,49 @@ Metafont and MetaPost, the statement terminator ‘;’ als
\input
that allow different notation; here we are concerned only
with the primitive operation.)
-As of Web2c version 7.5.3, double-quote characters can be used to
-include spaces or other special cases. In typical use, the ‘"’
-characters surround the entire filename:
+
As (allowed) extensions to standard TeX, Web2c also supports
+specifying the filename in double quotes ("some name"
) and in
+braces ({"some name"}
), which is convenient for filenames
+containing spaces or other special characters, as described in the
+sections below.
+
+In all cases, space tokens are ignored after the filename is read.
+
+
+
+Also, double quote ("
) characters are ignored within the
+filename; there is no way to read files whose names contain a "
.
+
+
+However, for maximal portability of your document across systems, use
+only the characters ‘a’–‘z’, ‘0’–‘9’, and
+‘.’. Do not use anything but simple filenames, since directory
+separators vary among systems; instead, add the necessary directories
+to the appropriate search path.
+
+
+
+
+
+
+3.5.4.1 \input
quoted filename: \input "some name"
+
+
+
+
+As of Web2c version 7.5.3 (2004), double-quote characters can be used
+to include spaces or other special characters. In typical use, the
+‘"’ characters surround the entire filename:
\input "filename with spaces"
@@ -1358,16 +1403,65 @@ can enclose any characters, as in:
\input filename" "with" "spaces
-One more point. In LaTeX, the quotes are needed inside the braces, thus
+
One more point. In LaTeX, the quotes are needed inside the braces
+of its \input
macro, thus:
\input{a b} % fails
\input{"a b"} % ok
-This quoting mechanism comes into play after TeX has
-tokenized and expanded the input. So, multiple spaces and tabs may be
-seen as a single space, active characters such as ‘~’ are
-expanded first, and so on. (See below.)
+
There is no way to quote the quote character.
+
+
+
+
+3.5.4.2 \input
braced filename: \input{some name}
+
+
+
+
+
+As of Web2c 2020, \input
filenames in TeX engines (this does
+not apply in Metafont and MetaPost) can also be specified within a
+TeX group, typically curly braces. For example:
+
+
\input{filename with spaces}
+
+
+As always with TeX, the brace characters are not hardwired; what
+counts is the category code: the first token after the \input
+must be of catcode 1 (begin group), and it is matched with the
+next character of catcode 2 (end group).
+
+Within the group-delimited filename, braces are treated as normal
+characters.
+
+As with all forms of filenames, following spaces are ignored (after
+the end group), and double quote ("
) characters are ignored
+within the filename.
+
+
+
+
+3.5.4.3 \input
filename caveats
+
+
+
+
+
+
+
+The quoting mechanisms just described come into play after
+TeX has tokenized and expanded the input. So, multiple spaces and
+tabs will generally be seen as a single space, active characters such
+as ‘~’ are expanded first (generally causing an error), and so
+on. More examples below.
@@ -1376,42 +1470,29 @@ expanded first, and so on. (See below.)
byte (character code zero, ASCII NUL) to terminate strings. So
filenames in Web2c cannot contain nulls, even though TeX itself does
not treat NUL specially.
-In addition, some older Unix variants do not allow eight-bit characters
-(codes 128–255) in filenames.
-
-
-For maximal portability of your document across systems, use only the
-characters ‘a’–‘z’, ‘0’–‘9’, and ‘.’, and
-restrict your filenames to at most eight characters (not including the
-extension), and at most a three-character extension. Do not use
-anything but simple filenames, since directory separators vary among
-systems; instead, add the necessary directories to the appropriate
-search path.
Finally, the present Web2c implementation does ‘~’ and ‘$’
-expansion on name, unlike Knuth’s original implementation and
-older versions of Web2c. Thus:
+expansion on name, unlike Knuth’s original implementation.
+Thus:
-will dereference the environment variable or Kpathsea config file value
-‘foo’ and read that file extended with ‘.bar’ in user
-‘jsmith’’s home directory. You can also use braces, as in
-‘${foo}bar’, if you want to follow the variable name with a letter,
-numeral, or ‘_’.
+
will dereference the environment variable or Kpathsea config file
+value ‘foo’ and read that file, extended with ‘.bar’, in
+user ‘jsmith’’s home directory. You can also use braces in the
+variable expansion, as in ‘${foo}bar’, if you want to follow
+the variable name with a letter, numeral, or ‘_’.
(So another way to get a program to read a filename containing
whitespace is to define an environment variable and dereference it.)
-
-In all the common TeX formats (plain TeX, LaTeX, AMSTeX),
-the characters ‘~’ and ‘$’ have special category codes, so to
-actually use these in a document you have to change their catcodes or
-use \string
. (The result is unportable anyway, see the
-suggestions above.) The place where they are most likely to be useful
-is when typing interactively.
+
+
In all the common TeX formats (plain TeX, LaTeX, ConTeXt,
+AMSTeX, …), the characters ‘~’ and ‘$’ have special
+category codes, so to actually use these in a document you have to
+change their catcodes or use \string
.
@@ -2239,11 +2320,11 @@ the log file.
The shell_escape_commands
value is a comma-separated list of
words. Whitespace is significant, and typically should not be
-present. The default definition looks like this, but with more
-commands included:
+present. The default definition in texmf.cnf looks like this,
+but with more commands included:
-
shell_escape_commands = bibtex,dvips,epstopdf,...,tex
+shell_escape_commands = bibtex,kpsewhich,repstopdf,...
@@ -5074,25 +5155,27 @@ Previous: References, Up:
Index
-Jump to: | #
+Jump to: | "
+
+#
-$
+$
-%
+%
--
+-
-.
+.
-2
+2
-8
+8
-\
+\
-^
+^
-~
+~
A
@@ -5127,6 +5210,8 @@ Previous: References, Up: P
+Q
+
R
S
@@ -5147,16 +5232,19 @@ Previous: References, Up:
| Index Entry | | Section |
|
-# | | |
+" | | |
+ | " character, ignored in filenames: | | \input filenames |
+
|
+# | | |
| ‘#define’ options: | | Compile-time options |
|
-$ | | |
- | $ expansion in filenames : | | \input filenames |
+$ | | |
+ | $ expansion in filenames : | | \input filename caveats |
|
-% | | |
+% | | |
| %& magic number : | | Determining the memory dump to use |
|
-- | | |
+- | | |
| - starting a filename : | | Option conventions |
| - starts option names : | | Option conventions |
| -- starts option names : | | Option conventions |
@@ -5246,7 +5334,7 @@ Previous: References, Up: | | -uppercase : | | tangle invocation |
| -x : | | weave invocation |
|
-. | | |
+. | | |
| ., used for output : | | Output file location |
| .2602gf : | | mf invocation |
| .aux cross-reference files : | | bibtex invocation |
@@ -5268,15 +5356,15 @@ Previous: References, Up: | .Xdefaults : | | Online Metafont graphics |
| .Xresources : | | Online Metafont graphics |
|
-2 | | |
+2 | | |
| 2602gf : | | mf invocation |
|
-8 | | |
+8 | | |
| 8 bit clean: | | Common options |
| 8 bit clean output, specifying : | | Common options |
| 8-bit characters: | | TCX files |
|
-\ | | |
+\ | | |
| \bibliography : | | bibtex invocation |
| \bibliographystyle : | | bibtex invocation |
| \charsubdef and MLTeX : | | \charsubdef |
@@ -5285,7 +5373,10 @@ Previous: References, Up: | \font and dynamic generation : | | tex invocation |
| \fontdimen : | | tftopl invocation |
| \immediate\write18 : | | Shell escapes |
+ | \input braced (grouped) filename: | | \input braced filename |
+ | \input filename caveats: | | \input filename caveats |
| \input filenames : | | \input filenames |
+ | \input quoted filename: | | \input quoted filename |
| \input, and pipes : | | Shell escapes |
| \mag : | | dvicopy invocation |
| \mag : | | dvitype invocation |
@@ -5294,16 +5385,16 @@ Previous: References, Up: | \openout, and pipes : | | Shell escapes |
| \output routine, and \write : | | Shell escapes |
| \pdfshellescape : | | Shell escapes |
- | \string : | | \input filenames |
+ | \string, and \input filenames : | | \input filename caveats |
| \tracingcharsubdef and MLTeX : | | \tracingcharsubdef |
| \tracinglostchars and MLTeX : | | \tracingcharsubdef |
| \write18 shell escape extension : | | Shell escapes |
|
-^ | | |
+^ | | |
| ^^ notation, avoiding : | | TCX files |
|
-~ | | |
- | ~ expansion in filenames : | | \input filenames |
+~ | | |
+ | ~ expansion in filenames : | | \input filename caveats |
|
A | | |
| abbrv.bst : | | Basic BibTeX style files |
@@ -5354,6 +5445,7 @@ Previous: References, Up: | binaries, linking: | | Common options |
| blank lines, in TCX files: | | TCX files |
| boxes, memory for: | | Runtime options |
+ | braced filename for \input : | | \input braced filename |
| breakpoints, memory for: | | Runtime options |
| Breitenlohner, Peter: | | Introduction |
| BSTINPUTS, search path for bst files : | | bibtex invocation |
@@ -5367,6 +5459,7 @@ Previous: References, Up:
|
C | | |
| c-sources Makefile target : | | Additional targets |
+ | caveats for \input filenames: | | \input filename caveats |
| change files, and MFT: | | mft invocation |
| change files, and Tangle: | | tangle invocation |
| change files, and Weave: | | weave invocation |
@@ -5438,6 +5531,7 @@ Previous: References, Up: | directory structure: | | Installation |
| DISPLAY : | | Online Metafont graphics |
| dot files, written by TeX programs: | | tex invocation |
+ | double quote character, ignored in filenames: | | \input filenames |
| downloading of fonts for MetaPost labels: | | mpost invocation |
| DrawingServant : | | Online Metafont graphics |
| dump file: | | Common options |
@@ -5469,7 +5563,7 @@ Previous: References, Up: | EC fonts: | | mf invocation |
| editing of bitmap fonts: | | Font utilities available elsewhere |
| editor invoked at error: | | Editor invocation |
- | eight-bit characters in filenames: | | \input filenames |
+ | eight-bit characters in filenames: | | \input filename caveats |
| empty.tcx : | | TCX files |
| endian dependencies: | | Hardware and memory dumps |
| eoc GF command : | | gftype invocation |
@@ -5483,6 +5577,7 @@ Previous: References, Up: | executables, shared initial and virgin: | | Initial and virgin |
| exit status, of shell escape: | | Shell escapes |
| expanded plain format: | | Formats |
+ | expansion, and \input filenames: | | \input filename caveats |
| extensions to TeX: | | TeX extensions |
| extra_mem_bot : | | Runtime options |
|
@@ -5547,6 +5642,7 @@ Previous: References, Up: | glue, memory for: | | Runtime options |
| glyph substitutions: | | MLTeX |
| gray font: | | gftodvi invocation |
+ | group-delimited filename for \input : | | \input braced filename |
| Gruff, Billy Goat: | | Triptrap |
| gsftopk : | | Font utilities available elsewhere |
|
@@ -5662,7 +5758,7 @@ Previous: References, Up: | memory dumps, contain date and time: | | Hardware and memory dumps |
| memory dumps, creating: | | Creating memory dumps |
| mems Make target : | | Additional targets |
- | meta characters in filenames: | | \input filenames |
+ | meta characters in filenames: | | \input filename caveats |
| Metafont: | | Metafont |
| Metafont geometry: | | Online Metafont graphics |
| Metafont graphics: | | Online Metafont graphics |
@@ -5715,6 +5811,7 @@ Previous: References, Up: | mptrap.readme : | | Triptrap |
| MPX files, converting from DVI files: | | dvitomp invocation |
| Multi-lingual TeX: | | MLTeX |
+ | multiple spaces, and \input filenames: | | \input filename caveats |
|
N | | |
| N tilde: | | \charsubdef |
@@ -5724,7 +5821,7 @@ Previous: References, Up: | non-Unix system, compiling on: | | Additional targets |
| non-windows-capable Metafont: | | Online Metafont graphics |
| NO_X11WIN : | | Online Metafont graphics |
- | NUL, not allowed in filenames: | | \input filenames |
+ | NUL, not allowed in filenames: | | \input filename caveats |
|
O | | |
| octal character codes, in TCX files: | | TCX files |
@@ -5815,6 +5912,9 @@ Previous: References, Up: | PXL files, explained: | | Font file formats |
| pxtoch : | | Font utilities available elsewhere |
|
+Q | | |
+ | quoted filename for \input : | | \input quoted filename |
+
|
R | | |
| Raichle, Bernd: | | MLTeX |
| reading, additional: | | Introduction |
@@ -5886,6 +5986,7 @@ Previous: References, Up:
|
T | | |
| T1 encoding and ISO input: | | TCX files |
+ | tabs, and \input filenames: | | \input filename caveats |
| Tachikawa, Elizabeth: | | Font file formats |
| tangle : | | tangle invocation |
| targets, additional Make: | | Additional targets |
@@ -5929,6 +6030,7 @@ Previous: References, Up: | three programs: | | Three programs |
| time and date, in memory dumps: | | Hardware and memory dumps |
| title font: | | gftodvi invocation |
+ | tokenization, and \input filenames: | | \input filename caveats |
| toolkits, X: | | Online Metafont graphics |
| torture tests: | | Triptrap |
| translation file for TeX, specifying: | | Common options |
@@ -6022,25 +6124,27 @@ Previous: References, Up: | y offset: | | pktype invocation |
|
-Jump to: | #
+Jump to: | "
-$
+#
-%
+$
--
+%
-.
+-
-2
+.
-8
+2
-\
+8
-^
+\
-~
+^
+
+~
A
@@ -6075,6 +6179,8 @@ Previous: References, Up: P
+Q
+
R
S
diff --git a/Master/texmf-dist/doc/web2c/web2c.pdf b/Master/texmf-dist/doc/web2c/web2c.pdf
index 68065edac44..ce5fc40e67b 100644
Binary files a/Master/texmf-dist/doc/web2c/web2c.pdf and b/Master/texmf-dist/doc/web2c/web2c.pdf differ
--
cgit v1.2.3
|
---|
|
---|
|
---|