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: , 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:
    , 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. +

    + + + + + + + +
    +
    +

    +Next: , Up: \input filenames   [Contents][Index]

    +
    +

    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. +

    + +
    +
    +

    +Next: , Previous: , Up: \input filenames   [Contents][Index]

    +
    +

    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. +

    + +
    +
    +

    +Previous: , Up: \input filenames   [Contents][Index]

    +
    +

    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:

    \input ~jsmith/$foo.bar
     
    -

    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: , Up:

    Index

    -
    Jump to:   # + - + + + + - - + + - + - + @@ -5246,7 +5334,7 @@ Previous: , Up: - + @@ -5268,15 +5356,15 @@ Previous: , Up: - + - + - + @@ -5285,7 +5373,10 @@ Previous: , Up: + + + @@ -5294,16 +5385,16 @@ Previous: , Up: - + - + - - + + @@ -5354,6 +5445,7 @@ Previous: , Up: + @@ -5367,6 +5459,7 @@ Previous: , Up: + @@ -5438,6 +5531,7 @@ Previous: , Up: + @@ -5469,7 +5563,7 @@ Previous: , Up: - + @@ -5483,6 +5577,7 @@ Previous: , Up: + @@ -5547,6 +5642,7 @@ Previous: , Up: + @@ -5662,7 +5758,7 @@ Previous: , Up: - + @@ -5715,6 +5811,7 @@ Previous: , Up: + @@ -5724,7 +5821,7 @@ Previous: , Up: - + @@ -5815,6 +5912,9 @@ Previous: , Up: + + + @@ -5886,6 +5986,7 @@ Previous: , Up: + @@ -5929,6 +6030,7 @@ Previous: , Up: + @@ -6022,25 +6124,27 @@ Previous: , Up:
    Jump to:   " +   +#   -$ +$   -% +%   -- +-   -. +.   -2 +2   -8 +8   -\ +\   -^ +^   -~ +~  
    A @@ -5127,6 +5210,8 @@ Previous: , Up: P   +Q +   R   S @@ -5147,16 +5232,19 @@ Previous: , 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
    -uppercase: tangle invocation
    -x: weave invocation

    .
    .
    ., used for output: Output file location
    .2602gf: mf invocation
    .aux cross-reference files: bibtex invocation
    .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
    \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
    \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
    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

    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
    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
    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
    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

    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

    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
    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
    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
    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

    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
    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
    y offset: pktype invocation

    -
    Jump to:   # +
    Jump to:   "   -$ +#   -% +$   -- +%   -. +-   -2 +.   -8 +2   -\ +8   -^ +\   -~ +^ +   +~  
    A @@ -6075,6 +6179,8 @@ Previous: , 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