texlive[61643] Build/source/texk/web2c: cross-engine doc references
commits+karl at tug.org
commits+karl at tug.org
Tue Jan 18 18:38:20 CET 2022
Revision: 61643
http://tug.org/svn/texlive?view=revision&revision=61643
Author: karl
Date: 2022-01-18 18:38:19 +0100 (Tue, 18 Jan 2022)
Log Message:
-----------
cross-engine doc references
Modified Paths:
--------------
trunk/Build/source/texk/web2c/ChangeLog
trunk/Build/source/texk/web2c/doc/web2c.info
trunk/Build/source/texk/web2c/doc/web2c.texi
Modified: trunk/Build/source/texk/web2c/ChangeLog
===================================================================
--- trunk/Build/source/texk/web2c/ChangeLog 2022-01-18 00:57:10 UTC (rev 61642)
+++ trunk/Build/source/texk/web2c/ChangeLog 2022-01-18 17:38:19 UTC (rev 61643)
@@ -1,3 +1,10 @@
+2022-01-18 Karl Berry <karl at freefriends.org>
+
+ * doc/web2c.texi (TeX extensions): mention pdftex manual and
+ ltnews31.pdf as primary documentation for the cross-engine
+ functionality.
+ (Introduction): mention TeX Live and teTeX.
+
2022-01-16 Andreas Scherer <https://ascherer.github.io>
* weave.ch: Add a third layer to 'byte_mem'.
Modified: trunk/Build/source/texk/web2c/doc/web2c.info
===================================================================
--- trunk/Build/source/texk/web2c/doc/web2c.info 2022-01-18 00:57:10 UTC (rev 61642)
+++ trunk/Build/source/texk/web2c/doc/web2c.info 2022-01-18 17:38:19 UTC (rev 61643)
@@ -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, 2010-2021 Karl Berry & Olaf Weber.
+2005, 2007, 2008, 2009, 2010-2022 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
@@ -58,7 +58,7 @@
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 2021, released in July 2021.
+corresponds to Web2c version 2022, released in January 2022.
* Menu:
@@ -83,15 +83,17 @@
1 Introduction
**************
-This manual corresponds to version 2021 of Web2c, released in July 2021.
+This manual corresponds to version 2022 of Web2c, released in January
+2022.
- "Web2c" is the name of a TeX implementation, originally for Unix, but
-now also running under various operating systems. By "TeX
-implementation", we mean all of the standard programs developed by the
-Stanford TeX project directed by Donald E. Knuth: Metafont, DVItype,
-GFtoDVI, BibTeX, Tangle, etc., as well as TeX itself. Other programs
-are also included: DVIcopy, written by Peter Breitenlohner, MetaPost and
-its utilities (derived from Metafont), by John Hobby, etc.
+ "Web2c" (also spelled Web2C) is the name of a TeX implementation,
+originally for Unix, but now also running under Windows and other
+operating systems. By "TeX implementation", we mean all of the standard
+programs developed by the Stanford TeX project led by Donald E. Knuth:
+Metafont, DVItype, GFtoDVI, BibTeX, Tangle, etc., as well as TeX itself.
+Other programs are also included: DVIcopy, written by Peter
+Breitenlohner, MetaPost and its utilities (derived from Metafont), by
+John Hobby, and many more.
General strategy: Web2c works, as its name implies, by translating
the WEB source in which TeX is written into C source code. Its output
@@ -127,9 +129,17 @@
He made many changes to the original sources, and started using the
shorter name Web2c. In 1997, Olaf Weber took over, and then in 2006,
Karl started taking care of it again. No significant development or
-changes have been needed for many years. Dozens of other people have
-contributed; their names are listed in the 'ChangeLog' files.
+changes have been needed for many years, though dozens of other people
+have contributed in many ways; their names are listed in the 'ChangeLog'
+files.
+ Originally, Web2c was distributed as its own package, alongside the
+original web programs from Stanford and other components. It was also
+the basis for the teTeX distribution (now discontinued). Around 2004,
+the packaging focus shifted entirely to the TeX Live distribution
+(<https://tug.org/texlive/>), though the same Web2c is at the heart of
+the release.
+
Other acknowledgements by Karl: The University of Massachusetts at
Boston (particularly Rick Martin and Bob Morris) provided computers and
ftp access to me for many years. Richard Stallman at the Free Software
@@ -373,6 +383,9 @@
Many aspects of the TeX system are the same among more than one program,
so we describe those pieces together, here.
+ Another kind of commonality is the extensions to TeX that are
+available across all the engines; *note TeX extensions::.
+
* Menu:
* Option conventions:: - or -, = or ' ' for values.
@@ -1613,9 +1626,25 @@
5.7 Extended TeX engines
========================
-The base TeX program has been extended in many ways. Here's a partial
-list.
+The base TeX program has been extended in many ways.
+ There has been a substantial effort to make some extended
+functionality available across all engines, so that formats, notably
+LaTeX, can rely on it. A list of this common extended functionality is
+in a 'LaTeX News' article,
+<https://www.latex-project.org/news/latex2e-news/ltnews31.pdf>, with
+some further annotatations in a listserv discussion,
+<https://listserv.uni-heidelberg.de/cgi-bin/wa?A2=LATEX-L;2e3c27d.2104&S=>.
+
+ For engines in TeX Live, the detailed documentation for the extended
+primitives is mostly in the pdfTeX manual (<http://pdftex.org>).
+Independently, the Prote engine also implements the common extended
+functionality (<http://kertex.kergis.com/en/prote.html>). Prote is a
+part of the kerTeX distribution (not related to Web2C or TeX Live).
+
+ In addition, each engine has its own particular features, described
+in its own manual. Here's a partial list of the engines.
+
e-TeX
Adds many new primitives, including right-to-left typesetting and
more registers. Now frozen. More info:
@@ -1622,11 +1651,11 @@
<https://ctan.org/pkg/etex>.
Aleph
- This adds Unicode support, right-to-left typesetting, and more.
- Omega was the original program. Aleph is an updated version with a
- variety of bug fixes, and includes e-TeX. Aleph is not actively
- maintained. More info: <https://ctan.org/pkg/aleph>,
- <https://ctan.org/pkg/omega>.
+ This adds Unicode support, right-to-left typesetting, and more,
+ based on the Omega engine, with the e-TeX and other extensions.
+ Aleph is maintained only for serious bug fixes and does not include
+ the common functionality mentioned above. More info:
+ <https://ctan.org/pkg/aleph>, <https://ctan.org/pkg/omega>.
pdfTeX
Can produce PDF as well as DVI files. It also incorporates the
@@ -1649,6 +1678,11 @@
with the exception of the font expansion part of micro-typography.
Home page: <https://tug.org/xetex>.
+hiTeX
+ Outputs the so-called HINT format, which is designed for reading
+ technical documents on mobile devices. More info:
+ <https://ctan.org/pkg/hitex>.
+
pTeX
upTeX
With additional support for Japanese; pTeX was the original engine,
@@ -3679,7 +3713,7 @@
(line 16)
* accented character: TCX files. (line 6)
* accents, hyphenating words with: MLTeX. (line 6)
-* acknowledgements: Introduction. (line 53)
+* acknowledgements: Introduction. (line 63)
* acm.bst: Basic BibTeX style files.
(line 19)
* Ada, WEB for: WEB. (line 12)
@@ -3690,7 +3724,7 @@
(line 12)
* afmtopl: Font utilities available elsewhere.
(line 12)
-* Aleph: TeX extensions. (line 15)
+* Aleph: TeX extensions. (line 31)
* aliases for fonts: Path searching. (line 14)
* alpha.bst: Basic BibTeX style files.
(line 22)
@@ -3723,7 +3757,7 @@
(line 15)
* beamer, package: Formats. (line 57)
* beginfig: mpost invocation. (line 31)
-* Berry, Karl: Introduction. (line 42)
+* Berry, Karl: Introduction. (line 44)
* BIBINPUTS, search path for bib files: bibtex invocation. (line 18)
* bibliographies, creating: BibTeX. (line 6)
* bibliography: References. (line 6)
@@ -3741,7 +3775,7 @@
* braced filename for \input: \input braced filename.
(line 6)
* breakpoints, memory for: Runtime options. (line 20)
-* Breitenlohner, Peter: Introduction. (line 8)
+* Breitenlohner, Peter: Introduction. (line 9)
* BSTINPUTS, search path for bst files: bibtex invocation. (line 18)
* btex for MetaPost labels: mpost invocation. (line 44)
* btxdoc.bib: bibtex invocation. (line 52)
@@ -3809,11 +3843,12 @@
* Cork encoding and ISO input: TCX files. (line 48)
* creating memory dumps: Creating memory dumps.
(line 6)
+* cross-engine functionality: TeX extensions. (line 8)
* cross-referenced bibliography items: bibtex invocation. (line 31)
* cross-references, omitting: weave invocation. (line 22)
* current directory, used for output: Output file location.
(line 6)
-* Curtis, Pavel: Introduction. (line 42)
+* Curtis, Pavel: Introduction. (line 44)
* Cweb: WEB. (line 12)
* CWEB: WEB. (line 12)
* date and time, in memory dumps: Hardware and memory dumps.
@@ -3858,7 +3893,7 @@
* dynamic packing variable: pktype invocation. (line 44)
* e response at error prompt: Editor invocation. (line 6)
* e-circumflex: \charsubdef. (line 20)
-* e-TeX: TeX extensions. (line 10)
+* e-TeX: TeX extensions. (line 26)
* e.mft: mft invocation. (line 72)
* EC fonts: tex invocation. (line 41)
* EC fonts <1>: mf invocation. (line 24)
@@ -3874,14 +3909,14 @@
* Eplain: Formats. (line 50)
* epsf: Online Metafont graphics.
(line 19)
-* epTeX: TeX extensions. (line 51)
+* epTeX: TeX extensions. (line 72)
* errors, editor invoked at: Editor invocation. (line 6)
* escapement, horizontal: pktype invocation. (line 57)
* escapement, horizontal <1>: gftype invocation. (line 106)
* escapement, vertical: gftype invocation. (line 106)
* etex for MetaPost labels: mpost invocation. (line 44)
-* etex is pdfTeX: TeX extensions. (line 22)
-* eupTeX: TeX extensions. (line 51)
+* etex is pdfTeX: TeX extensions. (line 38)
+* eupTeX: TeX extensions. (line 72)
* executables, shared initial and virgin: Initial and virgin. (line 6)
* exit status, of shell escape: Shell escapes. (line 34)
* expanded plain format: Formats. (line 50)
@@ -3935,7 +3970,7 @@
* fraction routines: Compile-time options.
(line 21)
* Free Software Foundation documentation system: Formats. (line 43)
-* freedom of Web2c: Introduction. (line 22)
+* freedom of Web2c: Introduction. (line 24)
* ftp.math.utah.edu: bibtex invocation. (line 58)
* generating source specials: tex invocation. (line 134)
* geometric designs: Metafont. (line 6)
@@ -3975,8 +4010,10 @@
* Herberts, Mathias: Online Metafont graphics.
(line 20)
* hex character codes, in TCX files: TCX files. (line 77)
-* history: Introduction. (line 42)
-* Hobby, John: Introduction. (line 8)
+* HINT (Hint Is Not TeX): TeX extensions. (line 59)
+* history: Introduction. (line 44)
+* hiTeX: TeX extensions. (line 59)
+* Hobby, John: Introduction. (line 9)
* horizontal escapement: pktype invocation. (line 57)
* horizontal escapement <1>: gftype invocation. (line 106)
* hp2627: Online Metafont graphics.
@@ -3988,11 +4025,11 @@
* human-readable text, converting PK to: pktype invocation. (line 6)
* human-readable text, converting TFM to: tftopl invocation. (line 6)
* human-readable text, converting VF to: vftovp invocation. (line 6)
-* hypertext: TeX extensions. (line 22)
+* hypertext: TeX extensions. (line 38)
* hyphenation and languages: Languages and hyphenation.
(line 6)
* hyphenation patterns, creating: patgen invocation. (line 6)
-* ice cream: Introduction. (line 22)
+* ice cream: Introduction. (line 24)
* identifier case: tangle invocation. (line 35)
* identifier collisions: tangle invocation. (line 46)
* identifier length: tangle invocation. (line 27)
@@ -4024,8 +4061,9 @@
* IPC_DEBUG <1>: IPC and TeX. (line 13)
* job name: Common options. (line 60)
* kerning table, in TFM files: tftopl invocation. (line 101)
+* kerTeX distribution: TeX extensions. (line 8)
* keyboard character code, translating: TCX files. (line 101)
-* Knuth, Donald E.: Introduction. (line 8)
+* Knuth, Donald E.: Introduction. (line 9)
* Knuth, Donald E. <1>: mft invocation. (line 56)
* KPATHSEA_DEBUG: Common options. (line 64)
* KRN property: tftopl invocation. (line 101)
@@ -4041,7 +4079,7 @@
* left side bearing <1>: gftype invocation. (line 82)
* legalisms: Legalisms. (line 6)
* libsigsegv library: Runtime options. (line 33)
-* licensing terms: Introduction. (line 22)
+* licensing terms: Introduction. (line 24)
* LIG property: tftopl invocation. (line 101)
* ligature table, in TFM files: tftopl invocation. (line 101)
* LIGTABLE property: tftopl invocation. (line 101)
@@ -4055,8 +4093,8 @@
* log file, BibTeX: bibtex invocation. (line 14)
* long data type, size of: Hardware and memory dumps.
(line 6)
-* Lua: TeX extensions. (line 30)
-* LuaTeX: TeX extensions. (line 30)
+* Lua: TeX extensions. (line 46)
+* LuaTeX: TeX extensions. (line 46)
* machine dependencies: Hardware and memory dumps.
(line 6)
* machine-readable, converting property lists to: pltotf invocation.
@@ -4071,7 +4109,7 @@
* magnification <1>: dvitype invocation. (line 28)
* main_memory: Runtime options. (line 15)
* Make targets, additional: Additional targets. (line 6)
-* Martin, Rick: Introduction. (line 53)
+* Martin, Rick: Introduction. (line 63)
* Mathematical Reviews: Formats. (line 35)
* mathematical typesetting: TeX. (line 6)
* mem file, determining: Determining the memory dump to use.
@@ -4125,7 +4163,7 @@
* MFTERM: Online Metafont graphics.
(line 11)
* mftmac.tex: mft invocation. (line 6)
-* micro-typography: TeX extensions. (line 22)
+* micro-typography: TeX extensions. (line 38)
* mktexmf, disabling: mf invocation. (line 24)
* mktextfM, disabling: tex invocation. (line 41)
* mltex: MLTeX. (line 6)
@@ -4136,8 +4174,8 @@
* mode_def: Modes. (line 15)
* mode_setup: Modes. (line 15)
* modifying texmf.cnf in TeX Live: Runtime options. (line 56)
-* Morgan, Tim: Introduction. (line 42)
-* Morris, Bob: Introduction. (line 53)
+* Morgan, Tim: Introduction. (line 44)
+* Morris, Bob: Introduction. (line 63)
* MPEDIT: Editor invocation. (line 10)
* mpgraph.pdf: mpost invocation. (line 14)
* mpman.pdf: mpost invocation. (line 6)
@@ -4167,11 +4205,11 @@
(line 12)
* octal character codes, in TCX files: TCX files. (line 77)
* offset for overflow labels: gftodvi invocation. (line 59)
-* Omega: TeX extensions. (line 15)
+* Omega: TeX extensions. (line 31)
* online Metafont graphics: Online Metafont graphics.
(line 6)
* opcodes, showing DVI: dvitype invocation. (line 52)
-* OpenType support: TeX extensions. (line 30)
+* OpenType support: TeX extensions. (line 46)
* optical font scaling: Font file formats. (line 21)
* option conventions: Option conventions. (line 6)
* origin: pktype invocation. (line 66)
@@ -4192,9 +4230,9 @@
* patgen: patgen invocation. (line 6)
* path searching: Path searching. (line 6)
* path searching debugging: Common options. (line 64)
-* PDF: TeX extensions. (line 22)
+* PDF: TeX extensions. (line 38)
* PDF, and .mps files: mpost invocation. (line 82)
-* pdfTeX: TeX extensions. (line 22)
+* pdfTeX: TeX extensions. (line 38)
* permissions, legal: Legalisms. (line 6)
* PFA and PFB conversion: Font utilities available elsewhere.
(line 39)
@@ -4246,7 +4284,7 @@
* predefined macros and memory dumps: Memory dumps. (line 6)
* prettyprinting Metafont source: mft invocation. (line 6)
* prettyprinting WEB programs: weave invocation. (line 6)
-* primitives, new: TeX extensions. (line 10)
+* primitives, new: TeX extensions. (line 26)
* printable characters, specifying: TCX files. (line 87)
* printer characteristics, for Metafont: Modes. (line 6)
* production use: Initial and virgin. (line 15)
@@ -4262,10 +4300,11 @@
* property list format: tftopl invocation. (line 43)
* property list, converting TFM to: tftopl invocation. (line 6)
* property list, converting VF to virtual: vftovp invocation. (line 6)
+* Prote engine: TeX extensions. (line 8)
* ps2pk: Font utilities available elsewhere.
(line 35)
* psfonts.map, read by MetaPost: mpost invocation. (line 76)
-* pTeX: TeX extensions. (line 44)
+* pTeX: TeX extensions. (line 65)
* PXL files, explained: Font file formats. (line 39)
* pxtoch: Font utilities available elsewhere.
(line 23)
@@ -4272,7 +4311,7 @@
* quoted filename for \input: \input quoted filename.
(line 6)
* Raichle, Bernd: MLTeX. (line 6)
-* reading, additional: Introduction. (line 61)
+* reading, additional: Introduction. (line 71)
* readonly directory, running TeX in: Output file location.
(line 15)
* readonly directory, running TeX in <1>: Output file location.
@@ -4292,7 +4331,7 @@
* restricted shell escapes: Shell escapes. (line 6)
* right side bearing: pktype invocation. (line 66)
* right side bearing <1>: gftype invocation. (line 82)
-* Rokicki, Tomas: Introduction. (line 42)
+* Rokicki, Tomas: Introduction. (line 44)
* run length encoded bitmaps: pktype invocation. (line 76)
* run length encoded bitmaps <1>: gftype invocation. (line 89)
* runtime options: Runtime options. (line 6)
@@ -4324,13 +4363,13 @@
* sockets: IPC and TeX. (line 6)
* space-terminated filenames: \input filenames. (line 10)
* Spiderweb: WEB. (line 12)
-* Stallman, Richard: Introduction. (line 53)
+* Stallman, Richard: Introduction. (line 63)
* starting page: dvicopy invocation. (line 28)
* starting page <1>: dvitype invocation. (line 46)
* Steele Jr., Guy L.: Hardware and memory dumps.
(line 39)
* stopping at the first error: Common options. (line 46)
-* strategy, overall: Introduction. (line 16)
+* strategy, overall: Introduction. (line 18)
* string numbers, displaying: pooltype invocation. (line 6)
* string pool, writing: tangle invocation. (line 16)
* string representation: pooltype invocation. (line 30)
@@ -4351,7 +4390,7 @@
* syntax of TCX files: TCX files. (line 65)
* system C library function: Shell escapes. (line 6)
* system command: Shell escapes. (line 6)
-* system fonts, using: TeX extensions. (line 30)
+* system fonts, using: TeX extensions. (line 46)
* T1 encoding and ISO input: TCX files. (line 48)
* tabs, and \input filenames: \input filename caveats.
(line 6)
@@ -4370,6 +4409,7 @@
(line 11)
* terminator for filenames: \input filenames. (line 10)
* terse output: bibtex invocation. (line 28)
+* teTeX distribution: Introduction. (line 56)
* tex: tex invocation. (line 6)
* TeX, bibliographies for: bibtex invocation. (line 58)
* TeX, creating from Metafont: mft invocation. (line 6)
@@ -4381,7 +4421,7 @@
* TeX, input files found: tex invocation. (line 20)
* TeX, invocation: tex invocation. (line 6)
* TeX, Metafont, and MetaPost: Three programs. (line 6)
-* TeX, Web2c implementation of: Introduction. (line 8)
+* TeX, Web2c implementation of: Introduction. (line 9)
* tex.fmt: Initial TeX. (line 13)
* TEXBIB, search path for bib files: bibtex invocation. (line 18)
* TEXEDIT: Editor invocation. (line 10)
@@ -4418,11 +4458,11 @@
(line 59)
* torture tests: Triptrap. (line 6)
* translation file for TeX, specifying: Common options. (line 103)
-* translation from WEB to C: Introduction. (line 16)
+* translation from WEB to C: Introduction. (line 18)
* trap Make target: Additional targets. (line 41)
* trap test: Triptrap. (line 6)
* trapman.tex: Triptrap. (line 6)
-* Trickey, Howard: Introduction. (line 42)
+* Trickey, Howard: Introduction. (line 44)
* trip Make target: Additional targets. (line 41)
* trip test: Triptrap. (line 6)
* tripman.tex: Triptrap. (line 6)
@@ -4431,7 +4471,7 @@
* troff, supported in MetaPost: MetaPost. (line 12)
* Troff, WEB for: WEB. (line 12)
* Trojan horses and TeX programs: tex invocation. (line 48)
-* TrueType support: TeX extensions. (line 30)
+* TrueType support: TeX extensions. (line 46)
* TUGboat bibliography: bibtex invocation. (line 58)
* Type 1 conversion: Font utilities available elsewhere.
(line 39)
@@ -4442,16 +4482,16 @@
* type programs, pool: pooltype invocation. (line 6)
* typeface families: Metafont. (line 6)
* typesetting: TeX. (line 6)
-* Unicode: TeX extensions. (line 15)
+* Unicode: TeX extensions. (line 31)
* Unicode input: tex invocation. (line 86)
-* Unicode input, native: TeX extensions. (line 37)
+* Unicode input, native: TeX extensions. (line 53)
* uniterm: Online Metafont graphics.
(line 50)
* unsrt.bst: Basic BibTeX style files.
(line 39)
-* upTeX: TeX extensions. (line 44)
+* upTeX: TeX extensions. (line 65)
* UTF-8 input: tex invocation. (line 86)
-* UTF-8 input, native: TeX extensions. (line 30)
+* UTF-8 input, native: TeX extensions. (line 46)
* validation, of DVI files: dvitype invocation. (line 6)
* validation, of GF files: gftype invocation. (line 6)
* validation, of PK files: pktype invocation. (line 6)
@@ -4477,7 +4517,7 @@
* WEB programs, compiling: tangle invocation. (line 6)
* WEB programs, typesetting: weave invocation. (line 6)
* WEB2C, search path for TCX files: TCX files. (line 35)
-* Weber, Olaf: Introduction. (line 42)
+* Weber, Olaf: Introduction. (line 44)
* webmac.tex: weave invocation. (line 22)
* webman.tex: WEB. (line 12)
* whitespace, in TCX files: TCX files. (line 68)
@@ -4500,7 +4540,7 @@
* xampl.bib: bibtex invocation. (line 55)
* xbfe, bitmap font editor: Font utilities available elsewhere.
(line 23)
-* XeTeX: TeX extensions. (line 37)
+* XeTeX: TeX extensions. (line 53)
* xfed, bitmap font editor: Font utilities available elsewhere.
(line 23)
* xfedor, bitmap font editor: Font utilities available elsewhere.
@@ -4521,78 +4561,78 @@
Tag Table:
Node: Top2759
-Node: Introduction3830
-Node: Installation7167
-Node: configure options9211
-Node: Compile-time options11233
-Node: Additional targets12335
-Node: Triptrap13612
-Node: Commonalities15115
-Node: Option conventions15648
-Node: Common options16871
-Node: Path searching21489
-Node: Output file location22461
-Node: Three programs23763
-Node: Runtime options24470
-Node: Initial and virgin27611
-Node: Memory dumps28560
-Node: Creating memory dumps29012
-Node: Determining the memory dump to use30219
-Node: Hardware and memory dumps31796
-Node: Editor invocation34546
-Node: \input filenames35409
-Node: \input quoted filename36960
-Node: \input braced filename37737
-Node: \input filename caveats38667
-Node: TeX40181
-Node: tex invocation41349
-Node: Initial TeX48335
-Node: Formats49699
-Node: Languages and hyphenation52516
-Node: MLTeX52946
-Node: \charsubdef54574
-Node: \tracingcharsubdef56897
-Node: TCX files57472
-Node: patgen invocation62912
-Node: Shell escapes63619
-Node: IPC and TeX67199
-Node: TeX extensions67769
-Node: Metafont69798
-Node: mf invocation71086
-Node: Initial Metafont74923
-Node: Modes76553
-Node: Online Metafont graphics78803
-Node: gftodvi invocation82228
-Node: mft invocation85048
-Node: MetaPost89046
-Node: mpost invocation89882
-Node: Initial MetaPost94918
-Node: dvitomp invocation95840
-Node: BibTeX96505
-Node: bibtex invocation96866
-Node: Basic BibTeX style files99340
-Node: WEB100670
-Node: tangle invocation101879
-Node: weave invocation104003
-Node: pooltype invocation105410
-Node: DVI utilities106540
-Node: dvicopy invocation107474
-Node: dvitype invocation108759
-Node: dvitype output example111090
-Node: Font utilities114143
-Node: Font file formats115323
-Node: gftopk invocation118590
-Node: pktogf invocation119781
-Node: pktype invocation120947
-Node: gftype invocation123770
-Node: tftopl invocation128273
-Node: pltotf invocation132866
-Node: vftovp invocation133917
-Node: vptovf invocation136152
-Node: Font utilities available elsewhere137179
-Node: Legalisms139384
-Node: References140831
-Node: Index144964
+Node: Introduction3833
+Node: Installation7591
+Node: configure options9635
+Node: Compile-time options11657
+Node: Additional targets12759
+Node: Triptrap14036
+Node: Commonalities15539
+Node: Option conventions16196
+Node: Common options17419
+Node: Path searching22037
+Node: Output file location23009
+Node: Three programs24311
+Node: Runtime options25018
+Node: Initial and virgin28159
+Node: Memory dumps29108
+Node: Creating memory dumps29560
+Node: Determining the memory dump to use30767
+Node: Hardware and memory dumps32344
+Node: Editor invocation35094
+Node: \input filenames35957
+Node: \input quoted filename37508
+Node: \input braced filename38285
+Node: \input filename caveats39215
+Node: TeX40729
+Node: tex invocation41897
+Node: Initial TeX48883
+Node: Formats50247
+Node: Languages and hyphenation53064
+Node: MLTeX53494
+Node: \charsubdef55122
+Node: \tracingcharsubdef57445
+Node: TCX files58020
+Node: patgen invocation63460
+Node: Shell escapes64167
+Node: IPC and TeX67747
+Node: TeX extensions68317
+Node: Metafont71421
+Node: mf invocation72709
+Node: Initial Metafont76546
+Node: Modes78176
+Node: Online Metafont graphics80426
+Node: gftodvi invocation83851
+Node: mft invocation86671
+Node: MetaPost90669
+Node: mpost invocation91505
+Node: Initial MetaPost96541
+Node: dvitomp invocation97463
+Node: BibTeX98128
+Node: bibtex invocation98489
+Node: Basic BibTeX style files100963
+Node: WEB102293
+Node: tangle invocation103502
+Node: weave invocation105626
+Node: pooltype invocation107033
+Node: DVI utilities108163
+Node: dvicopy invocation109097
+Node: dvitype invocation110382
+Node: dvitype output example112713
+Node: Font utilities115766
+Node: Font file formats116946
+Node: gftopk invocation120213
+Node: pktogf invocation121404
+Node: pktype invocation122570
+Node: gftype invocation125393
+Node: tftopl invocation129896
+Node: pltotf invocation134489
+Node: vftovp invocation135540
+Node: vptovf invocation137775
+Node: Font utilities available elsewhere138802
+Node: Legalisms141007
+Node: References142454
+Node: Index146587
End Tag Table
Modified: trunk/Build/source/texk/web2c/doc/web2c.texi
===================================================================
--- trunk/Build/source/texk/web2c/doc/web2c.texi 2022-01-18 00:57:10 UTC (rev 61642)
+++ trunk/Build/source/texk/web2c/doc/web2c.texi 2022-01-18 17:38:19 UTC (rev 61643)
@@ -11,8 +11,8 @@
\fi
@end tex
- at set version 2021
- at set month-year July 2021
+ at set version 2022
+ at set month-year January 2022
@c Define new indices for commands in auxiliary files, filenames, and options.
@defcodeindex cm
@@ -63,7 +63,7 @@
an implementation of Donald Knuth's TeX system.
Copyright @copyright{} 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
-2004, 2005, 2007, 2008, 2009, 2010-2021 Karl Berry & Olaf Weber.
+2004, 2005, 2007, 2008, 2009, 2010-2022 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
@@ -142,14 +142,14 @@
@cindex @TeX{}, Web2c implementation of
@cindex Hobby, John
@cindex Breitenlohner, Peter
- at dfn{Web2c} is the name of a @TeX{} implementation, originally for
-Unix, but now also running under various operating systems. By
- at dfn{@TeX{} implementation}, we mean all of the standard programs
-developed by the Stanford @TeX{} project directed by Donald E. Knuth:
-Metafont, DVItype, GFtoDVI, Bib at TeX{}, Tangle, etc., as well as @TeX{}
-itself. Other programs are also included: DVIcopy, written by Peter
-Breitenlohner, MetaPost and its utilities (derived from Metafont), by
-John Hobby, etc.
+ at dfn{Web2c} (also spelled Web2C) is the name of a @TeX{}
+implementation, originally for Unix, but now also running under
+Windows and other operating systems. By @dfn{@TeX{} implementation},
+we mean all of the standard programs developed by the Stanford @TeX{}
+project led by Donald at tie{}E. Knuth: Metafont, DVItype, GFtoDVI,
+Bib at TeX{}, Tangle, etc., as well as @TeX{} itself. Other programs are
+also included: DVIcopy, written by Peter Breitenlohner, MetaPost and
+its utilities (derived from Metafont), by John Hobby, and many more.
@cindex translation from WEB to C
@cindex strategy, overall
@@ -196,10 +196,18 @@
the maintainer. He made many changes to the original sources, and
started using the shorter name Web2c. In 1997, Olaf Weber took over,
and then in 2006, Karl started taking care of it again. No
-significant development or changes have been needed for many
-years. Dozens of other people have contributed; their names are listed
-in the @file{ChangeLog} files.
+significant development or changes have been needed for many years,
+though dozens of other people have contributed in many ways; their
+names are listed in the @file{ChangeLog} files.
+ at cindex te at TeX{} distribution
+Originally, Web2c was distributed as its own package, alongside the
+original web programs from Stanford and other components. It was also
+the basis for the te at TeX{} distribution (now discontinued). Around
+2004, the packaging focus shifted entirely to the @TeX{} Live
+distribution (@url{https://tug.org/texlive/}), though the same Web2c
+is at the heart of the release.
+
@cindex acknowledgements
@cindex Martin, Rick
@cindex Morris, Bob
@@ -210,7 +218,7 @@
Foundation employed me while I wrote the original path searching library
(for the GNU font utilities). (rms also gave us Emacs, GDB, and GCC,
without which I cannot imagine developing Web2c.) And, of course,
- at TeX{} would not exist in the first place without Donald E. Knuth.
+ at TeX{} would not exist in the first place without Donald at tie{}E. Knuth.
@cindex reading, additional
Further reading: @xref{References}.
@@ -227,6 +235,9 @@
Many aspects of the @TeX{} system are the same among more than one
program, so we describe those pieces together, here.
+Another kind of commonality is the extensions to @TeX{} that are
+available across all the engines; @pxref{TeX extensions}.
+
@menu
* Option conventions:: -- or -, = or ` ' for values.
* Common options:: --help --version --verbose, and TeX/MF/MP options.
@@ -1901,24 +1912,45 @@
@cindex extensions to @TeX{}
@cindex @TeX{}, extensions to
-The base @TeX{} program has been extended in many ways. Here's a
-partial list.
+The base @TeX{} program has been extended in many ways.
+ at cindex cross-engine functionality
+ at cindex Prote engine
+ at cindex ker at TeX{} distribution
+There has been a substantial effort to make some extended
+functionality available across all engines, so that formats, notably
+ at LaTeX{}, can rely on it. A list of this common extended
+functionality is in a @cite{@LaTeX{} News} article,
+ at url{https://www.latex-project.org/news/latex2e-news/ltnews31.pdf},
+with some further annotatations in a listserv discussion,
+ at url{https://listserv.uni-heidelberg.de/cgi-bin/wa?A2=LATEX-L;2e3c27d.2104&S=}.
+
+For engines in @TeX{} Live, the detailed documentation for the
+extended primitives is mostly in the pdf at TeX{} manual
+(@url{http://pdftex.org}). Independently, the Prote engine also
+implements the common extended functionality
+(@url{http://kertex.kergis.com/en/prote.html}). Prote is a part of
+the ker at TeX{} distribution (not related to Web2C or @TeX{} Live).
+
+In addition, each engine has its own particular features, described in
+its own manual. Here's a partial list of the engines.
+
@table @asis
@item e- at TeX{}
@cindex e- at TeX{}
@cindex primitives, new
Adds many new primitives, including right-to-left typesetting and more
-registers. Now frozen. More info: @url{https://ctan.org/pkg/etex}.
+registers. Now frozen. More info: @url{https://ctan.org/pkg/etex}.
@item Aleph
@cindex Aleph
@cindex Omega
@cindex Unicode
-This adds Unicode support, right-to-left typesetting, and more. Omega
-was the original program. Aleph is an updated version with a variety
-of bug fixes, and includes e- at TeX{}. Aleph is not actively maintained.
-More info: @url{https://ctan.org/pkg/aleph}, @url{https://ctan.org/pkg/omega}.
+This adds Unicode support, right-to-left typesetting, and more, based
+on the Omega engine, with the e- at TeX{} and other extensions. Aleph is
+maintained only for serious bug fixes and does not include the common
+functionality mentioned above. More info:
+ at url{https://ctan.org/pkg/aleph}, @url{https://ctan.org/pkg/omega}.
@item pdf at TeX{}
@cindex pdf at TeX{}
@@ -1954,6 +1986,13 @@
with the exception of the font expansion part of micro-typography.
Home page: @url{https://tug.org/xetex}.
+ at item hi at TeX{}
+ at cindex hi at TeX{}
+ at cindex HINT (Hint Is Not @TeX{})
+Outputs the so-called HINT format, which is designed for reading
+technical documents on mobile devices. More info:
+ at url{https://ctan.org/pkg/hitex}.
+
@item p at TeX{}
@itemx up at TeX{}
@cindex p at TeX{}
More information about the tex-live-commits
mailing list.