diff options
| author | Karl Berry <karl@freefriends.org> | 2018-03-30 22:27:37 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2018-03-30 22:27:37 +0000 |
| commit | 455506ec711f0d6edd259c0b7c5e5a533d34ecee (patch) | |
| tree | 6a4f46b633f148e55c3c025c05d8604d7fdea3aa /Master | |
| parent | 80cdd301189d43155d7e22400db1b0b72dd1bb02 (diff) | |
doc updates
git-svn-id: svn://tug.org/texlive/trunk@47198 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
262 files changed, 2448 insertions, 2014 deletions
diff --git a/Master/texmf-dist/doc/dvipng/dvipng.html b/Master/texmf-dist/doc/dvipng/dvipng.html index 868676e7219..ae4503aa543 100644 --- a/Master/texmf-dist/doc/dvipng/dvipng.html +++ b/Master/texmf-dist/doc/dvipng/dvipng.html @@ -1,7 +1,8 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>A DVI-to-PNG translator</title> <meta name="description" content="A DVI-to-PNG translator"> @@ -9,7 +10,6 @@ <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> diff --git a/Master/texmf-dist/doc/dvipng/dvipng.pdf b/Master/texmf-dist/doc/dvipng/dvipng.pdf Binary files differindex 50a0195e70f..96bf29ac4dd 100644 --- a/Master/texmf-dist/doc/dvipng/dvipng.pdf +++ b/Master/texmf-dist/doc/dvipng/dvipng.pdf diff --git a/Master/texmf-dist/doc/dvips/dvips.html b/Master/texmf-dist/doc/dvips/dvips.html index ecf1a1a7df5..37b42f07f0d 100644 --- a/Master/texmf-dist/doc/dvips/dvips.html +++ b/Master/texmf-dist/doc/dvips/dvips.html @@ -1,10 +1,11 @@ <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> -<!-- This manual documents Dvips version 5.997 -(April 2017), a program to translate a DVI file into +<!-- This manual documents Dvips version 5.998 +(February 2018), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. --> -<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Dvips: A DVI-to-PostScript translator</title> <meta name="description" content="Dvips: A DVI-to-PostScript translator"> @@ -12,7 +13,6 @@ PostScript. You may freely use, modify and/or distribute this file. --> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> @@ -203,8 +203,8 @@ Next: <a href="#Why-Dvips" accesskey="n" rel="next">Why Dvips</a>, Up: <a href=" <a name="Dvips"></a> <h1 class="top">Dvips</h1> -<p>This manual documents Dvips version 5.997 -(April 2017), a program to translate a DVI file into +<p>This manual documents Dvips version 5.998 +(February 2018), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. </p> diff --git a/Master/texmf-dist/doc/dvips/dvips.pdf b/Master/texmf-dist/doc/dvips/dvips.pdf Binary files differindex d532ef73af6..516f2bf506f 100644 --- a/Master/texmf-dist/doc/dvips/dvips.pdf +++ b/Master/texmf-dist/doc/dvips/dvips.pdf diff --git a/Master/texmf-dist/doc/info/dvips.info b/Master/texmf-dist/doc/info/dvips.info index dd50bd93b09..15ad0b2d5c9 100644 --- a/Master/texmf-dist/doc/info/dvips.info +++ b/Master/texmf-dist/doc/info/dvips.info @@ -1,6 +1,6 @@ -This is dvips.info, produced by makeinfo version 6.3 from dvips.texi. +This is dvips.info, produced by makeinfo version 6.5 from dvips.texi. -This manual documents Dvips version 5.997 (April 2017), a program to +This manual documents Dvips version 5.998 (February 2018), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. INFO-DIR-SECTION TeX @@ -16,7 +16,7 @@ File: dvips.info, Node: Top, Next: Why Dvips, Up: (dir) Dvips ***** -This manual documents Dvips version 5.997 (April 2017), a program to +This manual documents Dvips version 5.998 (February 2018), a program to translate a DVI file into PostScript. You may freely use, modify and/or distribute this file. @@ -425,9 +425,9 @@ environment variables, and command-line options. * Menu: * Basic usage:: -* Command-line options:: -* Environment variables:: -* Config files:: +* Command-line options:: +* Environment variables:: +* Config files:: File: dvips.info, Node: Basic usage, Next: Command-line options, Up: Invoking Dvips @@ -921,7 +921,7 @@ reversal, use '-r0'. Such options are marked with a trailing '*'. specified in the DVI file. See '-x' above. '-Y NUM' - Set the vertical resolution in dots per inch to NUM. + Set the vertical resolution in dots per inch to NUM. '-z*' Pass 'html' hyperdvi specials through to the output for eventual @@ -1722,8 +1722,8 @@ terminal when it processes each figure, give the command: * Menu: -* EPSF scaling:: -* EPSF clipping:: +* EPSF scaling:: +* EPSF clipping:: File: dvips.info, Node: EPSF scaling, Next: EPSF clipping, Up: EPSF macros @@ -1995,8 +1995,8 @@ header files are included. * Menu: -* Including headers from TeX:: -* Including headers from the command line:: +* Including headers from TeX:: +* Including headers from the command line:: * Headers and memory usage:: @@ -4630,82 +4630,82 @@ Index Tag Table: -Node: Top517 -Node: Why Dvips1263 -Node: Installation4280 -Node: config.ps installation5283 -Node: PostScript font installation7890 -Node: Ghostscript installation8810 -Node: Diagnosing problems9747 -Node: Debug options10838 -Node: No output11842 -Node: Small or inverted13308 -Node: Printer errors14026 -Node: Long documents fail15358 -Node: Including graphics fails15699 -Node: Invoking Dvips16938 -Node: Basic usage17560 -Node: Command-line options18564 -Node: Option summary19012 -Node: Option details21261 -Node: Environment variables41034 -Node: Config files43895 -Node: Configuration file searching44565 -Node: Configuration file commands47762 -Node: Paper size and landscape55543 -Node: papersize special57168 -Node: Config file paper sizes58876 -Node: Paper trays63032 -Node: Interaction with PostScript64366 -Node: PostScript figures65019 -Node: Bounding box65745 -Node: \includegraphics69117 -Node: EPSF macros71410 -Node: EPSF scaling73410 -Node: EPSF clipping75980 -Node: psfile special76622 -Node: Dynamic creation of graphics79014 -Node: Fonts in figures80332 -Node: Header files81982 -Node: Including headers from TeX83192 -Node: Including headers from the command line85230 -Node: Headers and memory usage86329 -Node: Literal PS87540 -Node: " special88122 -Node: ps special88863 -Node: Literal headers90361 -Node: PostScript hooks91070 -Node: Literal examples93166 -Node: Hypertext94620 -Node: Hypertext caveats95849 -Node: Hypertext specials100237 -Node: PostScript fonts102871 -Node: Font concepts103988 -Node: Metric files105155 -Node: Glyph files107935 -Node: Virtual fonts110294 -Node: Encodings112120 -Node: PostScript typesetting114523 -Node: Making a font available117608 -Node: Invoking afm2tfm122642 -Node: Changing font encodings123659 -Node: Changing TeX encodings124450 -Node: Changing PostScript encodings125552 -Node: Changing both encodings126896 -Node: Reencoding with Afm2tfm127570 -Node: Encoding file format130673 -Node: Special font effects134877 -Node: Afm2tfm options137137 -Node: psfonts.map140662 -Node: Color145392 -Node: Color macro files146436 -Node: User-definable colors149629 -Node: Color subtleties150905 -Node: Ted Turner152557 -Node: Color device configuration153782 -Node: Color support details156226 -Node: Color specifications156604 -Node: Color specials158008 -Node: Index160137 +Node: Top520 +Node: Why Dvips1269 +Node: Installation4286 +Node: config.ps installation5289 +Node: PostScript font installation7896 +Node: Ghostscript installation8816 +Node: Diagnosing problems9753 +Node: Debug options10844 +Node: No output11848 +Node: Small or inverted13314 +Node: Printer errors14032 +Node: Long documents fail15364 +Node: Including graphics fails15705 +Node: Invoking Dvips16944 +Node: Basic usage17535 +Node: Command-line options18539 +Node: Option summary18987 +Node: Option details21236 +Node: Environment variables41008 +Node: Config files43869 +Node: Configuration file searching44539 +Node: Configuration file commands47736 +Node: Paper size and landscape55517 +Node: papersize special57142 +Node: Config file paper sizes58850 +Node: Paper trays63006 +Node: Interaction with PostScript64340 +Node: PostScript figures64993 +Node: Bounding box65719 +Node: \includegraphics69091 +Node: EPSF macros71384 +Node: EPSF scaling73353 +Node: EPSF clipping75923 +Node: psfile special76565 +Node: Dynamic creation of graphics78957 +Node: Fonts in figures80275 +Node: Header files81925 +Node: Including headers from TeX83131 +Node: Including headers from the command line85169 +Node: Headers and memory usage86268 +Node: Literal PS87479 +Node: " special88061 +Node: ps special88802 +Node: Literal headers90300 +Node: PostScript hooks91009 +Node: Literal examples93105 +Node: Hypertext94559 +Node: Hypertext caveats95788 +Node: Hypertext specials100176 +Node: PostScript fonts102810 +Node: Font concepts103927 +Node: Metric files105094 +Node: Glyph files107874 +Node: Virtual fonts110233 +Node: Encodings112059 +Node: PostScript typesetting114462 +Node: Making a font available117547 +Node: Invoking afm2tfm122581 +Node: Changing font encodings123598 +Node: Changing TeX encodings124389 +Node: Changing PostScript encodings125491 +Node: Changing both encodings126835 +Node: Reencoding with Afm2tfm127509 +Node: Encoding file format130612 +Node: Special font effects134816 +Node: Afm2tfm options137076 +Node: psfonts.map140601 +Node: Color145331 +Node: Color macro files146375 +Node: User-definable colors149568 +Node: Color subtleties150844 +Node: Ted Turner152496 +Node: Color device configuration153721 +Node: Color support details156165 +Node: Color specifications156543 +Node: Color specials157947 +Node: Index160076 End Tag Table diff --git a/Master/texmf-dist/doc/info/kpathsea.info b/Master/texmf-dist/doc/info/kpathsea.info index acce2b11b14..57d9c99d386 100644 --- a/Master/texmf-dist/doc/info/kpathsea.info +++ b/Master/texmf-dist/doc/info/kpathsea.info @@ -1,9 +1,9 @@ -This is kpathsea.info, produced by makeinfo version 6.3 from +This is kpathsea.info, produced by makeinfo version 6.5 from kpathsea.texi. This file documents the Kpathsea library for path searching. - Copyright (C) 1996-2017 Karl Berry & Olaf Weber. + Copyright (C) 1996-2018 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 @@ -37,7 +37,7 @@ Kpathsea library **************** This manual documents the Kpathsea library for path searching. It -corresponds to version 6.2.3, released in April 2017. +corresponds to version 6.3.0, released in February 2018. * Menu: @@ -61,8 +61,8 @@ File: kpathsea.info, Node: Introduction, Next: unixtex.ftp, Prev: Top, Up: T 1 Introduction ************** -This manual corresponds to version 6.2.3 of the Kpathsea library, -released in April 2017. +This manual corresponds to version 6.3.0 of the Kpathsea library, +released in February 2018. The library's fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do when @@ -80,27 +80,29 @@ this library: Other software that we do not maintain also uses it. Kpathsea is now maintained as part of the TeX Live distribution -(<http://tug.org/texlive>). For information on configuration, building, -installing, and more, *note (tlbuild)::. +(<http://tug.org/texlive>), which includes several more Kpathsea-using +programs. For information on configuration, building, installing, and +more, *note (tlbuild)::. The library is still actively maintained. If you have comments or suggestions, please send along (*note Reporting bugs::). The Kpathsea library is distributed under the GNU Library General -Public License (LGPL). In short, this means if you write a program using -the library, you must (offer to) distribute the source to the library, -along with any changes you have made, and allow anyone to modify the -library source and distribute their modifications. It does not mean you -have to distribute the source to your program, although we hope you -will. See accompanying files for the text of the GNU licenses, or -<http://www.gnu.org/licenses>. +Public License (LGPL), version 2.1 or (at your option) any later +version. In short, this means if you write a program using the library, +you must (offer to) distribute the source to the library, along with any +changes you have made, and allow anyone to modify the library source and +distribute their modifications. It does not mean you have to distribute +the source to your program using the library, although we hope you will. +See accompanying files for the text of the GNU licenses, or +<http2://www.gnu.org/licenses>. If you know enough about TeX to be reading this manual, then you (or your institution) should consider joining the TeX Users Group (if you're already a member, thanks!). TUG produces the periodical 'TUGboat', sponsors an annual meeting and publishes the proceedings, and arranges courses on TeX for all levels of users throughout the world. See -<http://tug.org> for information. +<https://tug.org> for information. * Menu: @@ -185,14 +187,13 @@ continues. Karl had been looking for some time for someone to take up part of the burden, and I volunteered. [Karl writes again.] Indeed, time goes on. As of 2006 or so, Olaf's -available time for Kpathsea became rather reduced, and I started taking -overall care of it again, although I did not do any significant new -development. In 2009, Taco Hoekwater made a major rearrangement to make -the library suitable for use within the MetaPost library (*note -Programming overview::). Also, for some years now, Peter Breitenlohner -has made many improvements to the infrastructure and kept up-to-date -with respect to the overall TeX Live build, where Kpathsea is now -maintained. +available time for Kpathsea was reduced, and I started taking overall +care of it again, although I did not do any significant new development. +In 2009, Taco Hoekwater implemented a major rearrangement to make the +library suitable for use within the MetaPost library (*note Programming +overview::). Also, for some years now, Peter Breitenlohner has made +many improvements to the infrastructure and kept it up-to-date with +respect to the overall TeX Live build, where Kpathsea is now maintained. File: kpathsea.info, Node: unixtex.ftp, Next: Security, Prev: Introduction, Up: Top @@ -200,31 +201,30 @@ File: kpathsea.info, Node: unixtex.ftp, Next: Security, Prev: Introduction, 2 'unixtex.ftp': Obtaining TeX ****************************** -This is <ftp://ftp.tug.org/tex/unixtex.ftp>, last updated 13 June 2010. -Also available as <http://www.tug.org/unixtex.ftp>. Email -<tex-k@tug.org> with comments or questions. +This is <https://tug.org/tex/unixtex.ftp>, last updated 28 November +2017. Email <tex-k@tug.org> with comments or questions. The principal free TeX distribution for Unix-like systems is TeX Live, on the web at <http://tug.org/texlive>. The pages there describe -many ways to acquire and build TeX, over the Internet or on physical +many ways to acquire and.or build TeX, over the Internet or on physical media, both the sources and precompiled binaries for many systems, either standalone or as part of various operating system distributions. - Web2C, Kpathsea, Dvips, and Dviljk are no longer released as a + Web2c, Kpathsea, Dvips, and Dviljk are no longer released as a separate packages. Their sources are now maintained as part of TeX Live. The host ftp.cs.stanford.edu is the original source for the files for which Donald Knuth is directly responsible: 'tex.web', 'plain.tex', etc. -However, unless you want to undertake the very significant project of -building your TeX installation from scratch, it is far more reliable and -less work to retrieve these files as part of a larger package +However, unless you want to undertake the project of building your TeX +installation from scratch, it is more reliable and less work to retrieve +these files as part of a larger package. In any case, the Stanford ftp site is not the canonical source for anything except what was created as part of Knuth's original TeX, so do not rely on any other files available there being up-to-date. The best place to check for up-to-date files is CTAN (the Comprehensive TeX -Archive Network), <http://www.ctan.org>. +Archive Network), <https://ctan.org>. File: kpathsea.info, Node: Security, Next: TeX directory structure, Prev: unixtex.ftp, Up: Top @@ -379,6 +379,7 @@ provides. For information about searching for particular file types * Searching overview:: Basic scheme for searching. * Path sources:: Where search paths can be defined. * Path expansion:: Special constructs in search paths. +* Casefolding search:: Fallback to case-insensitive search. * Filename database:: Using an externally-built list to search. * Invoking kpsewhich:: Standalone path lookup. @@ -420,10 +421,16 @@ the disk for them. Therefore, if you fail to update 'ls-R' when you install a new VF file, it will not be found. Each path element is checked in turn: first the database, then the -disk. If a match is found, the search stops and the result is returned. -This avoids possibly-expensive processing of path specifications that -are never needed on a particular run. (Unless the search explicitly -requested all matches.) +disk. If a match is found, the search stops and the result is returned +(unless the search explicitly requested all matches). This avoids +possibly-expensive processing of path specifications that are never +needed on a particular run. + + On Unix-like systems, if no match is found by any of the above, and +the path element allows checking the filesystem (per the above), a final +check is made for a case-insensitive match. Thus, looking for a name +like './FooBar.TeX' will match a file './foobar.tex', and vice versa. +This is not done on Windows. *Note Casefolding search::. Although the simplest and most common path element is a directory name, Kpathsea supports additional features in search paths: layered @@ -436,7 +443,8 @@ order as the sections. Exception to all of the above: If the filename being searched for is absolute or explicitly relative, i.e., starts with '/' or './' or '../', -Kpathsea simply checks if that file exists. +Kpathsea simply checks if that file exists, with a fallback to a +casefolding match if needed and enabled, as described above. Ordinarily, if Kpathsea tries to access a file or directory that cannot be read, it gives a warning. This is so you will be alerted to @@ -456,8 +464,8 @@ File: kpathsea.info, Node: Path sources, Next: Path expansion, Prev: Searchin 5.2 Path sources ================ -A search path can come from many sources. In the order in which -Kpathsea uses them: +A search path or other configuration value can come from many sources. +In the order in which Kpathsea looks for them: 1. A user-set environment variable, e.g., 'TEXINPUTS'. Environment variables with an underscore and the program name appended @@ -571,7 +579,7 @@ anyway, since the 'sh' process couldn't affect its parent's environment. The implementation of all this is in 'kpathsea/cnf.c'. -File: kpathsea.info, Node: Path expansion, Next: Filename database, Prev: Path sources, Up: Path searching +File: kpathsea.info, Node: Path expansion, Next: Casefolding search, Prev: Path sources, Up: Path searching 5.3 Path expansion ================== @@ -580,7 +588,9 @@ Kpathsea recognizes certain special characters and constructions in search paths, similar to that in shells. As a general example: '~$USER/{foo,bar}//baz' expands to all subdirectories under directories 'foo' and 'bar' in $USER's home directory that contain a directory or -file 'baz'. These expansions are explained in the sections below. +file 'baz'. + + These expansions are explained in the sections below. * Menu: @@ -797,9 +807,156 @@ And if you can find a way to _solve_ the problem, please let me know. 'kpathsea/elt-dirs.c'. -File: kpathsea.info, Node: Filename database, Next: Invoking kpsewhich, Prev: Path expansion, Up: Path searching +File: kpathsea.info, Node: Casefolding search, Next: Filename database, Prev: Path expansion, Up: Path searching + +5.4 Casefolding search +====================== + +In Kpathsea version 6.3.0 (released with TeX Live 2018), a new fallback +search was implemented on Unix-like systems, including Macs: for each +path element in turn, if no match is found by the normal search, and the +path element allows for checking the filesystem, a second check is made +for a case-insensitive match. + + This is enabled at compile-time on Unix systems, and enabled at +runtime by setting the configuration variable 'texmf_casefold_search', +to a true value, e.g., '1'; this is done by default in TeX Live. + +* Menu: + +* Rationale: Casefolding rationale. +* Examples: Casefolding examples. + + +File: kpathsea.info, Node: Casefolding rationale, Next: Casefolding examples, Up: Casefolding search + +5.4.1 Casefolding rationale +--------------------------- + +The purpose of the fallback casefolding search is to ease moving complex +documents between case-insensitive (file)systems and case-sensitive +ones. In particular, Apple decided to make the default filesystem on +Macs be case-insensitive some years ago, and this has exacerbated a +problem of people creating documents that use, say, an image under the +name 'foo.jpg', while the actual file is named 'foo.JPG' or 'Foo.jpg'. +It works on the Mac but if the document is transferred and run on a +standard case-sensitive Unix (file)system, the file can't be found, due +only to differences in case. + + This same problematic scenario has always existed on Windows, but for +whatever reason, it has become much more common since Apple also went to +a case-insensitive filesystem. Hence the move to change the Kpathsea +behavior now. + + The fallback case-insensitive search is omitted at compile-time on +Windows, where (for practical purposes) all file names are +case-insensitive at the kernel level, and so the normal search will +already have definitively matched or not. Therefore, search results in +unusual cases can be different on Windows and Unix--but this has always +been true. + + +File: kpathsea.info, Node: Casefolding examples, Prev: Casefolding rationale, Up: Casefolding search + +5.4.2 Casefolding examples +-------------------------- + +The casefolding implementation prefers exact matches to casefolded +matches within a given path element, so as to retain most compatibility. +Backward compatibility is not perfect, however, as a casefolded match +may be found in an earlier path element than an exact match was +previously found (see example #4 below). Still, preferring the match in +the earlier element seemed potentially less confusing than otherwise, +and is in fact consistent with past behavior on Windows. Since case +mismatches are rare to begin with, and name collisions with respect only +to case thus even more rare, the hope is that it will not cause +difficulties in practice. + + If it's desirable in a given situation to have the exact same search +behavior as previously, that can be accomplished by setting the +configuration variable 'texmf_casefold_search' to '0' (*note Path +sources::). + + Some examples to illustrate the new behavior follow. + + Example #1: suppose the file './foobar.tex' exists. Now, searching +for './FooBar.TeX' (or any other case variation) will succeed, returning +'./foobar.tex'--the name as stored on disk. In previous releases, or if +'texmf_casefold_search' is false, the search would fail. + + Example #2: suppose we are using a case-sensitive (file)system, and +the search path is '.:/somedir', and the files './foobar.tex' and +'/somedir/FooBar.TeX' both exist. Both now and previously, searching +for 'foobar.tex' returns './foobar.tex'. However, searching for +'FooBar.TeX' now returns './foobar.tex' instead of +'/somedir/FooBar.TeX'; this is the incompatibility mentioned above. +Also (as expected), searching for 'FOOBAR.TEX' (or whatever variation) +will now return './foobar.tex', whereas before it would fail. Searching +for all ('kpsewhich --all') 'foobar.tex' will return both matches. + + Example #3: same as example #2, but on a case-insensitive +(file)system: both now and previously, searching for 'FooBar.TeX' +returns './foobar.tex', since the system considers that a match. The +Kpathsea casefolding never comes into play. + + Example #4: if we have (on a case-sensitive system) both +'./foobar.tex' and './FOOBAR.TEX', searching with the exact case returns +that exact match, now and previously. Searching for 'FooBar.tex' will +now return one or the other (chosen arbitrarily), rather than failing. +Perhaps unexpectedly, searching for all 'foobar.tex' or 'FooBar.tex' +will also return only one or the other, not both (see more below). + + Example #5: the font file 'STIX-Regular.otf' is included in TeX Live +in the system directory 'texmf-dist/fonts/opentype/public/stix'. +Because Kpathsea never searches the disk in the big system directory, +the casefolding is not done, and a search for 'stix-regular.otf' will +fail (on case-sensitive systems), as it always has. + + The caveat about not searching the disk amounts to saying that +casefolding does not happen in the trees specified with '!!' (*note +ls-R::), that is, where only database ('ls-R') searching is done. In +TeX Live, that is the 'texmf-local' and 'texmf-dist' trees (also +'$TEXMFSYSCONFIG' and '$TEXMFSYSVAR', but those are rarely noticed). +The rationale for this is that in practice, case mangling happens with +user-created files, not with packages distributed as part of the TeX +system. + + One more caveat: the purpose of 'kpsewhich' is to exercise the path +searching in Kpathsea as it is actually done. Therefore, as shown +above, 'kpsewhich --all' will not return all matches regardless of case +within a given path element. If you want to find all matches in all +directories, 'find' is the best tool, although the setup takes a couple +steps: + + kpsewhich -show-path=tex >/tmp/texpath # search path specification + kpsewhich -expand-path="`cat /tmp/texpath`" >/tmp/texdirs # all dirs + tr ':' '\n' </tmp/texdirs >/tmp/texdirlist # colons to newlines + find `cat /tmp/texdirlist` -iname somefile.tex -print </tmp/texdirlist + + Sorry that it's annoyingly lengthy, but implementing this inside +Kpathsea would be a lot of error-prone trouble for something that is +only useful for debugging. If your 'find' does not support '-iname', +you can get GNU Find from <https://www.gnu.org/software/findutils>. + + The casefolding search is implemented in the source file +'kpathsea/pathsearch.c'. Two implementation points: + + * Kpathsea never tries to check if a given directory resides on a + case-insensitive filesystem, because there is no efficient and + portable way to do so. All it does is try to see if a potential + file name is a readable normal file (with, usually, the 'access' + system call). + + * Kpathsea does not do any case-insensitive matching of the + directories along the path. It's not going to find + '/Some/Random/file.tex' when looking for '/some/random/file.tex'. + The casefolding only happens with the elements of the leaf + directory. + + +File: kpathsea.info, Node: Filename database, Next: Invoking kpsewhich, Prev: Casefolding search, Up: Path searching -5.4 Filename database ('ls-R') +5.5 Filename database ('ls-R') ============================== Kpathsea goes to some lengths to minimize disk accesses for searches @@ -827,7 +984,7 @@ filename conventions in source files. File: kpathsea.info, Node: ls-R, Next: Filename aliases, Up: Filename database -5.4.1 'ls-R' +5.5.1 'ls-R' ------------ As mentioned above, you must name the main filename database 'ls-R'. @@ -887,7 +1044,7 @@ paths. File: kpathsea.info, Node: Filename aliases, Next: Database format, Prev: ls-R, Up: Filename database -5.4.2 Filename aliases +5.5.2 Filename aliases ---------------------- In some circumstances, you may wish to find a file under several names. @@ -915,7 +1072,7 @@ aliases. File: kpathsea.info, Node: Database format, Prev: Filename aliases, Up: Filename database -5.4.3 Database format +5.5.3 Database format --------------------- The "database" read by Kpathsea is a line-oriented file of plain text. @@ -958,7 +1115,7 @@ the '-R' option, as follows. File: kpathsea.info, Node: Invoking kpsewhich, Prev: Filename database, Up: Path searching -5.5 'kpsewhich': Standalone path searching +5.6 'kpsewhich': Standalone path searching ========================================== The Kpsewhich program exercises the path searching functionality @@ -985,7 +1142,7 @@ accepted. File: kpathsea.info, Node: Path searching options, Next: Specially-recognized files, Up: Invoking kpsewhich -5.5.1 Path searching options +5.6.1 Path searching options ---------------------------- Kpsewhich looks up each non-option argument on the command line as a @@ -998,6 +1155,16 @@ filename, and returns the first file found. more than one match, just one will be reported (chosen effectively at random). +'--casefold-search' +'--no-casefold-search' + Explicitly enable or disable the fallback to a case-insensitive + search on Unix platforms (*note Casefolding search::); no effect on + Windows. The default is enabled, set in 'texmf.cnf'. Disabling + ('--no-casefold-search') does not mean that searches magically + become case-sensitive when the underlying (file)system is + case-insensitive, it merely means that Kpathsea does not do any + casefolding itself. + '--dpi=NUM' Set the resolution to NUM; this only affects 'gf' and 'pk' lookups. '-D' is a synonym, for compatibility with Dvips. Default is 600. @@ -1198,7 +1365,7 @@ filename, and returns the first file found. File: kpathsea.info, Node: Specially-recognized files, Next: Auxiliary tasks, Prev: Path searching options, Up: Invoking kpsewhich -5.5.2 Specially-recognized files for 'kpsewhich' +5.6.2 Specially-recognized files for 'kpsewhich' ------------------------------------------------ 'kpsewhich' recognizes a few special filenames on the command line and @@ -1248,7 +1415,7 @@ about the above configuration files (among others). File: kpathsea.info, Node: Auxiliary tasks, Next: Standard options, Prev: Specially-recognized files, Up: Invoking kpsewhich -5.5.3 Auxiliary tasks +5.6.3 Auxiliary tasks --------------------- Kpsewhich provides some features in addition to path lookup as such: @@ -1310,7 +1477,7 @@ Kpsewhich provides some features in addition to path lookup as such: File: kpathsea.info, Node: Standard options, Prev: Auxiliary tasks, Up: Invoking kpsewhich -5.5.4 Standard options +5.6.4 Standard options ---------------------- Kpsewhich accepts the standard GNU options: @@ -1328,21 +1495,21 @@ File: kpathsea.info, Node: TeX support, Next: Programming, Prev: Path searchi ************* Although the basic features in Kpathsea can be used for any type of path -searching, it came about (like all libraries) with a specific -application in mind: I wrote Kpathsea specifically for TeX system -programs. I had been struggling with the programs I was using (Dvips, -Xdvi, and TeX itself) having slightly different notions of how to -specify paths; and debugging was painful, since no code was shared. +searching, it came about, as usual, with a specific application in mind: +I wrote Kpathsea specifically for TeX system programs. I had been +struggling with the programs I was using (Dvips, Xdvi, and TeX itself) +having slightly different notions of how to specify paths; and debugging +was painful, since no code was shared. Therefore, Kpathsea provides some TeX-specific formats and features. -Indeed, many of the supposedly generic path searching features were +Indeed, many of the purportedly generic path searching features were provided because they seemed useful in that conTeXt (font lookup, particularly). Kpathsea provides a standard way to search for files of any of the supported file types; glyph fonts are a bit different than all the rest. -Searches are based solely on filenames, not file contents--if a GF file -is named 'cmr10.600pk', it will be found as a PK file. +Searches are based solely on names of files, not their contents--if a GF +file is (mis)named 'cmr10.600pk', it will be found as a PK file. * Menu: @@ -1733,14 +1900,22 @@ found are read; earlier definitions override later ones. The format of fontmap files is straightforward: - * Comments start with '%' and continue to the end of the line. + * Comments start with the last '%' on a line and continue to the end + of the line. (This provides for names that include a %, + ill-advised as that may be.) + * Blank lines are ignored. + * Each nonblank line is broken up into a series of "words": a sequence of non-whitespace characters. + * If the first word is 'include', the second word is used as a filename, and it is searched for and read. + * Otherwise, the first word on each line is the true filename; + * the second word is the alias; + * subsequent words are ignored. If an alias has an extension, it matches only those files with that @@ -2065,7 +2240,8 @@ File: kpathsea.info, Node: Programming, Next: Reporting bugs, Prev: TeX suppo ************* This chapter is for programmers who wish to use Kpathsea. *Note -Introduction::, for the conditions under which you may do so. +Introduction::, for the conditions under which you may do so (in short, +it is released under LGPLv2.1 or later). * Menu: @@ -2081,22 +2257,24 @@ File: kpathsea.info, Node: Programming overview, Next: Calling sequence, Up: ======================== Aside from this manual, your best source of information is the source to -the programs that use Kpathsea (*note Introduction::). Of those, Dviljk -is probably the simplest, and hence a good place to start. Xdvik adds -VF support and the complication of X resources. Dvipsk adds the -complication of its own config files. Web2c is source code I also -maintain, so it uses Kpathsea rather straightforwardly, but is of course -complicated by the Web to C translation. Finally, Kpsewhich is a small -utility program whose sole purpose is to exercise the main -path-searching functionality. +the programs that use Kpathsea (*note Introduction::). First, Kpsewhich +is a small utility program whose sole purpose is to exercise the main +path-searching functionality. Of the drivers, Dviljk is probably the +simplest full application program. Xdvik adds VF support and the +complication of X resources. Dvipsk adds the complication of its own +config files. Web2c is source code I also maintain, so it uses Kpathsea +rather straightforwardly, but is of course complicated by the Web to C +translation. When looking at these program sources, you should know that previous -versions of the library had a different programming interface, to -support re-entrancy. In that interface the library function names were -prefixed with 'kpse_' instead of 'kpathsea_', and they did not need an -instance variable as first argument. This change was made in 2009. -Some of the programs mentioned above may still be using the previous -interface. +versions of the library had a different programming interface; the +current interface supports re-entrancy. Historically, the library +function names were prefixed with 'kpse_' instead of 'kpathsea_', and +they did not need an instance variable as first argument. This change +was made in 2009. The old functions will never disappear, and can +reliably continue to be used when they suffice, as they do for the +programs above. The main application using the re-entrant API is the +MetaPost library used by MetaPost and LuaTeX. Beyond these examples, the '.h' files in the Kpathsea source describe the interfaces and functionality (and of course the '.c' files define @@ -2763,38 +2941,42 @@ Index * $ expansion: Variable expansion. (line 6) * --all: Path searching options. (line 12) +* --casefold-search: Path searching options. + (line 18) * --color=tty: ls-R. (line 21) * --debug=NUM: Auxiliary tasks. (line 9) * --dpi=NUM: Path searching options. - (line 17) + (line 27) * --engine=NAME: Path searching options. - (line 21) + (line 31) * --expand-braces=STRING: Auxiliary tasks. (line 12) * --expand-path=STRING: Auxiliary tasks. (line 16) * --expand-var=STRING: Auxiliary tasks. (line 34) * --format=NAME: Path searching options. - (line 37) + (line 47) * --help: Standard options. (line 8) * --help-formats: Auxiliary tasks. (line 39) * --interactive: Path searching options. - (line 119) + (line 129) * --mktex=FILETYPE: Path searching options. - (line 124) + (line 134) * --mode=STRING: Path searching options. - (line 130) + (line 140) * --must-exist: Path searching options. - (line 135) + (line 145) +* --no-casefold-search: Path searching options. + (line 18) * --no-mktex=FILETYPE: Path searching options. - (line 124) + (line 134) * --path=STRING: Path searching options. - (line 140) + (line 150) * --progname=NAME: Path searching options. - (line 148) + (line 158) * --safe-in-name=NAME: Auxiliary tasks. (line 45) * --safe-out-name=NAME: Auxiliary tasks. (line 45) * --show-path=NAME: Auxiliary tasks. (line 51) * --subdir=STRING: Path searching options. - (line 153) + (line 163) * --var-value=VARIABLE: Auxiliary tasks. (line 57) * --version: Standard options. (line 11) * --with-mktextex-default: mktex configuration. (line 12) @@ -2807,7 +2989,9 @@ Index * -1 debugging value: Debugging. (line 23) * -A option to ls: ls-R. (line 33) * -D NUM: Path searching options. - (line 17) + (line 27) +* -iname, find predicate: Casefolding examples. + (line 78) * -L option to ls: ls-R. (line 38) * . directories, ignored: ls-R. (line 33) * . files: ls-R. (line 33) @@ -2928,8 +3112,10 @@ Index (line 31) * { expansion: Brace expansion. (line 6) * ~ expansion: Tilde expansion. (line 6) -* absolute filenames: Searching overview. (line 52) -* access warnings: Searching overview. (line 56) +* absolute filenames: Searching overview. (line 58) +* access system call: Casefolding examples. + (line 86) +* access warnings: Searching overview. (line 63) * AFMFONTS: Supported file formats. (line 22) * aliases for fonts: Fontmap. (line 6) @@ -2945,6 +3131,8 @@ Index (line 16) * append-only directories and mktexpk: Security. (line 36) * appendonlydir: mktex configuration. (line 60) +* Apple filesystem, case-insensitive: Casefolding rationale. + (line 6) * arguments to mktex: mktex script arguments. (line 6) * argv[0]: Calling sequence. (line 14) @@ -2974,9 +3162,14 @@ Index * bugs, reporting: Reporting bugs. (line 6) * c-*.h: Calling sequence. (line 117) * c-auto.h: Programming overview. - (line 33) + (line 35) * cache of fonts, local: Security. (line 22) * calling sequence: Calling sequence. (line 6) +* casefolding examples: Casefolding examples. + (line 6) +* casefolding fallback rationale: Casefolding rationale. + (line 6) +* casefolding search: Casefolding search. (line 6) * ChangeLog entry: Bug checklist. (line 52) * checklist for bug reports: Bug checklist. (line 6) * checksum: Suppressing warnings. @@ -2994,7 +3187,7 @@ Index (line 23) * comments, in fontmap files: Fontmap. (line 27) * comments, in texmf.cnf: Config files. (line 27) -* comments, making: Introduction. (line 28) +* comments, making: Introduction. (line 29) * common features in glyph lookup: Basic glyph lookup. (line 6) * common problems: Common problems. (line 6) * compilation value, source for path: Path sources. (line 20) @@ -3002,14 +3195,14 @@ Index (line 6) * compiler bugs, finding: TeX or Metafont failing. (line 24) -* conditions for use: Introduction. (line 31) +* conditions for use: Introduction. (line 32) * config files: Config files. (line 6) * config files, for Kpathsea-using programs: Calling sequence. (line 47) * config files, programming with: Programming with config files. (line 6) * config.h: Programming overview. - (line 33) + (line 35) * config.log: Bug checklist. (line 24) * config.ps: Specially-recognized files. (line 16) @@ -3075,7 +3268,7 @@ Index * ENCFONTS: Supported file formats. (line 61) * engine name: Path searching options. - (line 21) + (line 31) * environment variable, source for path: Path sources. (line 9) * environment variables for TeX: Supported file formats. (line 6) @@ -3084,17 +3277,19 @@ Index (line 14) * epoch, seconds since: Logging. (line 15) * error message macros: Calling sequence. (line 22) +* examples, of casefolding searches: Casefolding examples. + (line 6) * excessive startup time: Slow path searching. (line 6) * expand.c: Brace expansion. (line 26) * expanding symlinks: Calling sequence. (line 31) * expansion, default: Default expansion. (line 6) -* expansion, path element: Searching overview. (line 43) +* expansion, path element: Searching overview. (line 49) * expansion, search path: Path expansion. (line 6) * expansion, subdirectory: Subdirectory expansion. (line 6) * expansion, tilde: Tilde expansion. (line 6) * expansion, variable: Variable expansion. (line 6) -* explicitly relative filenames: Searching overview. (line 52) +* explicitly relative filenames: Searching overview. (line 58) * extensions, filename: File lookup. (line 24) * externally-built filename database: Filename database. (line 6) * extra colons: Default expansion. (line 6) @@ -3109,14 +3304,18 @@ Index * file lookup: File lookup. (line 6) * file permissions: Security. (line 47) * file types, registering new: Programming overview. - (line 39) + (line 41) * filename aliases: Filename aliases. (line 6) * filename database: Filename database. (line 6) * filenames, absolute or explicitly relative: Searching overview. - (line 52) + (line 58) * files, unable to find: Unable to find files. (line 6) * filesystem search: Searching overview. (line 22) +* filesystem, case-(in)sensitive: Casefolding rationale. + (line 6) +* Findutils, GNU package: Casefolding examples. + (line 78) * floating directories: Searching overview. (line 22) * fmtutil: mktex script names. (line 10) * fmtutil.cnf: Specially-recognized files. @@ -3142,7 +3341,7 @@ Index (line 239) * fopen, redefined: Debugging. (line 54) * format of external database: Database format. (line 6) -* ftp.cs.stanford.edu: unixtex.ftp. (line 20) +* ftp.cs.stanford.edu: unixtex.ftp. (line 19) * ftp.tug.org: unixtex.ftp. (line 6) * fundamental purpose of Kpathsea: Introduction. (line 6) * gdb, recommended: Bug checklist. (line 58) @@ -3161,7 +3360,7 @@ Index (line 25) * GNU C compiler bugs: TeX or Metafont failing. (line 19) -* GNU General Public License: Introduction. (line 31) +* GNU General Public License: Introduction. (line 32) * group-writable directories: Security. (line 40) * GSFTOPK_DEBUG (128): Debugging. (line 88) * hash table buckets, printing: Debugging. (line 105) @@ -3172,21 +3371,21 @@ Index * home directories in paths: Tilde expansion. (line 6) * HOME, as ~ expansion: Tilde expansion. (line 6) * identifiers, characters valid in: Config files. (line 47) -* include fontmap directive: Fontmap. (line 30) +* include fontmap directive: Fontmap. (line 36) * INDEXSTYLE: Supported file formats. (line 84) * input lines, reading: Calling sequence. (line 110) * interactive query: Path searching options. - (line 119) -* interface, not frozen: Introduction. (line 28) + (line 129) +* interface, not frozen: Introduction. (line 29) * introduction: Introduction. (line 6) * kdebug:: Debugging. (line 105) * kdefault.c: Default expansion. (line 48) * Knuth, Donald E.: History. (line 6) -* Knuth, Donald E., archive of programs by: unixtex.ftp. (line 20) +* Knuth, Donald E., archive of programs by: unixtex.ftp. (line 19) * Kpathsea config file, source for path: Path sources. (line 17) * kpathsea.h: Programming overview. - (line 24) + (line 26) * kpathsea_cnf_get: Programming with config files. (line 23) * KPATHSEA_DEBUG: Calling sequence. (line 28) @@ -3231,7 +3430,7 @@ Index (line 21) * leaf directory trick: Subdirectory expansion. (line 22) -* license for using the library: Introduction. (line 31) +* license for using the library: Introduction. (line 32) * LIGFONTS: Supported file formats. (line 88) * lines, reading arbitrary-length: Calling sequence. (line 110) @@ -3239,13 +3438,15 @@ Index * local cache of fonts: Security. (line 22) * log file: Logging. (line 6) * logging successful searches: Logging. (line 6) -* lost+found directory: Searching overview. (line 56) +* lost+found directory: Searching overview. (line 63) * lostchar: Suppressing warnings. (line 19) * ls-R: Supported file formats. (line 91) * ls-R database file: ls-R. (line 6) * ls-R, simplest build: ls-R. (line 18) +* Mac filesystem, case-insensitive: Casefolding rationale. + (line 6) * MacKenzie, David: History. (line 44) * MacKenzie, David <1>: Subdirectory expansion. (line 22) @@ -3352,7 +3553,7 @@ Index * path searching, standalone: Invoking kpsewhich. (line 6) * path sources: Path sources. (line 6) * pathsearch.h: Programming overview. - (line 24) + (line 26) * pc Pascal compiler: History. (line 12) * pdfglyphlist.txt: Specially-recognized files. (line 31) @@ -3362,7 +3563,7 @@ Index (line 161) * pdftexconfig.tex: Specially-recognized files. (line 34) -* permission denied: Searching overview. (line 56) +* permission denied: Searching overview. (line 63) * permissions, directory: Security. (line 51) * permissions, file: Security. (line 47) * PKFONTS: Supported file formats. @@ -3386,17 +3587,19 @@ Index (line 169) * pxp Pascal preprocessor: History. (line 12) * quoting variable values: Variable expansion. (line 17) +* rationale for casefolding fallback: Casefolding rationale. + (line 6) * re-entrant API: Programming overview. (line 16) * readable: Suppressing warnings. (line 26) * reading arbitrary-length lines: Calling sequence. (line 110) * recording successful searches: Logging. (line 6) -* relative filenames: Searching overview. (line 52) +* relative filenames: Searching overview. (line 58) * reporting bugs: Reporting bugs. (line 6) * resident.c: Calling sequence. (line 47) * resolution, setting: Path searching options. - (line 17) + (line 27) * resolutions, last-resort: Fallback font. (line 6) * retrieving TeX: unixtex.ftp. (line 6) * right-hand side of variable assignments: Config files. (line 56) @@ -3409,6 +3612,7 @@ Index * Sauter fonts, and dynamic source creation: mktex scripts. (line 6) * scripts for file creation: mktex scripts. (line 6) * search path, defined: Searching overview. (line 6) +* search, case-insensitive: Casefolding search. (line 6) * searching for files: File lookup. (line 6) * searching for glyphs: Glyph lookup. (line 6) * searching overview: Searching overview. (line 6) @@ -3451,7 +3655,7 @@ Index * subdirectory searching: Subdirectory expansion. (line 6) * suffixes, filename: File lookup. (line 24) -* suggestions, making: Introduction. (line 28) +* suggestions, making: Introduction. (line 29) * Sun 2: History. (line 12) * supplier directory, omitting: mktex configuration. (line 102) * supplier directory, omitting <1>: mktex configuration. (line 108) @@ -3465,6 +3669,8 @@ Index * symlinks, resolving: Calling sequence. (line 31) * system C compiler bugs: TeX or Metafont failing. (line 19) +* system-dependent casefolding behavior: Casefolding rationale. + (line 6) * T1FONTS: Supported file formats. (line 211) * T1INPUTS: Supported file formats. @@ -3484,16 +3690,16 @@ Index * TeX file lookup: File lookup. (line 6) * TeX glyph lookup: Glyph lookup. (line 6) * TeX support: TeX support. (line 6) -* TeX Users Group: Introduction. (line 40) +* TeX Users Group: Introduction. (line 43) * tex-file.c: File lookup. (line 38) * tex-file.h: Programming overview. - (line 24) + (line 26) * tex-glyph.c: Glyph lookup. (line 26) * tex-glyph.h: Programming overview. - (line 24) + (line 26) * tex-k@tug.org: Mailing lists. (line 6) * tex-k@tug.org (bug address): Reporting bugs. (line 6) -* tex.web: unixtex.ftp. (line 20) +* tex.web: unixtex.ftp. (line 19) * TEXBIB: Supported file formats. (line 30) * TEXBIB <1>: Supported file formats. @@ -3547,6 +3753,7 @@ Index (line 191) * texmfvar: mktex configuration. (line 122) * TEXMFVAR: mktex configuration. (line 123) +* texmf_casefold_search: Casefolding search. (line 12) * TEXPICTS: Supported file formats. (line 79) * TEXPKS: Supported file formats. @@ -3560,7 +3767,7 @@ Index * TEXSIZES: Fallback font. (line 6) * TEXSOURCES: Supported file formats. (line 188) -* TEX_HUSH: Searching overview. (line 56) +* TEX_HUSH: Searching overview. (line 63) * TEX_HUSH <1>: Suppressing warnings. (line 6) * TFMFONTS: Supported file formats. @@ -3592,7 +3799,7 @@ Index (line 31) * unreadable file warnings: Suppressing warnings. (line 27) -* unreadable files: Searching overview. (line 56) +* unreadable files: Searching overview. (line 63) * unusable ls-R warning: ls-R. (line 45) * usage patterns, finding: Logging. (line 6) * USERPROFILE, as ~ expansion: Tilde expansion. (line 6) @@ -3613,7 +3820,7 @@ Index * Walsh, Norman: History. (line 56) * warning about unusable ls-R: ls-R. (line 45) * warning, about missing texmf.cnf: Config files. (line 18) -* warnings, file access: Searching overview. (line 56) +* warnings, file access: Searching overview. (line 63) * warnings, suppressing: Suppressing warnings. (line 6) * WEB2C: Supported file formats. @@ -3621,9 +3828,11 @@ Index * Weber, Olaf: History. (line 73) * WEBINPUTS: Supported file formats. (line 223) -* whitespace, in fontmap files: Fontmap. (line 27) +* whitespace, in fontmap files: Fontmap. (line 31) * whitespace, not ignored on continuation lines: Config files. (line 37) +* Windows and casefolding: Casefolding rationale. + (line 21) * www.tug.org: unixtex.ftp. (line 6) * XDvi: Specially-recognized files. (line 41) @@ -3637,58 +3846,61 @@ Index Tag Table: Node: Top1480 -Node: Introduction2260 -Node: History4206 -Node: unixtex.ftp8803 -Node: Security10298 -Node: TeX directory structure12802 -Node: Path searching16850 -Node: Searching overview17508 -Node: Path sources20903 -Node: Config files21961 -Node: Path expansion25888 -Node: Default expansion26837 -Node: Variable expansion28907 -Node: Tilde expansion30308 -Node: Brace expansion31288 -Node: KPSE_DOT expansion32213 -Node: Subdirectory expansion32726 -Node: Filename database35080 -Node: ls-R36134 -Node: Filename aliases39029 -Node: Database format40207 -Node: Invoking kpsewhich41220 -Node: Path searching options42175 -Node: Specially-recognized files50095 -Node: Auxiliary tasks51450 -Node: Standard options53789 -Node: TeX support54145 -Node: Supported file formats55497 -Node: File lookup63162 -Node: Glyph lookup64911 -Node: Basic glyph lookup66035 -Node: Fontmap66915 -Node: Fallback font69336 -Node: Suppressing warnings70248 -Node: mktex scripts71375 -Node: mktex configuration72590 -Node: mktex script names78393 -Node: mktex script arguments79779 -Node: Programming80658 -Node: Programming overview81180 -Node: Calling sequence83877 -Node: Program-specific files90409 -Node: Programming with config files91432 -Node: Reporting bugs92744 -Node: Bug checklist93422 -Node: Mailing lists96894 -Node: Debugging97569 -Node: Logging102646 -Node: Common problems104513 -Node: Unable to find files104990 -Node: Slow path searching107400 -Node: Unable to generate fonts108775 -Node: TeX or Metafont failing111246 -Node: Index112599 +Node: Introduction2263 +Node: History4336 +Node: unixtex.ftp8932 +Node: Security10357 +Node: TeX directory structure12861 +Node: Path searching16909 +Node: Searching overview17636 +Node: Path sources21455 +Node: Config files22546 +Node: Path expansion26473 +Node: Default expansion27426 +Node: Variable expansion29496 +Node: Tilde expansion30897 +Node: Brace expansion31877 +Node: KPSE_DOT expansion32802 +Node: Subdirectory expansion33315 +Node: Casefolding search35669 +Node: Casefolding rationale36438 +Node: Casefolding examples37777 +Node: Filename database42827 +Node: ls-R43885 +Node: Filename aliases46780 +Node: Database format47958 +Node: Invoking kpsewhich48971 +Node: Path searching options49926 +Node: Specially-recognized files58327 +Node: Auxiliary tasks59682 +Node: Standard options62021 +Node: TeX support62377 +Node: Supported file formats63731 +Node: File lookup71396 +Node: Glyph lookup73145 +Node: Basic glyph lookup74269 +Node: Fontmap75149 +Node: Fallback font77678 +Node: Suppressing warnings78590 +Node: mktex scripts79717 +Node: mktex configuration80932 +Node: mktex script names86735 +Node: mktex script arguments88121 +Node: Programming89000 +Node: Programming overview89573 +Node: Calling sequence92434 +Node: Program-specific files98966 +Node: Programming with config files99989 +Node: Reporting bugs101301 +Node: Bug checklist101979 +Node: Mailing lists105451 +Node: Debugging106126 +Node: Logging111203 +Node: Common problems113070 +Node: Unable to find files113547 +Node: Slow path searching115957 +Node: Unable to generate fonts117332 +Node: TeX or Metafont failing119803 +Node: Index121156 End Tag Table diff --git a/Master/texmf-dist/doc/info/tlbuild.info b/Master/texmf-dist/doc/info/tlbuild.info index 018fed3d4fb..786881058df 100644 --- a/Master/texmf-dist/doc/info/tlbuild.info +++ b/Master/texmf-dist/doc/info/tlbuild.info @@ -1,9 +1,9 @@ -This is tlbuild.info, produced by makeinfo version 6.3 from +This is tlbuild.info, produced by makeinfo version 6.5 from tlbuild.texi. This file documents the TeX Live build system and more. -Copyright (C) 2016-2017 Karl Berry. +Copyright (C) 2016-2018 Karl Berry. Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner. Permission is granted to make and distribute verbatim copies of this @@ -33,7 +33,7 @@ END-INFO-DIR-ENTRY File: tlbuild.info, Node: Top, Next: Introduction, Up: (dir) -Building TeX Live (2017) +Building TeX Live (2018) ************************ For an overview of this manual, *note Introduction::. @@ -49,6 +49,7 @@ For an overview of this manual, *note Introduction::. * Configure options:: List of all configure options. * Cross compilation:: Building on host X for target Y. * Coding conventions:: Conventions to follow. +* Continuous integration:: Automated build testing. * install-tl:: The TeX Live installer. * tlmgr:: The native TeX Live package manager. * Index:: General index. @@ -59,7 +60,8 @@ File: tlbuild.info, Node: Introduction, Next: Overview of build system, Prev: 1 Introduction ************** -This manual (dated April 2017) corresponds to the TeX Live 2017 release. +This manual (dated February 2018) corresponds to the TeX Live 2018 +release. This manual is aimed at system installers and programmers, and focuses on how to configure, build, and develop the TeX Live (TL) @@ -74,13 +76,13 @@ information for different systems, along with For information on acquiring the TL sources, see <http://tug.org/texlive/svn>. - This manual does not duplicate the (primarily user-level) information -found in other TL documentation resources, such as: + This manual does not duplicate the information found in other TL +documentation resources, such as: * The TeX Live web pages: <http://tug.org/texlive>. - * The web page with an overview of how to build the binaries which - are distributed with TeX Live: <http://tug.org/texlive/build.html>. + * The web page describing how to build the binaries which are + distributed with TeX Live: <http://tug.org/texlive/build.html>. * The TeX Live user manual: <http://tug.org/texlive/doc.html>, or run 'texdoc texlive'. @@ -591,12 +593,12 @@ many extra hassles, so don't do that, tempting as it may be. Currently the versions we use are: autoconf (GNU Autoconf) 2.69 - automake (GNU automake) 1.15 + automake (GNU automake) 1.15.1 bison (GNU Bison) 3.0.4 flex 2.6.0 ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.18 - makeinfo (GNU texinfo) 6.1 + makeinfo (GNU texinfo) 6.5 These versions should be used to update the generated files (e.g., 'configure' or 'Makefile.in') in all or parts of the TL tree after their @@ -1120,11 +1122,10 @@ M4 list 'kpse_texk_pkgs' defined in 'm4/kpse-pkgs.m4'. the TeX-specific libraries and is included by adding its name 'PROG' to the M4 list 'kpse_utils_pkgs' in 'm4/kpse-pkgs.m4'. - In either case, apart from the program sources and build system -('configure.ac' and 'Makefile.am'), the subdirectory 'texk/PROG' or -'utils/PROG' must provide a fragment 'ac/withenable.ac' that contains -the M4 macro 'KPSE_ENABLE_PROG' defined in 'm4/kpse-setup.m4' with -'PROG' as the mandatory first argument and three optional arguments: + In either case, the subdirectory 'texk/PROG' or 'utils/PROG' must +provide a fragment 'ac/withenable.ac' that contains the M4 macro +'KPSE_ENABLE_PROG' defined in 'm4/kpse-setup.m4' with 'PROG' as the +mandatory first argument and three optional arguments: 1. a list of required libraries from the TL tree; @@ -1133,13 +1134,58 @@ the M4 macro 'KPSE_ENABLE_PROG' defined in 'm4/kpse-setup.m4' with compilation is not possible, 'x' if the program requires X11 libraries); - 3. and a comment added to the help text for the 'configure' option + 3. a comment added to the help text for the 'configure' option '--enable-PROG' or '--disable-PROG'. If the module requires specific configure options to be seen at the -top-level, they should be defined in an additional fragment 'ac/PROG.ac' +top level, they should be defined in an additional fragment 'ac/PROG.ac' included from 'ac/withenable.ac' and 'configure.ac'. + Usually, the new program is maintained somewhere outside of TeX Live. +In that case, we put the upstream sources into a subdirectory 'PROG-src' +(e.g., 'utils/newprog/newprog-src'). We do not run 'configure' in this +original '...-src' directory, only in our own directory, but we do +compile using the source files in '...-src'. + + So, these are the files that we must generally create: + +'ac/withenable.ac' + The 'KPSE_ENABLE_PROG' call just explained. + +'configure.ac' +'Makefile.am' + By merging the contents of the original 'configure.ac' (if + provided) and a comparable program already in TL. There is no magic + recipe, it's necessary to think about needs to be done in the + original vs. in TeX Live. + +'TLpatches/TL-Changes' + Actions taken after getting the original source tree; typically + removal of derived or unused common files. + +'TLpatches/patch-...' + If any changes are needed to the original sources, record the + patches here so they can be applied next time. And send them + upstream so that perhaps they won't have to be. + +'ChangeLog' + Record all TL-specific changes, now and in the future. + + Then, run GNU 'autoreconf' in the new directory (*note Build system +tools::). After that works, 'svn add' the necessary files, notably +'Makefile.in aclocal.m4 configure', and 'svn:ignore' the Automake cache +'autom4te.cache'. (This is so people checking out the TL source tree do +not have to run any autotools, but can simply run 'configure'.) + + Then, run the TL tool 'reautoconf' in the top-level TL 'source/' +directory, to incorporate the new program into the build tree. + + Then, run (and rerun) a build until the program compiles and tests +successfully, probably involving rerunning autoreconf in the source +directory, 'make' in the build directory, etc. + + After final success, don't forget to commit. + File: tlbuild.info, Node: Adding a new generic library module, Next: Adding a new TeX-specific library module, Prev: Adding a new program module, Up: Extending TeX Live @@ -1864,7 +1910,7 @@ sufficiently recent installed versions of 'tangle', 'ctangle', thus cross compilation is not possible. -File: tlbuild.info, Node: Coding conventions, Next: install-tl, Prev: Cross compilation, Up: Top +File: tlbuild.info, Node: Coding conventions, Next: Continuous integration, Prev: Cross compilation, Up: Top 9 Coding conventions ******************** @@ -1986,7 +2032,85 @@ must be carefully analyzed to make sure that they cannot cause the modification of quantities supposed to be constant. -File: tlbuild.info, Node: install-tl, Next: tlmgr, Prev: Coding conventions, Up: Top +File: tlbuild.info, Node: Continuous integration, Next: install-tl, Prev: Coding conventions, Up: Top + +10 Continuous integration +************************* + +Overview: the sources of TeX Live are subjected to continuous +integration testing on Travis-CI +(<https://travis-ci.org/TeX-Live/texlive-source>) via a git-svn mirror +of the sources that is pushed to Github +(<https://github.com/TeX-Live/texlive-source>). The git-svn mirror is +updated (currently) at 30 minute intervals, and only the last commit +pushed is tested on Travis-CI. + +Transfer from Subversion to Github +---------------------------------- + +git-svn (<https://git-scm.com/docs/git-svn>) is used to check out the +subtree 'Build/source' of the Subversion repository. The author index +file used is not maintained in either Git or Subversion but can be +provided on request. + + The initial checkout was done by invoking + git svn --authors-file usermap clone svn://USER@tug.org/texlive/trunk/Build/source + +where the 'usermap' file maps Subversion user names to name and emails +of the authors. If no user account at <tug.org> is available, anonymous +checkout is possible, too: + git svn --authors-file usermap clone svn://tug.org/texlive/trunk/Build/source + + In the following, we will use _admin_ to refer to a user who has +read/write access to the TeX Live subversion repository, and is also an +administrator of the 'TeX-Live' Team on Github. The above initial +checkout has been carried out by _admin_ on the server 'texlive.info'. + + On Github (<https://github.com>), a new git repository named +'texlive-source' was created by _admin_ within the 'TeX-Live' +"organization" (<https://github.com/TeX-Live>). The remote was added to +the checkout with 'git remote add origin +git@github.com:TeX-Live/texlive-source.git'. + + To automate the update on Github, a new ssh key was generated and +added to the 'texlive-source' repository on Github as deployment key. +This way pushes using this key can only go to the 'texlive-source' +repository and not anywhere else. + + The usage of 'git-svn' requires a strict discipline to keep a linear +history in the master branch. Since we are aiming at a pure mirror +facility, we have decided to further restrict the 'master' branch of the +'texlive-source' repository on Github to changes by _admin_. + + This setup allows other developers to branch off 'master' and push +their branches to the Github repository, but all updates need to come +from the local 'master' (not the one on Github) to Subversion, back to +'master' on 'texlive.info', and from there to Github. + +Automatic update of the Git mirror +---------------------------------- + +_admin_ has installed a cron job on 'texlive.info' running every 30 +minute which essentially runs 'git svn rebase' and 'git push' in the +'master' branch of the checkout. The first command fetches the changes +from the Subversion repository and updates the 'master' branch with +them, the second one pushes changes (if available) to Github. + +CI testing on Travis-CI +----------------------- + +The 'source' tree of TeX Live contains a top-level file '.travis.yml' +which controls the automatic testing on Travis-CI. _admin_ has +registered to Travis-CI and allowed access to the Github's 'TeX-Live' +organization's 'texlive-source' repository. The default settings are to +build the last commit of each push. No further action is necessary on +Travis-CI. + + If changes have been pushed via the cron job above, Travis-CI will +automatically checkout the last pushed commit and try building it. + + +File: tlbuild.info, Node: install-tl, Next: tlmgr, Prev: Continuous integration, Up: Top Appendix A install-tl ********************* @@ -1998,7 +2122,6 @@ Appendix A install-tl * install-tl DESCRIPTION:: * install-tl REFERENCES:: * install-tl OPTIONS:: -* install-tl PROFILES:: * install-tl ENVIRONMENT VARIABLES:: * install-tl AUTHORS AND COPYRIGHT:: @@ -2018,9 +2141,7 @@ A.2 SYNOPSIS install-tl [_option_]... - install-tl-windows.bat [_option_]... - - install-tl-advanced.bat [_option_]... + install-tl.bat [_option_]... File: tlbuild.info, Node: install-tl DESCRIPTION, Next: install-tl REFERENCES, Prev: install-tl SYNOPSIS, Up: install-tl @@ -2029,22 +2150,21 @@ A.3 DESCRIPTION =============== This installer creates a runnable TeX Live installation from various -media, including over the network, from local hard disk, a DVD, etc. -The installer works across all platforms supported by TeX Live. For -information on initially downloading the TeX Live, see -<http://tug.org/texlive/acquire.html>. +media, including over the network. The installer works across all +platforms supported by TeX Live. For information on initially +downloading the TeX Live, see <http://tug.org/texlive/acquire.html>. - The basic idea of TeX Live installation is for you to choose one of -the top-level _schemes_, each of which is defined as a different set of + The basic idea of TeX Live installation is to choose one of the +top-level _schemes_, each of which is defined as a different set of _collections_ and _packages_, where a collection is a set of packages, and a package is what contains actual files. Within the installer, you can choose a scheme, and further customize the set of collections to install, but not the set of the packages. To -work at the package level, use 'tlmgr' (reference just below) after the -initial installation is complete. +do that, use 'tlmgr' (reference below) after the initial installation is +completely. - The default is 'scheme-full', which installs everything, and this is + The default is 'scheme-full', to install everything, and this is highly recommended. @@ -2057,14 +2177,14 @@ Post-installation configuration, package updates, and much more, are handled through *tlmgr*(1), the TeX Live Manager (<http://tug.org/texlive/tlmgr.html>). - The most up-to-date version of this installer documentation is on the -Internet at <http://tug.org/texlive/doc/install-tl.html>. + The most up-to-date version of this documentation is on the Internet +at <http://tug.org/texlive/doc/install-tl.html>. For the full documentation of TeX Live, see <http://tug.org/texlive/doc>. -File: tlbuild.info, Node: install-tl OPTIONS, Next: install-tl PROFILES, Prev: install-tl REFERENCES, Up: install-tl +File: tlbuild.info, Node: install-tl OPTIONS, Next: install-tl ENVIRONMENT VARIABLES, Prev: install-tl REFERENCES, Up: install-tl A.5 OPTIONS =========== @@ -2075,7 +2195,7 @@ by either a space or '='. *-gui* [[=]_module_] - If no _module_ is given, starts the 'perltk' (see below) GUI + If no _module_ is given starts the 'perltk' (see below) GUI installer. If _module_ is given loads the given installer module. Currently @@ -2098,7 +2218,7 @@ by either a space or '='. 'install-tl-advanced.bat'. The 'perltk' and 'wizard' modules, and thus also when calling with - bare '-gui' (with no _module_), require the Perl/Tk module + a bare '-gui' (without _module_), requires the Perl/Tk module (<http://tug.org/texlive/distro.html#perltk>); if Perl/Tk is not available, installation continues in text mode. @@ -2123,9 +2243,8 @@ by either a space or '='. Specify the package repository to be used as the source of the installation, either a local directory via '/path/to/directory' or - a 'file:/' url, or a network location via a 'http://', 'https://', - or 'ftp://' url. (No other protocols are supported, and 'https://' - may not work on all platforms.) + a 'file:/' url, or a network location via a 'http://' or 'ftp://' + url. (No other protocols are supported.) The default is to pick a mirror automatically, using <http://mirror.ctan.org/systems/texlive/tlnet>; the chosen mirror @@ -2140,9 +2259,9 @@ by either a space or '='. -repository http://ctan.example.org/its/ctan/dir/systems/texlive/tlnet - Of course a real hostname and its particular top-level CTAN - directory have to be specified. The list of CTAN mirrors is - available at <http://ctan.org/mirrors>. + Of course a real hostname and its particular top-level CTAN path + have to be specified. The list of CTAN mirrors is available at + <http://ctan.org/mirrors>. If the repository is local, the installation type (compressed or live) is automatically determined, by checking for the presence of @@ -2173,9 +2292,9 @@ by either a space or '='. *-all-options* Normally options not relevant to the current platform are not shown - (e.g., when running on Unix, Windows-specific options are omitted). - Giving this command line option allows configuring such "foreign" - settings. + (i.e., when running on Unix, Windows-specific options are omitted). + Giving this command line option allows configuring settings in the + final 'texlive.tlpdb' that do not have any immediate effect. *-custom-bin* _path_ @@ -2186,12 +2305,9 @@ by either a space or '='. installation will continue as usual, but at the end all files from _path_ are copied over to 'bin/custom/' under your installation directory and this 'bin/custom/' directory is what will be added to - the path for the post-install actions. To install multiple custom - binary sets, manully rename 'custom' before doing each. - - For more information on custom binaries, see - <http://tug.org/texlive/custom-bin.html>. For general information - on building TeX Live, see <http://tug.org/texlive/build.html>. + the path for the post-install actions. (By the way, for + information on building TeX Live, see + <http://tug.org/texlive/build.html>). *-debug-translation* @@ -2208,7 +2324,7 @@ by either a space or '='. *-help*, *-help*, *-?* - Display this help and exit. (This help is on the web at + Display this help and exit (on the web via <http://tug.org/texlive/doc/install-tl.html>). Sometimes the 'perldoc' and/or 'PAGER' programs on the system have problems, possibly resulting in control characters being literally output. @@ -2226,12 +2342,6 @@ by either a space or '='. option is not available via the installer interfaces. USE AT YOUR OWN RISK. -*-init-from-profile* _profile_file_ - - Similar to *-profile* (see *note PROFILES: install-tl PROFILES. - below), but only initializes the installation configuration from - _profile_file_ and then starts the interactive session. - *-logfile* _file_ Write both all messages (informational, debugging, warnings) to @@ -2243,7 +2353,7 @@ by either a space or '='. *-no-cls* - For the text mode installer only: do not clear the screen when + (only for text mode installer) do not clear the screen when entering a new menu (for debugging purposes). *-non-admin* @@ -2265,15 +2375,7 @@ by either a space or '='. This option is turned on by default, and the installation program will fall back to using 'wget' if this is not possible. To disable usage of LWP and persistent connections, use - '-no-persistent-downloads'. - -*-no-verify-downloads* - - By default, if a GnuPG 'gpg' binary is found in PATH, downloads are - verified against a cryptographic signature. This option disables - such verification. The full description is in the Crytographic - Verification section of the 'tlmgr' documentation, e.g., - <http://tug.org/texlive/doc/tlmgr.html#CRYPTOGRAPHIC-VERIFICATION> + '--no-persistent-downloads'. *-portable* @@ -2286,11 +2388,33 @@ by either a space or '='. (hardware/operating system) combination to standard output, and exit. '-print-arch' is a synonym. -*-profile* _profile_file_ - - Load _profile_file_ and do the installation with no user - interaction, that is, a batch (unattended) install. See *note - PROFILES: install-tl PROFILES. below. +*-profile* _profile_ + + Load the file _profile_ and do the installation with no user + interaction, that is, a batch (unattended) install. + + A _profile_ file contains all the values needed to perform an + installation. After a normal installation has finished, a profile + for that exact installation is written to the file + DEST/tlpkg/texlive.profile. That file can be given as the argument + to '-profile' to redo the exact same installation on a different + system, for example. Alternatively, you can use a custom profile, + most easily created by starting from a generated one and changing + values, or an empty file, which will take all the defaults. + + Normally a profile has to specify the value '1' for each collection + to be installed, even if the scheme is specified. This follows + from the logic of the installer in that you can first select a + scheme and then change the collections being installed. But for + convenience there is an exception to this within profiles: If the + profile contains a variable for 'selected_scheme' and _no_ + collection variables at all are defined in the profile, then the + collections which the specified scheme requires are installed. + + Thus, a line 'selected_scheme scheme-medium' together with the + definitions of the installation directories ('TEXDIR', 'TEXMFHOME', + 'TEXMFLOCAL', 'TEXMFSYSCONFIG', 'TEXMFSYSVAR') suffices to install + the medium scheme with all default options. *-q* @@ -2308,8 +2432,8 @@ by either a space or '='. *-v* - Include verbose debugging messages; repeat for maximum debugging: - '-v -v'. (Further repeats are accepted but ignored.) + Include verbose debugging messages; repeat for maximum debugging, + as in '-v -v'. (Further repeats are accepted but ignored.) *-version*, *-version* @@ -2317,143 +2441,13 @@ by either a space or '='. the revisions of the used modules are reported, too. -File: tlbuild.info, Node: install-tl PROFILES, Next: install-tl ENVIRONMENT VARIABLES, Prev: install-tl OPTIONS, Up: install-tl - -A.6 PROFILES -============ - -A _profile_ file contains all the values needed to perform an -installation. After a normal installation has finished, a profile for -that exact installation is written to the file 'tlpkg/texlive.profile'. -In addition, from the text menu one can select 'P' to save the current -setup as a profile at any time. Such a profile file can be given as the -argument to '-profile', for example to redo the exact same installation -on a different system. Alternatively, you can use a custom profile, -most easily created by starting from a generated one and changing -values, or an empty file, which will take all the defaults. - - Within a profile file, each line consists of - - _variable_ [_value_] - - except for comment lines starting with '#'. The possible variable -names are listed below. Values, when present, are either '0' or '1' for -booleans, or strings (which must be specified without any quote -characters). Leading whitespace is ignored. - - If the variable 'selected_scheme' is defined and _no_ collection -variables at all are defined, then the collections required by the -specified scheme (which might change over time) are installed, without -explicitly listing them. This eases maintenance of profile files. If -any collections are specified in a profile, though, then all desired -collections must be given explicitly. - - For example, a line - - selected_scheme scheme-small - - along with definitions for the installation directories (given below -under "path options") suffices to install the "small" scheme with all -default options. The schemes are described in the 'S' menu in the text -installer, or equivalent. - - Besides 'selected_scheme', here is the list of variable names -supported in a profile: - - *collection options* (prefix 'collection-') +File: tlbuild.info, Node: install-tl ENVIRONMENT VARIABLES, Next: install-tl AUTHORS AND COPYRIGHT, Prev: install-tl OPTIONS, Up: install-tl - Collections are specified with a variable name with the prefix -'collection-' followed by a collection name; there is no value. For -instance, 'collection-basic'. The collections are described in the 'C' -menu. - - Schemes and collections (and packages) are ultimately defined by the -files in the 'tlpkg/tlpsrc/' source directory. - - *path options* - - It is best to define all of these, even though they may not be used -in the installation, so as to avoid unintentionally getting a default -value that could cause problems later. - - TEXDIR - TEXMFCONFIG - TEXMFVAR - TEXMFHOME - TEXMFLOCAL - TEXMFSYSCONFIG - TEXMFSYSVAR - - *installer options* (prefix 'instopt_') - -'instopt_adjustpath' (default 0 on Unix, 1 on Windows) - - Adjust 'PATH' environment variable. - -'instopt_adjustrepo' (default 1) - - Set remote repository to a multiplexed CTAN mirror after - installation; see '-repository' above. - -'instopt_letter' (default 0) - - Set letter size paper as the default, instead of a4. - -'instopt_portable' (default 0) - - Install for portable use, e.g., on a USB stick. - -'instopt_write18_restricted' (default 1) - - Enable '\write18' for a restricted set of programs. - - *tlpdb options* (prefix 'tlpdbopt_') - - The definitive list is given in 'tlpkg/TeXLive/TLConfig.pm', in -'%TeXLive::TLConfig::TLPDBOptions', together with explanations. All -items given there _except_ for 'tlpdbopt_location' can be specified. -Here is the current list: - - tlpdbopt_autobackup - tlpdbopt_backupdir - tlpdbopt_create_formats - tlpdbopt_desktop_integration - tlpdbopt_file_assocs - tlpdbopt_generate_updmap - tlpdbopt_install_docfiles - tlpdbopt_install_srcfiles - tlpdbopt_post_code - tlpdbopt_sys_bin - tlpdbopt_sys_info - tlpdbopt_sys_man - tlpdbopt_w32_multi_user - - *platform options* (prefix 'binary_') - - For each supported platform in TeX Live (directories under 'bin/'), -the variable 'binary_'_PLATFORM_ can be set. For example: - - binary_x86_64-linux - - If no 'binary_' variable is specified, the default is whatever the -current machine is running. - - In releases before 2017, many profile variables had different names -(not documented here; see the 'install-tl' source). They are accepted -and transformed to the names given above. When a profile is written, -the names above are always used. - - For more details on all of the above options, consult the TeX Live -installation manual, linked from <http://tug.org/texlive/doc>. - - -File: tlbuild.info, Node: install-tl ENVIRONMENT VARIABLES, Next: install-tl AUTHORS AND COPYRIGHT, Prev: install-tl PROFILES, Up: install-tl - -A.7 ENVIRONMENT VARIABLES +A.6 ENVIRONMENT VARIABLES ========================= For ease in scripting and debugging, 'install-tl' will look for the -following environment variables. They are not of interest for normal +following environment variables. They are not of interest in normal user installations. 'TEXLIVE_INSTALL_ENV_NOCHECK' @@ -2467,19 +2461,10 @@ user installations. Omit creating the ConTeXt cache. This is useful for redistributors. -'TEXLIVE_INSTALL_NO_WELCOME' - - Omit printing the welcome message after successful installation, - e.g., for testing. - 'TEXLIVE_INSTALL_PREFIX' -'TEXLIVE_INSTALL_TEXDIR' - 'TEXLIVE_INSTALL_TEXMFCONFIG' -'TEXLIVE_INSTALL_TEXMFVAR' - 'TEXLIVE_INSTALL_TEXMFHOME' 'TEXLIVE_INSTALL_TEXMFLOCAL' @@ -2488,12 +2473,9 @@ user installations. 'TEXLIVE_INSTALL_TEXMFSYSVAR' - Specify the respective directories. 'TEXLIVE_INSTALL_PREFIX' - defaults to '/usr/local/texlive', while 'TEXLIVE_INSTALL_TEXDIR' - defaults to the release directory within that prefix, e.g., - '/usr/local/texlive/2016'. All the defaults can be seen by running - the installer interactively and then typing 'D' for the directory - menu. +'TEXLIVE_INSTALL_TEXMFVAR' + + Specify the respective directories. 'NOPERLDOC' @@ -2502,15 +2484,13 @@ user installations. File: tlbuild.info, Node: install-tl AUTHORS AND COPYRIGHT, Prev: install-tl ENVIRONMENT VARIABLES, Up: install-tl -A.8 AUTHORS AND COPYRIGHT +A.7 AUTHORS AND COPYRIGHT ========================= This script and its documentation were written for the TeX Live distribution (<http://tug.org/texlive>) and both are licensed under the GNU General Public License Version 2 or later. - $Id: install-tl 44407 2017-05-18 21:25:39Z karl $ - File: tlbuild.info, Node: tlmgr, Next: Index, Prev: install-tl, Up: Top @@ -2525,9 +2505,9 @@ Appendix B tlmgr * tlmgr EXAMPLES:: * tlmgr OPTIONS:: * tlmgr ACTIONS:: -* tlmgr CONFIGURATION FILE FOR TLMGR:: -* tlmgr CRYPTOGRAPHIC VERIFICATION:: * tlmgr USER MODE:: +* tlmgr CONFIGURATION FILE FOR TLMGR:: +* tlmgr TAXONOMIES:: * tlmgr MULTIPLE REPOSITORIES:: * tlmgr GUI FOR TLMGR:: * tlmgr MACHINE-READABLE OUTPUT:: @@ -2539,7 +2519,7 @@ File: tlbuild.info, Node: tlmgr NAME, Next: tlmgr SYNOPSIS, Up: tlmgr B.1 NAME ======== -tlmgr - the native TeX Live Manager +tlmgr - the TeX Live Manager File: tlbuild.info, Node: tlmgr SYNOPSIS, Next: tlmgr DESCRIPTION, Prev: tlmgr NAME, Up: tlmgr @@ -2583,17 +2563,11 @@ B.4 EXAMPLES After successfully installing TeX Live, here are a few common operations with 'tlmgr': -'tlmgr option repository ctan' - 'tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet' Tell 'tlmgr' to use a nearby CTAN mirror for future updates; useful - if you installed TeX Live from the DVD image and want to have - continuing updates. The two commands are equivalent; 'ctan' is - just an alias for the given url. Caveat: 'mirror.ctan.org' - resolves to many different hosts, and they are not perfectly - synchronized; we recommend updating only daily (at most), and not - more often. + if you installed TeX Live from the DVD image and want continuing + updates. 'tlmgr update --list' @@ -2604,11 +2578,10 @@ with 'tlmgr': Make your local TeX installation correspond to what is in the package repository (typically useful when updating from CTAN). -'tlmgr info' _what_ +'tlmgr info' _pkg_ - Display detailed information about a package _what_, such as the - installation status and description, of searches for _what_ in all - packages. + Display detailed information about _pkg_, such as the installation + status and description. For all the capabilities and details of 'tlmgr', please read the following voluminous information. @@ -2690,8 +2663,8 @@ name and its value. 'tlmgr' logs all package actions (install, remove, update, failed updates, failed restores) to a separate log file, by default - 'TEXMFSYSVAR/web2c/tlmgr.log'. This option allows you to specify a - different file for the log. + 'TEXMFSYSVAR/web2c/tlmgr.log'. This option allows you to specific + a different file for the log. *-pause* @@ -2719,15 +2692,6 @@ name and its value. below). Documented only for completeness, as this is only useful in debugging. -*-require-verification* - -*-no-require-verification* - - Instructs 'tlmgr' to only accept signed and verified remotes. In - any other case 'tlmgr' will quit operation. See *note - CRYPTOGRAPHIC VERIFICATION: tlmgr CRYPTOGRAPHIC VERIFICATION. below - for details. - *-usermode* Activates user mode for this run of 'tlmgr'; see *note USER MODE: @@ -2738,16 +2702,6 @@ name and its value. Uses _dir_ for the tree in user mode; see *note USER MODE: tlmgr USER MODE. below. -*-verify-downloads* - -*-no-verify-downloads* - - Enables or disables cryptographic verification of downloaded - database files. A working GnuPG ('gpg') binary needs to be present - in the path, otherwise this option has no effect. See *note - CRYPTOGRAPHIC VERIFICATION: tlmgr CRYPTOGRAPHIC VERIFICATION. below - for details. - The standard options for TeX Live programs are also accepted: '--help/-h/-?', '--version', '-q' (no informational messages), '-v' (debugging messages, can be repeated). For the details about these, see @@ -2758,7 +2712,7 @@ release and about the 'tlmgr' script itself. If '-v' is also given, revision number for the loaded TeX Live Perl modules are shown, too. -File: tlbuild.info, Node: tlmgr ACTIONS, Next: tlmgr CONFIGURATION FILE FOR TLMGR, Prev: tlmgr OPTIONS, Up: tlmgr +File: tlbuild.info, Node: tlmgr ACTIONS, Next: tlmgr USER MODE, Prev: tlmgr OPTIONS, Up: tlmgr B.6 ACTIONS =========== @@ -2771,14 +2725,12 @@ B.6 ACTIONS * tlmgr candidates _pkg_:: * tlmgr check [_option_]... [files|depends|executes|runfiles|all]:: * tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]:: -* tlmgr conf auxtrees [--conffile _file_] [show|add|delete] [_value_]:: * tlmgr dump-tlpdb [--local|--remote]:: * tlmgr generate [_option_]... _what_:: * tlmgr gui:: * tlmgr info [_option_...] [collections|schemes|_pkg_...]:: * tlmgr init-usertree:: * tlmgr install [_option_]... _pkg_...:: -* tlmgr key list|add _file_|remove _keyid_:: * tlmgr option:: * tlmgr paper:: * tlmgr path [--w32mode=user|admin] [add|remove]:: @@ -2788,11 +2740,10 @@ B.6 ACTIONS * tlmgr platform set auto:: * tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...:: * tlmgr print-platform:: +* tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]:: * tlmgr remove [_option_]... _pkg_...:: * tlmgr repository:: -* tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]:: * tlmgr search [_option_...] _what_:: -* tlmgr shell:: * tlmgr uninstall:: * tlmgr update [_option_]... [_pkg_]...:: @@ -2894,8 +2845,8 @@ Executes one (or all) check(s) on the consistency of the installation. *depends* Lists those packages which occur as dependencies in an installed - collection, but are themselves not installed, and those packages - which are not contained in any collection. + collections, but are themselves not installed, and those packages + that are not contained in any collection. If you call 'tlmgr check collections' this test will be carried out instead since former versions for 'tlmgr' called it that way. @@ -2908,7 +2859,7 @@ Executes one (or all) check(s) on the consistency of the installation. *runfiles* List those filenames that are occurring more than one time in the - runfiles sections. + runfiles. Options: @@ -2918,67 +2869,51 @@ Executes one (or all) check(s) on the consistency of the installation. checking the TL development repository. -File: tlbuild.info, Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]], Next: tlmgr conf auxtrees [--conffile _file_] [show|add|delete] [_value_], Prev: tlmgr check [_option_]... [files|depends|executes|runfiles|all], Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]], Next: tlmgr dump-tlpdb [--local|--remote], Prev: tlmgr check [_option_]... [files|depends|executes|runfiles|all], Up: tlmgr ACTIONS B.6.6 conf [texmf|tlmgr|updmap [-conffile _file_] [-delete] [_key_ [_value_]]] ------------------------------------------------------------------------------ - -File: tlbuild.info, Node: tlmgr conf auxtrees [--conffile _file_] [show|add|delete] [_value_], Next: tlmgr dump-tlpdb [--local|--remote], Prev: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]], Up: tlmgr ACTIONS - -B.6.7 conf auxtrees [-conffile _file_] [show|add|delete] [_value_] ------------------------------------------------------------------- - With only 'conf', show general configuration information for TeX Live, including active configuration files, path settings, and more. This is -like running 'texconfig conf', but works on all supported platforms. +like the 'texconfig conf' call, but works on all supported platforms. - With one of 'conf texmf', 'conf tlmgr', or 'conf updmap', shows all -key/value pairs (i.e., all settings) as saved in 'ROOT/texmf.cnf', the -user-specific 'tlmgr' configuration file (see below), or the first found -(via 'kpsewhich') 'updmap.cfg' file, respectively. + With either 'conf texmf', 'conf tlmgr', or 'conf updmap' given in +addition, shows all key/value pairs (i.e., all settings) as saved in +'ROOT/texmf.cnf', the tlmgr configuration file (see below), or the first +found (via kpsewhich) 'updmap.cfg' file, respectively. If _key_ is given in addition, shows the value of only that _key_ in -the respective file. If option _-delete_ is also given, the value in -the given configuration file is entirely removed (not just commented -out). +the respective file. If option _-delete_ is also given, the +configuration file - it is removed, not just commented out! If _value_ is given in addition, _key_ is set to _value_ in the respective file. _No error checking is done!_ - The 'PATH' value shown by 'conf' is as used by 'tlmgr'. The -directory in which the 'tlmgr' executable is found is automatically -prepended to the PATH value inherited from the environment. + In all cases the file used can be explicitly specified via the option +'--conffile _file_', in case one wants to operate on a different file. - Here is a practical example of changing configuration values. If the -execution of (some or all) system commands via '\write18' was left -enabled during installation, you can disable it afterwards: + Practical application: if the execution of (some or all) system +commands via '\write18' was left enabled during installation, you can +disable it afterwards: tlmgr conf texmf shell_escape 0 - The subcommand 'auxtrees' allows adding and removing arbitrary -additional texmf trees, completely under user control. 'auxtrees show' -shows the list of additional trees, 'auxtrees add' _tree_ adds a tree to -the list, and 'auxtrees remove' _tree_ removes a tree from the list (if -present). The trees should not contain an 'ls-R' file (or files might -not be found if the 'ls-R' becomes stale). This works by manipulating -the Kpathsea variable 'TEXMFAUXTREES', in 'ROOT/texmf.cnf'. Example: + A more complicated example: the 'TEXMFHOME' tree (see the main TeX +Live guide, <http://tug.org/texlive/doc.html>) can be set to multiple +directories, but they must be enclosed in braces and separated by +commas, so quoting the value to the shell is a good idea. Thus: - tlmgr conf auxtrees add /quick/test/tree - tlmgr conf auxtrees remove /quick/test/tree + tlmgr conf texmf TEXMFHOME "{~/texmf,~/texmfbis}" - In all cases the configuration file can be explicitly specified via -the option '--conffile' _file_, if desired. - - Warning: The general facility for changing configuration values is -here, but tinkering with settings in this way is strongly discouraged. -Again, no error checking on either keys or values is done, so any sort -of breakage is possible. + Warning: The general facility is here, but tinkering with settings in +this way is very strongly discouraged. Again, no error checking on +either keys or values is done, so any sort of breakage is possible. -File: tlbuild.info, Node: tlmgr dump-tlpdb [--local|--remote], Next: tlmgr generate [_option_]... _what_, Prev: tlmgr conf auxtrees [--conffile _file_] [show|add|delete] [_value_], Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr dump-tlpdb [--local|--remote], Next: tlmgr generate [_option_]... _what_, Prev: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]], Up: tlmgr ACTIONS -B.6.8 dump-tlpdb [-local|-remote] +B.6.7 dump-tlpdb [-local|-remote] --------------------------------- Dump complete local or remote TLPDB to standard output, as-is. The @@ -2989,11 +2924,11 @@ MACHINE-READABLE OUTPUT: tlmgr MACHINE-READABLE OUTPUT. section. *-local* - Dump the local TLPDB. + Dump the local tlpdb. *-remote* - Dump the remote TLPDB. + Dump the remote tlpdb. Exactly one of '--local' and '--remote' must be given. @@ -3011,7 +2946,7 @@ platform. File: tlbuild.info, Node: tlmgr generate [_option_]... _what_, Next: tlmgr gui, Prev: tlmgr dump-tlpdb [--local|--remote], Up: tlmgr ACTIONS -B.6.9 generate [_option_]... _what_ +B.6.8 generate [_option_]... _what_ ----------------------------------- *generate language* @@ -3022,6 +2957,8 @@ B.6.9 generate [_option_]... _what_ *generate language.dat.lua* +*generate fmtutil* + The 'generate' action overwrites any manual changes made in the respective files: it recreates them from scratch based on the information of the installed packages, plus local adaptions. The TeX @@ -3031,37 +2968,35 @@ files. For managing your own fonts, please read the 'updmap --help' information and/or <http://tug.org/fonts/fontinstall.html>. - For managing your own formats, please read the 'fmtutil --help' -information. - In more detail: 'generate' remakes any of the configuration files -'language.dat', 'language.def', and 'language.dat.lua' from the -information present in the local TLPDB, plus locally-maintained files. +'language.dat', 'language.def', 'language.dat.lua', and 'fmtutil.cnf', +from the information present in the local TLPDB, plus locally-maintained +files. The locally-maintained files are 'language-local.dat', -'language-local.def', or 'language-local.dat.lua', searched for in -'TEXMFLOCAL' in the respective directories. If local additions are -present, the final file is made by starting with the main file, omitting -any entries that the local file specifies to be disabled, and finally -appending the local file. - - (Historical note: The formerly supported 'updmap-local.cfg' and -'fmtutil-local.cnf' are no longer read, since 'updmap' and 'fmtutil' now -reads and supports multiple configuration files. Thus, local additions -can and should be put into an 'updmap.cfg' of 'fmtutil.cnf' file in -'TEXMFLOCAL'. The 'generate updmap' and 'generate fmtutil' actions no -longer exist.) +'language-local.def', 'language-local.dat.lua', or 'fmtutil-local.cnf', +searched for in 'TEXMFLOCAL' in the respective directories. If local +additions are present, the final file is made by starting with the main +file, omitting any entries that the local file specifies to be disabled, +and finally appending the local file. + + (Historical note: The formerly supported 'updmap-local.cfg' is no +longer read, since 'updmap' now supports multiple 'updmap.cfg' files. +Thus, local additions can and should be put into an 'updmap.cfg' file in +'TEXMFLOCAL'. The 'generate updmap' action no longer exists.) Local files specify entries to be disabled with a comment line, namely one of these: + #!NAME %!NAME --!NAME - where 'language.dat' and 'language.def' use '%', and -'language.dat.lua' use '--'. In all cases, the _name_ is the respective -format name or hyphenation pattern identifier. Examples: + where 'fmtutil.cnf' uses '#', 'language.dat' and 'language.def' use +'%', and 'language.dat.lua' use '--'. In all cases, the _name_ is the +respective format name or hyphenation pattern identifier. Examples: + #!pdflatex %!german --!usenglishmax @@ -3097,8 +3032,8 @@ with an extension recreates only that given language file. *-rebuild-sys* - tells 'tlmgr' to run necessary programs after config files have - been regenerated. These are: 'fmtutil-sys --all' after 'generate + tells tlmgr to run necessary programs after config files have been + regenerated. These are: 'fmtutil-sys --all' after 'generate fmtutil', 'fmtutil-sys --byhyphen .../language.dat' after 'generate language.dat', and 'fmtutil-sys --byhyphen .../language.def' after 'generate language.def'. @@ -3110,22 +3045,23 @@ with an extension recreates only that given language file. The respective locations are as follows: - tex/generic/config/language.dat (and language-local.dat) - tex/generic/config/language.def (and language-local.def) - tex/generic/config/language.dat.lua (and language-local.dat.lua) + tex/generic/config/language.dat (and language-local.dat); + tex/generic/config/language.def (and language-local.def); + tex/generic/config/language.dat.lua (and language-local.dat.lua); + web2c/fmtutil.cnf (and fmtutil-local.cnf); File: tlbuild.info, Node: tlmgr gui, Next: tlmgr info [_option_...] [collections|schemes|_pkg_...], Prev: tlmgr generate [_option_]... _what_, Up: tlmgr ACTIONS -B.6.10 gui ----------- +B.6.9 gui +--------- Start the graphical user interface. See *GUI* below. File: tlbuild.info, Node: tlmgr info [_option_...] [collections|schemes|_pkg_...], Next: tlmgr init-usertree, Prev: tlmgr gui, Up: tlmgr ACTIONS -B.6.11 info [_option_...] [collections|schemes|_pkg_...] +B.6.10 info [_option_...] [collections|schemes|_pkg_...] -------------------------------------------------------- With no argument, lists all packages available at the package @@ -3135,19 +3071,9 @@ repository, prefixing those already installed with 'i'. lists the request type instead of all packages. With any other arguments, display information about _pkg_: the name, -category, short and long description, sizes, installation status, and -TeX Live revision number. If _pkg_ is not locally installed, searches -in the remote installation source. - - For normal packages (not collections or schemes), the sizes of the -four groups of files (run/src/doc/bin files) are shown separately. For -collections, the cumulative size is shown, including all -directly-dependent packages (but not dependent collections). For -schemes, the cumulative size is also shown, including all -directly-dependent collections and packages. - - If _pkg_ is not found locally or remotely, the search action is used -and lists matching packages and files. +category, short and long description, installation status, and TeX Live +revision number. If _pkg_ is not locally installed, searches in the +remote installation source. It also displays information taken from the TeX Catalogue, namely the package version, date, and license. Consider these, especially the @@ -3169,14 +3095,26 @@ are still supported for backward compatibility. *-only-installed* - If this option is given, the installation source will not be used; + If this options is given, the installation source will not be used; only locally installed packages, collections, or schemes are - listed. + listed. (Does not work for listing of packages for now) + +*-taxonomy* + +*-keyword* + +*-functionality* + +*-characterization* + + In addition to the normal data displayed, also display information + for given packages from the corresponding taxonomy (or all of + them). See *note TAXONOMIES: tlmgr TAXONOMIES. below for details. File: tlbuild.info, Node: tlmgr init-usertree, Next: tlmgr install [_option_]... _pkg_..., Prev: tlmgr info [_option_...] [collections|schemes|_pkg_...], Up: tlmgr ACTIONS -B.6.12 init-usertree +B.6.11 init-usertree -------------------- Sets up a texmf tree for so-called user mode management, either the @@ -3184,22 +3122,13 @@ default user tree ('TEXMFHOME'), or one specified on the command line with '--usertree'. See *note USER MODE: tlmgr USER MODE. below. -File: tlbuild.info, Node: tlmgr install [_option_]... _pkg_..., Next: tlmgr key list|add _file_|remove _keyid_, Prev: tlmgr init-usertree, Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr install [_option_]... _pkg_..., Next: tlmgr option, Prev: tlmgr init-usertree, Up: tlmgr ACTIONS -B.6.13 install [_option_]... _pkg_... +B.6.12 install [_option_]... _pkg_... ------------------------------------- -Install each _pkg_ given on the command line, if it is not already -installed. (It does not touch existing packages; see the 'update' -action for how to get the latest version of a package.) - - By default this also installs all packages on which the given _pkg_s -are dependent. Options: - -*-dry-run* - - Nothing is actually installed; instead, the actions to be performed - are written to the terminal. +Install each _pkg_ given on the command line. By default this installs +all packages on which the given _pkg_s are dependent, also. Options: *-file* @@ -3207,11 +3136,15 @@ are dependent. Options: the package files given on the command line. These files must be standard TeX Live package files (with contained tlpobj file). -*-force* +*-reinstall* - If updates to 'tlmgr' itself (or other parts of the basic - infrastructure) are present, 'tlmgr' will bail out and not perform - the installation unless this option is given. Not recommended. + Reinstall a package (including dependencies for collections) even + if it already seems to be installed (i.e, is present in the TLPDB). + This is useful to recover from accidental removal of files in the + hierarchy. + + When re-installing, only dependencies on normal packages are + followed (i.e., not those of category Scheme or Collection). *-no-depends* @@ -3227,54 +3160,21 @@ are dependent. Options: and also implies '--no-depends'. Don't use it unless you are sure of what you are doing. -*-reinstall* - - Reinstall a package (including dependencies for collections) even - if it already seems to be installed (i.e, is present in the TLPDB). - This is useful to recover from accidental removal of files in the - hierarchy. - - When re-installing, only dependencies on normal packages are - followed (i.e., not those of category Scheme or Collection). - -*-with-doc* - -*-with-src* - - While not recommended, the 'install-tl' program provides an option - to omit installation of all documentation and/or source files. (By - default, everything is installed.) After such an installation, you - may find that you want the documentation or source files for a - given package after all. You can get them by using these options - in conjunction with '--reinstall', as in (using the 'fontspec' - package as the example): - - tlmgr install --reinstall --with-doc --with-src fontspec - - -File: tlbuild.info, Node: tlmgr key list|add _file_|remove _keyid_, Next: tlmgr option, Prev: tlmgr install [_option_]... _pkg_..., Up: tlmgr ACTIONS - -B.6.14 key list|add _file_|remove _keyid_ ------------------------------------------ - -The action 'key' allows listing, adding and removing additional GPG keys -to the set of trusted keys, that is, those that are used to verify the -TeX Live databases. +*-dry-run* - With the 'list' argument, 'key' lists all keys. + Nothing is actually installed; instead, the actions to be performed + are written to the terminal. - The 'add' argument requires another argument, either a filename or -'-' for stdin, from which the key is added. The key is added to the -local keyring 'GNUPGHOME/repository-keys.gpg', which is normally) -'tlpkg/gpg/repository-keys.gpg'. +*-force* - The 'remove' argument requires a key id and removes the requested id -from the local keyring. + If updates to 'tlmgr' itself (or other parts of the basic + infrastructure) are present, 'tlmgr' will bail out and not perform + the installation unless this option is given. Not recommended. -File: tlbuild.info, Node: tlmgr option, Next: tlmgr paper, Prev: tlmgr key list|add _file_|remove _keyid_, Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr option, Next: tlmgr paper, Prev: tlmgr install [_option_]... _pkg_..., Up: tlmgr ACTIONS -B.6.15 option +B.6.13 option ------------- *option [show]* @@ -3330,9 +3230,7 @@ is not likely to be of interest except perhaps to developers. The 'docfiles' and 'srcfiles' options control the installation of their respective files of a package. By default both are enabled (1). -Either or both can be disabled (set to 0) if disk space is limited or -for minimal testing installations, etc. When disabled, the respective -files are not downloaded at all. +This can be disabled (set to 0) if disk space is (very) limited. The options 'autobackup' and 'backupdir' determine the defaults for the actions 'update', 'backup' and 'restore'. These three actions need @@ -3345,8 +3243,7 @@ backups. Its value is an integer. If the 'autobackup' value is '-1', no backups are removed. If 'autobackup' is 0 or more, it specifies the number of backups to keep. Thus, backups are disabled if the value is 0. In the '--clean' mode of the 'backup' action this option also -specifies the number to be kept. The default value is 1, so that -backups are made, but only one backup is kept. +specifies the number to be kept. To setup 'autobackup' to '-1' on the command line, use: @@ -3360,7 +3257,7 @@ feature across most Unix programs.) Unix-like systems to control the generation of links for executables, info files and man pages. See the 'path' action for details. - The last three options also affect behavior on Windows installations. + The last three options control behaviour on Windows installations. If 'desktop_integration' is set, then some packages will install items in a sub-folder of the Start menu for 'tlmgr gui', documentation, etc. If 'fileassocs' is set, Windows file associations are made (see also the @@ -3371,7 +3268,7 @@ of only the current user. All three options are on by default. File: tlbuild.info, Node: tlmgr paper, Next: tlmgr path [--w32mode=user|admin] [add|remove], Prev: tlmgr option, Up: tlmgr ACTIONS -B.6.16 paper +B.6.14 paper ------------ *paper [a4|letter]* @@ -3405,7 +3302,7 @@ settings. File: tlbuild.info, Node: tlmgr path [--w32mode=user|admin] [add|remove], Next: tlmgr pinning, Prev: tlmgr paper, Up: tlmgr ACTIONS -B.6.17 path [-w32mode=user|admin] [add|remove] +B.6.15 path [-w32mode=user|admin] [add|remove] ---------------------------------------------- On Unix, merely adds or removes symlinks for binaries, man pages, and @@ -3436,7 +3333,7 @@ issued that the caller does not have enough privileges. File: tlbuild.info, Node: tlmgr pinning, Next: tlmgr platform list|add|remove _platform_..., Prev: tlmgr path [--w32mode=user|admin] [add|remove], Up: tlmgr ACTIONS -B.6.18 pinning +B.6.16 pinning -------------- The 'pinning' action manages the pinning file, see *note Pinning: tlmgr @@ -3463,19 +3360,19 @@ Pinning. below. File: tlbuild.info, Node: tlmgr platform list|add|remove _platform_..., Next: tlmgr platform set _platform_, Prev: tlmgr pinning, Up: tlmgr ACTIONS -B.6.19 platform list|add|remove _platform_... +B.6.17 platform list|add|remove _platform_... --------------------------------------------- File: tlbuild.info, Node: tlmgr platform set _platform_, Next: tlmgr platform set auto, Prev: tlmgr platform list|add|remove _platform_..., Up: tlmgr ACTIONS -B.6.20 platform set _platform_ +B.6.18 platform set _platform_ ------------------------------ File: tlbuild.info, Node: tlmgr platform set auto, Next: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]..., Prev: tlmgr platform set _platform_, Up: tlmgr ACTIONS -B.6.21 platform set auto +B.6.19 platform set auto ------------------------ 'platform list' lists the TeX Live names of all the platforms (a.k.a. @@ -3510,7 +3407,7 @@ platform. File: tlbuild.info, Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]..., Next: tlmgr print-platform, Prev: tlmgr platform set auto, Up: tlmgr ACTIONS -B.6.22 postaction [-w32mode=user|admin] [-fileassocmode=1|2] [-all] [install|remove] [shortcut|fileassoc|script] [_pkg_]... +B.6.20 postaction [-w32mode=user|admin] [-fileassocmode=1|2] [-all] [install|remove] [shortcut|fileassoc|script] [_pkg_]... --------------------------------------------------------------------------------------------------------------------------- Carry out the postaction 'shortcut', 'fileassoc', or 'script' given as @@ -3530,9 +3427,9 @@ to 2, all associations are set to the TeX Live programs. (See also 'option fileassocs'.) -File: tlbuild.info, Node: tlmgr print-platform, Next: tlmgr remove [_option_]... _pkg_..., Prev: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]..., Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr print-platform, Next: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]], Prev: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]..., Up: tlmgr ACTIONS -B.6.23 print-platform +B.6.21 print-platform --------------------- Print the TeX Live identifier for the detected platform @@ -3540,42 +3437,60 @@ Print the TeX Live identifier for the detected platform '--print-arch' is a synonym. -File: tlbuild.info, Node: tlmgr remove [_option_]... _pkg_..., Next: tlmgr repository, Prev: tlmgr print-platform, Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]], Next: tlmgr remove [_option_]... _pkg_..., Prev: tlmgr print-platform, Up: tlmgr ACTIONS -B.6.24 remove [_option_]... _pkg_... ------------------------------------- +B.6.22 restore [-backupdir _dir_] [-all | _pkg_ [_rev_]] +-------------------------------------------------------- -Remove each _pkg_ specified. Removing a collection removes all package -dependencies (unless '--no-depends' is specified), but not any -collection dependencies of that collection. However, when removing a -package, dependencies are never removed. Options: +Restore a package from a previously-made backup. -*-backup* + If '--all' is given, try to restore the latest revision of all +package backups found in the backup directory. + + Otherwise, if neither _pkg_ nor _rev_ are given, list the available +backup revisions for all packages. + + With _pkg_ given but no _rev_, list all available backup revisions of +_pkg_. + + When listing available packages tlmgr shows the revision and in +parenthesis the creation time if available (in format yyyy-mm-dd hh:mm). + + With both _pkg_ and _rev_, tries to restore the package from the +specified backup. + + Options: + +*-all* + + Try to restore the latest revision of all package backups found in + the backup directory. Additional non-option arguments (like _pkg_) + are not allowed. *-backupdir* _directory_ - These options behave just as with the *note (update)tlmgr update - [_option_]... [_pkg_]...:: action (q.v.), except they apply to - making backups of packages before they are removed. The default is - to make such a backup, that is, to save a copy of packages before - removal. + Specify the directory where the backups are to be found. If not + given it will be taken from the configuration setting in the TLPDB. - See *note (update)tlmgr update [_option_]... [_pkg_]...:: action - for more. +*-dry-run* - neither option is given, no backup will be made. If '--backupdir' - is given and specifies a writable directory then a backup will be - made in that location. If only '--backup' is given, then a backup - will be made to the directory previously set via the 'option' - action (see below). If both are given then a backup will be made - to the specified _directory_. + Nothing is actually restored; instead, the actions to be performed + are written to the terminal. - You can set options via the 'option' action to automatically make - backups for all packages, and/or keep only a certain number of - backups. Please see the 'option' action for details. The default - is to make one backup. +*-force* - The 'restore' action explains how to restore from a backup. + Don't ask questions. + + +File: tlbuild.info, Node: tlmgr remove [_option_]... _pkg_..., Next: tlmgr repository, Prev: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]], Up: tlmgr ACTIONS + +B.6.23 remove [_option_]... _pkg_... +------------------------------------ + +Remove each _pkg_ specified. Removing a collection removes all package +dependencies (unless '--no-depends' is specified), but not any +collection dependencies of that collection. However, when removing a +package, dependencies are never removed. Options: *-no-depends* @@ -3602,9 +3517,9 @@ package, dependencies are never removed. Options: are written to the terminal. -File: tlbuild.info, Node: tlmgr repository, Next: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]], Prev: tlmgr remove [_option_]... _pkg_..., Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr repository, Next: tlmgr search [_option_...] _what_, Prev: tlmgr remove [_option_]... _pkg_..., Up: tlmgr ACTIONS -B.6.25 repository +B.6.24 repository ----------------- *repository list* @@ -3639,85 +3554,62 @@ B.6.25 repository otherwise, all operations will fail! -File: tlbuild.info, Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]], Next: tlmgr search [_option_...] _what_, Prev: tlmgr repository, Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr search [_option_...] _what_, Next: tlmgr uninstall, Prev: tlmgr repository, Up: tlmgr ACTIONS -B.6.26 restore [-backupdir _dir_] [-all | _pkg_ [_rev_]] --------------------------------------------------------- - -Restore a package from a previously-made backup. - - If '--all' is given, try to restore the latest revision of all -package backups found in the backup directory. - - Otherwise, if neither _pkg_ nor _rev_ are given, list the available -backup revisions for all packages. With _pkg_ given but no _rev_, list -all available backup revisions of _pkg_. - - When listing available packages, 'tlmgr' shows the revision, and in -parenthesis the creation time if available (in format yyyy-mm-dd hh:mm). - - If (and only if) both _pkg_ and a valid revision number _rev_ are -specified, try to restore the package from the specified backup. - - Options: - -*-all* - - Try to restore the latest revision of all package backups found in - the backup directory. Additional non-option arguments (like _pkg_) - are not allowed. +B.6.25 search [_option_...] _what_ +---------------------------------- -*-backupdir* _directory_ +* Menu: - Specify the directory where the backups are to be found. If not - given it will be taken from the configuration setting in the TLPDB. +* tlmgr search [_option_...] --file _what_:: +* tlmgr search [_option_...] --taxonomy _what_:: +* tlmgr search [_option_...] --keyword _what_:: +* tlmgr search [_option_...] --functionality _what_:: +* tlmgr search [_option_...] --characterization _what_:: +* tlmgr search [_option_...] --all _what_:: -*-dry-run* + +File: tlbuild.info, Node: tlmgr search [_option_...] --file _what_, Next: tlmgr search [_option_...] --taxonomy _what_, Up: tlmgr search [_option_...] _what_ - Nothing is actually restored; instead, the actions to be performed - are written to the terminal. +B.6.25.1 search [_option_...] -file _what_ +.......................................... -*-force* + +File: tlbuild.info, Node: tlmgr search [_option_...] --taxonomy _what_, Next: tlmgr search [_option_...] --keyword _what_, Prev: tlmgr search [_option_...] --file _what_, Up: tlmgr search [_option_...] _what_ - Don't ask questions. +B.6.25.2 search [_option_...] -taxonomy _what_ +.............................................. -File: tlbuild.info, Node: tlmgr search [_option_...] _what_, Next: tlmgr shell, Prev: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]], Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr search [_option_...] --keyword _what_, Next: tlmgr search [_option_...] --functionality _what_, Prev: tlmgr search [_option_...] --taxonomy _what_, Up: tlmgr search [_option_...] _what_ -B.6.27 search [_option_...] _what_ ----------------------------------- +B.6.25.3 search [_option_...] -keyword _what_ +............................................. -* Menu: + +File: tlbuild.info, Node: tlmgr search [_option_...] --functionality _what_, Next: tlmgr search [_option_...] --characterization _what_, Prev: tlmgr search [_option_...] --keyword _what_, Up: tlmgr search [_option_...] _what_ -* tlmgr search [_option_...] --file _what_:: -* tlmgr search [_option_...] --all _what_:: +B.6.25.4 search [_option_...] -functionality _what_ +................................................... -File: tlbuild.info, Node: tlmgr search [_option_...] --file _what_, Next: tlmgr search [_option_...] --all _what_, Up: tlmgr search [_option_...] _what_ +File: tlbuild.info, Node: tlmgr search [_option_...] --characterization _what_, Next: tlmgr search [_option_...] --all _what_, Prev: tlmgr search [_option_...] --functionality _what_, Up: tlmgr search [_option_...] _what_ -B.6.27.1 search [_option_...] -file _what_ -.......................................... +B.6.25.5 search [_option_...] -characterization _what_ +...................................................... -File: tlbuild.info, Node: tlmgr search [_option_...] --all _what_, Prev: tlmgr search [_option_...] --file _what_, Up: tlmgr search [_option_...] _what_ +File: tlbuild.info, Node: tlmgr search [_option_...] --all _what_, Prev: tlmgr search [_option_...] --characterization _what_, Up: tlmgr search [_option_...] _what_ -B.6.27.2 search [_option_...] -all _what_ +B.6.25.6 search [_option_...] -all _what_ ......................................... By default, search the names, short descriptions, and long descriptions of all locally installed packages for the argument _what_, interpreted -as a (Perl) regular expression. +as a regular expression. Options: -*-file* - - List all filenames containing _what_. - -*-all* - - Search everything: package names, descriptions and filenames. - *-global* Search the TeX Live Database of the installation medium, instead of @@ -3725,76 +3617,45 @@ as a (Perl) regular expression. *-word* - Restrict the search of package names and descriptions (but not - filenames) to match only full words. For example, searching for - 'table' with this option will not output packages containing the - word 'tables' (unless they also contain the word 'table' on its - own). + Restrict the search to match only full words. For example, + searching for 'table' with this option will not output packages + containing the word 'tables' (unless they also contain the word + 'table' on its own). - -File: tlbuild.info, Node: tlmgr shell, Next: tlmgr uninstall, Prev: tlmgr search [_option_...] _what_, Up: tlmgr ACTIONS - -B.6.28 shell ------------- - -Starts an interactive mode, where tlmgr prompts for commands. This can -be used directly, or for scripting. The first line of output is -'protocol' _n_, where _n_ is an unsigned number identifying the protocol -version (currently 1). - - In general, tlmgr actions that can be given on the command line -translate to commands in this shell mode. For example, you can say -'update --list' to see what would be updated. The TLPDB is loaded the -first time it is needed (not at the beginning), and used for the rest of -the session. - - Besides these actions, a few commands are specific to shell mode: - -protocol - - Print 'protocol _n_', the current protocol version. - -help - - Print pointers to this documentation. - -version - - Print tlmgr version information. +*-list* -quit, end, bye, byebye, EOF + If a search for any (or all) taxonomies is done, by specifying one + of the taxonomy options below, then instead of searching for + packages, list the entire corresponding taxonomy (or all of them). + See *note TAXONOMIES: tlmgr TAXONOMIES. below. - Exit. + Other search options are selected by specifying one of the following: -restart +*-file* - Restart 'tlmgr shell' with the original command line; most useful - when developing 'tlmgr'. + List all filenames containing _what_. -load [local|remote] +*-taxonomy* - Explicitly load the local or remote, respectively, TLPDB. +*-keyword* -save +*-functionality* - Save the local TLPDB, presumably after other operations have - changed it. +*-characterization* -get [_var_] =item set [_var_ [_val_]] + Search in the corresponding taxonomy (or all) instead of the + package descriptions. See *note TAXONOMIES: tlmgr TAXONOMIES. + below. - Get the value of _var_, or set it to _val_. Possible _var_ names: - 'debug-translation', 'machine-readable', 'no-execute-actions', - 'require-verification', 'verify-downloads', and 'repository'. All - except 'repository' are booleans, taking values 0 and 1, and behave - like the corresponding command line option. The 'repository' - variable takes a string, and sets the remote repository location. +*-all* - If _var_ or then _val_ is not specified, it is prompted for. + Search for package names, descriptions, and taxonomies, but not + files. -File: tlbuild.info, Node: tlmgr uninstall, Next: tlmgr update [_option_]... [_pkg_]..., Prev: tlmgr shell, Up: tlmgr ACTIONS +File: tlbuild.info, Node: tlmgr uninstall, Next: tlmgr update [_option_]... [_pkg_]..., Prev: tlmgr search [_option_...] _what_, Up: tlmgr ACTIONS -B.6.29 uninstall +B.6.26 uninstall ---------------- Uninstalls the entire TeX Live installation. Options: @@ -3806,7 +3667,7 @@ Uninstalls the entire TeX Live installation. Options: File: tlbuild.info, Node: tlmgr update [_option_]... [_pkg_]..., Prev: tlmgr uninstall, Up: tlmgr ACTIONS -B.6.30 update [_option_]... [_pkg_]... +B.6.27 update [_option_]... [_pkg_]... -------------------------------------- Updates the packages given as arguments to the latest version available @@ -3945,31 +3806,29 @@ must be specified. Options: tlmgr update --reinstall-forcibly-removed --all -*-backup* - -*-backupdir* _directory_ +*-backup* and *-backupdir* _directory_ These two options control the creation of backups of packages _before_ updating; that is, backup of packages as currently - installed. If neither options is given, no backup will made saved. - If '--backupdir' is given and specifies a writable directory then a - backup will be made in that location. If only '--backup' is given, - then a backup will be made to the directory previously set via the - *note option: tlmgr option. action (see below). If both are given - then a backup will be made to the specified _directory_. - - You can also set options via the '/option' action to automatically - make backups for all packages, and/or keep only a certain number of - backups. + installed. If neither of these options are given, no backup + package will be saved. If '--backupdir' is given and specifies a + writable directory then a backup will be made in that location. If + only '--backup' is given, then a backup will be made to the + directory previously set via the 'option' action (see below). If + both are given then a backup will be made to the specified + _directory_. + + You can set options via the 'option' action to automatically create + backups for all packages, and/or keep only a certain number of + backups. Please see the 'option' action for details. 'tlmgr' always makes a temporary backup when updating packages, in case of download or other failure during an update. In contrast, - the purpose of this '--backup' option is to save a persistent - backup in case the actual _content_ of the update causes problems, - e.g., introduces an TeX incompatibility. + the purpose of this '--backup' option is to allow you to save a + persistent backup in case the actual _content_ of the update causes + problems, e.g., introduces an incompatibility. - The *note restore: tlmgr restore [--backupdir _dir_] [--all | _pkg_ - [_rev_]]. action explains how to restore from a backup. + The 'restore' action explains how to restore from a backup. *-no-depends* @@ -3993,134 +3852,10 @@ installed (e.g., if the selected mirror is out of date), 'tlmgr' does not downgrade. Also, packages for uninstalled platforms are not installed. - 'tlmgr' saves a copy of the 'texlive.tlpdb' file used for an update -with a suffix representing the repository url, as in -'tlpkg/texlive.tlpdb.'_long-hash-string_. These can be useful for -fallback information, but if you don't like them accumulating (e.g., -'mirror.ctan.org' resolves to many different hosts, each resulting in a -possibly different hash), it's harmless to delete them. - -File: tlbuild.info, Node: tlmgr CONFIGURATION FILE FOR TLMGR, Next: tlmgr CRYPTOGRAPHIC VERIFICATION, Prev: tlmgr ACTIONS, Up: tlmgr +File: tlbuild.info, Node: tlmgr USER MODE, Next: tlmgr CONFIGURATION FILE FOR TLMGR, Prev: tlmgr ACTIONS, Up: tlmgr -B.7 CONFIGURATION FILE FOR TLMGR -================================ - -There are two configuration files for 'tlmgr': One is system-wide in -'TEXMFSYSCONFIG/tlmgr/config', and the other is user-specific in -'TEXMFCONFIG/tlmgr/config'. The user-specific one is the default for -the 'conf tlmgr' action. (Run 'kpsewhich -var-value=TEXMFSYSCONFIG' or -'... TEXMFCONFIG ...' to see the actual directory names.) - - A few defaults corresponding to command-line options can be set in -these configuration files. In addition, the system-wide file can -contain a directive to restrict the allowed actions. - - In these config files, empty lines and lines starting with # are -ignored. All other lines must look like: - - key = value - - where the spaces are optional but the '=' is required. - - The allowed keys are: - -'auto-remove', value 0 or 1 (default 1), same as command-line option. - -'gui-expertmode', value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings. - -'gui-lang' _llcode_, with a language code value as with the command-line option. - -'no-checksums', value 0 or 1 (default 0, see below). - -'persistent-downloads', value 0 or 1 (default 1), same as command-line option. - -'require-verification', value 0 or 1 (default 0), same as command-line option. - -'verify-downloads', value 0 or 1 (default 1), same as command-line option. - - The system-wide config file can contain one additional key: - -'allowed-actions' _action1_ [,_action_,...] The value is a comma-separated list of 'tlmgr' actions which are allowed to be executed when 'tlmgr' is invoked in system mode (that is, without '--usermode'). - - This allows distributors to include the 'tlmgr' in their packaging, - but allow only a restricted set of actions that do not interfere - with their distro package manager. For native TeX Live - installations, it doesn't make sense to set this. - - The 'no-checksums' key needs more explanation. By default, package -checksums computed and stored on the server (in the TLPDB) are compared -to checksums computed locally after downloading. That is, for each -'texlive.tlpdb' loaded from a repository, the corresponding checksum -file 'texlive.tlpdb.sha512' is also downloaded, and 'tlmgr' confirms -whether the checksum of the downloaded TLPDB file agrees with the -download data. 'no-checksums' disables this process. - - The checksum algorithm is SHA-512. Your system must have one of -(looked for in this order) the Perl 'Digest::SHA' module, the 'openssl' -program (<http://openssl.org>), the 'sha512sum' program (from GNU -Coreutils, <http://www.gnu.org/software/coreutils>), or finally the -'shasum' program (just to support old Macs). If none of these are -available, a warning is issued and 'tlmgr' proceeds without checking -checksums. (Incidentally, other SHA implementations, such as the pure -Perl and pure Lua modules, are much too slow to be usable in our -context.) 'no-checksums' avoids the warning. - - -File: tlbuild.info, Node: tlmgr CRYPTOGRAPHIC VERIFICATION, Next: tlmgr USER MODE, Prev: tlmgr CONFIGURATION FILE FOR TLMGR, Up: tlmgr - -B.8 CRYPTOGRAPHIC VERIFICATION -============================== - -'tlmgr' and 'install-tl' perform cryptographic verification if possible. -If verification is performed and successful, the programs report -'(verified)' after loading the TLPDB; otherwise, they report '(not -verified)'. Either way, by default the installation and/or updates -proceed normally. - - The attempted verification can be suppressed by specifying -'--no-verify-downloads' on the command line, or the entry -'verify-downloads = 0' in a 'tlmgr' config file (described in *note -CONFIGURATION FILE FOR TLMGR: tlmgr CONFIGURATION FILE FOR TLMGR.). On -the other hand, it is possible to _require_ verification by specifying -'--require-verification' on the command line, or 'require-verification = -1' in a 'tlmgr' config file; in this case, if verification is not -possible, the program quits. - - Cryptographic verification requires checksum checking (described just -above) to succeed, and a working GnuPG ('gpg') program (see below for -search method). Then, unless cryptographic verification has been -disabled, a signature file ('texlive.tlpdb.*.asc') of the checksum file -is downloaded and the signature verified. The signature is created by -the TeX Live Distribution GPG key 0x06BAB6BC, which in turn is signed by -Karl Berry's key 0x30D155AD and Norbert Preining's key 0x6CACA448. All -of these keys are obtainable from the standard key servers. - - Additional trusted keys can be added using the 'key' action. - -* Menu: - -* tlmgr Configuration of GnuPG invocation:: - - -File: tlbuild.info, Node: tlmgr Configuration of GnuPG invocation, Up: tlmgr CRYPTOGRAPHIC VERIFICATION - -B.8.1 Configuration of GnuPG invocation ---------------------------------------- - -The executable used for GnuPG is searched as follows: If the environment -variable 'TL_GNUPG' is set, it is tested and used; otherwise 'gpg' is -checked; finally 'gpg2' is checked. - - Further adaptation of the 'gpg' invocation can be made using the two -environment variables 'TL_GNUPGHOME', which is passed to 'gpg' as the -value for '--homedir', and 'TL_GNUPGARGS', which replaces the default -options '--no-secmem-warning --no-permission-warning'. - - -File: tlbuild.info, Node: tlmgr USER MODE, Next: tlmgr MULTIPLE REPOSITORIES, Prev: tlmgr CRYPTOGRAPHIC VERIFICATION, Up: tlmgr - -B.9 USER MODE +B.7 USER MODE ============= 'tlmgr' provides a restricted way, called "user mode", to manage @@ -4176,14 +3911,14 @@ be installed into a user tree. * Menu: -* tlmgr User mode install:: -* tlmgr User mode backup, restore, remove, update:: -* tlmgr User mode generate, option, paper:: +* tlmgr user mode install:: +* tlmgr user mode backup; restore; remove; update:: +* tlmgr user mode generate; option; paper:: -File: tlbuild.info, Node: tlmgr User mode install, Next: tlmgr User mode backup, restore, remove, update, Up: tlmgr USER MODE +File: tlbuild.info, Node: tlmgr user mode install, Next: tlmgr user mode backup; restore; remove; update, Up: tlmgr USER MODE -B.9.1 User mode install +B.7.1 user mode install ----------------------- In user mode, the 'install' action checks that the package and all @@ -4200,14 +3935,10 @@ collection-context' would install 'collection-basic' and other collections, while in user mode, _only_ the packages mentioned in 'collection-context' are installed. - If a package shipping map files is installed in user mode, a backup -of the user's 'updmap.cfg' in 'USERTREE/web2c/' is made, and then this -file regenerated from the list of installed packages. - -File: tlbuild.info, Node: tlmgr User mode backup, restore, remove, update, Next: tlmgr User mode generate, option, paper, Prev: tlmgr User mode install, Up: tlmgr USER MODE +File: tlbuild.info, Node: tlmgr user mode backup; restore; remove; update, Next: tlmgr user mode generate; option; paper, Prev: tlmgr user mode install, Up: tlmgr USER MODE -B.9.2 User mode backup, restore, remove, update +B.7.2 user mode backup; restore; remove; update ----------------------------------------------- In user mode, these actions check that all packages to be acted on are @@ -4215,9 +3946,9 @@ installed in the user tree before proceeding; otherwise, they behave just as in normal mode. -File: tlbuild.info, Node: tlmgr User mode generate, option, paper, Prev: tlmgr User mode backup, restore, remove, update, Up: tlmgr USER MODE +File: tlbuild.info, Node: tlmgr user mode generate; option; paper, Prev: tlmgr user mode backup; restore; remove; update, Up: tlmgr USER MODE -B.9.3 User mode generate, option, paper +B.7.3 user mode generate; option; paper --------------------------------------- In user mode, these actions operate only on the user tree's @@ -4225,7 +3956,78 @@ configuration files and/or 'texlive.tlpdb'. creates configuration files in user tree -File: tlbuild.info, Node: tlmgr MULTIPLE REPOSITORIES, Next: tlmgr GUI FOR TLMGR, Prev: tlmgr USER MODE, Up: tlmgr +File: tlbuild.info, Node: tlmgr CONFIGURATION FILE FOR TLMGR, Next: tlmgr TAXONOMIES, Prev: tlmgr USER MODE, Up: tlmgr + +B.8 CONFIGURATION FILE FOR TLMGR +================================ + +A small subset of the command line options can be set in a config file +for 'tlmgr' which resides in 'TEXMFCONFIG/tlmgr/config'. By default, +the config file is in '~/.texliveYYYY/texmf-config/tlmgr/config' +(replacing 'YYYY' with the year of your TeX Live installation). This is +_not_ 'TEXMFSYSVAR', so that the file is specific to a single user. + + In this file, empty lines and lines starting with # are ignored. All +other lines must look like + + key = value + + where the allowed keys are 'gui-expertmode' (value 0 or 1), +'persistent-downloads' (value 0 or 1), 'auto-remove' (value 0 or 1), and +'gui-lang' (value like in the command line option). + + 'persistent-downloads', 'gui-lang', and 'auto-remove' correspond to +the respective command line options of the same name. 'gui-expertmode' +switches between the full GUI and a simplified GUI with only the +important and mostly used settings. + + +File: tlbuild.info, Node: tlmgr TAXONOMIES, Next: tlmgr MULTIPLE REPOSITORIES, Prev: tlmgr CONFIGURATION FILE FOR TLMGR, Up: tlmgr + +B.9 TAXONOMIES +============== + +tlmgr allows searching and listing of various categorizations, which we +call _taxonomies_, as provided by an enhanced TeX Catalogue (available +for testing at <http://az.ctan.org>). This is useful when, for example, +you don't know a specific package name but have an idea of the +functionality you need; or when you want to see all packages relating to +a given area. + + There are three different taxonomies, specified by the following +options: + +'--keyword' + + The keywords, as specified at <http://az.ctan.org/keyword>. + +'--functionality' + + The "by-topic" categorization created by J\"urgen Fenn, as + specified at <http://az.ctan.org/characterization/by-function>. + +'--characterization' + + Both the primary and secondary functionalities, as specified at + <http://az.ctan.org/characterization/choose_dimen>. + +'--taxonomy' + + Operate on all the taxonomies. + + The taxonomies are updated nightly and stored within TeX Live, so +Internet access is not required to search them. + + Examples: + + tlmgr search --taxonomy exercise # check all taxonomies for "exercise" + tlmgr search --taxonomy --word table # check for "table" on its own + tlmgr search --list --keyword # dump entire keyword taxonomy + tlmgr show --taxonomy pdftex # show pdftex package information, + # including all taxonomy entries + + +File: tlbuild.info, Node: tlmgr MULTIPLE REPOSITORIES, Next: tlmgr GUI FOR TLMGR, Prev: tlmgr TAXONOMIES, Up: tlmgr B.10 MULTIPLE REPOSITORIES ========================== @@ -4240,11 +4042,11 @@ or should not be included in TeX Live, for whatever reason. installation source to any repository (with the '-repository' or 'option repository' command line options), and perform your operations. - When you are using multiple repositories over a sustained length of -time, however, explicitly switching between them becomes inconvenient. -Thus, it's possible to tell 'tlmgr' about additional repositories you -want to use. The basic command is 'tlmgr repository add'. The rest of -this section explains further. + When you are using multiple repositories over a sustained time, +however, explicitly switching between them becomes inconvenient. Thus, +it's possible to tell 'tlmgr' about additional repositories you want to +use. The basic command is 'tlmgr repository add'. The rest of this +section explains further. When using multiple repositories, one of them has to be set as the main repository, which distributes most of the installed packages. When @@ -4335,17 +4137,15 @@ File: tlbuild.info, Node: tlmgr GUI FOR TLMGR, Next: tlmgr MACHINE-READABLE OU B.11 GUI FOR TLMGR ================== -The graphical user interface for 'tlmgr' requires Perl/Tk -<http://search.cpan.org/search?query=perl%2Ftk>. For Windows the -necessary modules are shipped within TeX Live, for all other (i.e., -Unix-based) systems Perl/Tk (as well as Perl of course) has to be -installed outside of TL. <http://tug.org/texlive/distro.html#perltk> has -a list of invocations for some distros. +The graphical user interface for 'tlmgr' needs Perl/Tk to be installed. +For Windows the necessary modules are shipped within TeX Live, for all +other (i.e., Unix-based) systems Perl/Tk (as well as Perl of course) has +to be installed. <http://tug.org/texlive/distro.html#perltk> has a list +of invocations for some distros. - The GUI is started with the invocation 'tlmgr gui'; assuming Tk is -loadable, the graphical user interface will be shown. The main window -contains a menu bar, the main display, and a status area where messages -normally shown on the console are displayed. + When started with 'tlmgr gui' the graphical user interface will be +shown. The main window contains a menu bar, the main display, and a +status area where messages normally shown on the console are displayed. Within the main display there are three main parts: the 'Display configuration' area, the list of packages, and the action buttons. @@ -4361,7 +4161,6 @@ information about what is going on. * tlmgr Main display:: * tlmgr Menu bar:: -* tlmgr GUI options:: File: tlbuild.info, Node: tlmgr Main display, Next: tlmgr Menu bar, Up: tlmgr GUI FOR TLMGR @@ -4400,8 +4199,9 @@ Category Match Select packages matching for a specific pattern. By default, this - searches both descriptions and filenames. You can also select a - subset for searching. + uses the same algorithm as 'tlmgr search', i.e., searches + everything: descriptions, taxonomies, and/or filenames. You can + also select any subset for searching. Selection @@ -4500,7 +4300,7 @@ Backup General>). -File: tlbuild.info, Node: tlmgr Menu bar, Next: tlmgr GUI options, Prev: tlmgr Main display, Up: tlmgr GUI FOR TLMGR +File: tlbuild.info, Node: tlmgr Menu bar, Prev: tlmgr Main display, Up: tlmgr GUI FOR TLMGR B.11.2 Menu bar --------------- @@ -4554,42 +4354,6 @@ The following entries can be found in the menu bar: <http://tug.org/texlive/doc.html>) and the usual "About" box. -File: tlbuild.info, Node: tlmgr GUI options, Prev: tlmgr Menu bar, Up: tlmgr GUI FOR TLMGR - -B.11.3 GUI options ------------------- - -Some generic Perl/Tk options can be specified with 'tlmgr gui' to -control the display: - -'-background' _color_ - - Set background color. - -'-font "' _fontname_ _fontsize_ '"' - - Set font, e.g., 'tlmgr gui -font "helvetica 18"'. The argument to - '-font' must be quoted, i.e., passed as a single string. - -'-foreground' _color_ - - Set foreground color. - -'-geometry' _geomspec_ - - Set the X geometry, e.g., 'tlmgr gui -geometry 1024x512-0+0' - creates the window of (approximately) the given size in the - upper-right corner of the display. - -'-xrm' _xresource_ - - Pass the arbitrary X resource string _xresource_. - - A few other obscure options are recognized but not mentioned here. -See the Perl/Tk documentation (<http://search.cpan.org/perldoc?Tk>) for -the complete list, and any X documentation for general information. - - File: tlbuild.info, Node: tlmgr MACHINE-READABLE OUTPUT, Next: tlmgr AUTHORS AND COPYRIGHT, Prev: tlmgr GUI FOR TLMGR, Up: tlmgr B.12 MACHINE-READABLE OUTPUT @@ -4754,8 +4518,6 @@ This script and its documentation were written for the TeX Live distribution (<http://tug.org/texlive>) and both are licensed under the GNU General Public License Version 2 or later. - $Id: tlmgr.pl 44422 2017-05-19 15:07:25Z karl $ - File: tlbuild.info, Node: Index, Prev: tlmgr, Up: Top @@ -4877,6 +4639,8 @@ Index * --without-x: --without-x. (line 6) * -C configure option: Build in parallel. (line 11) * -j make option: Build in parallel. (line 6) +* .travis.yml: Continuous integration. + (line 68) * adapting TeX Live for distros: Distro builds. (line 54) * adding a new generic library: Adding a new generic library module. (line 6) @@ -4934,6 +4698,8 @@ Index * CC_BUILD: Cross problems. (line 13) * chktex: Declarations and definitions. (line 18) +* ci: Continuous integration. + (line 6) * clisp: Variables for configure. (line 18) * CLISP: Variables for configure. @@ -4975,6 +4741,8 @@ Index (line 6) * configuring, for cross compilation: Cross configuring. (line 6) * const: Const. (line 6) +* continuous integration: Continuous integration. + (line 6) * conventions, coding: Coding conventions. (line 6) * CPPFLAGS: Variables for configure. (line 12) @@ -5058,7 +4826,7 @@ Index (line 6) * kpathsea library: kpathsea library. (line 6) * kpathsea.ac: kpathsea library. (line 20) -* kpse-libpng-flags.m4: png library. (line 42) +* kpse-libpng-flags.m4: png library. (line 43) * kpse-pkgs.m4: Overview of build system. (line 30) * kpse-zlib-flags.m4: zlib library. (line 6) @@ -5091,7 +4859,7 @@ Index * KPSE_LARGEFILE: Macros for libraries. (line 8) * KPSE_LIBPNG_FLAGS: Macros for library and header flags. (line 10) -* KPSE_LIBPNG_FLAGS <1>: png library. (line 42) +* KPSE_LIBPNG_FLAGS <1>: png library. (line 43) * kpse_libs_pkgs: Adding a new generic library module. (line 6) * KPSE_LIB_FLAGS: Macros for library and header flags. @@ -5107,10 +4875,10 @@ Index (line 6) * kpse_texlibs_pkgs: Adding a new TeX-specific library module. (line 11) -* KPSE_TRY_LIB: png library. (line 17) +* KPSE_TRY_LIB: png library. (line 18) * KPSE_TRY_LIB <1>: Adding a new generic library module. (line 20) -* KPSE_TRY_LIBXX: png library. (line 30) +* KPSE_TRY_LIBXX: png library. (line 31) * KPSE_TRY_LIBXX <1>: Adding a new generic library module. (line 20) * kpse_utils_pkgs: Adding a new program module. @@ -5250,6 +5018,8 @@ Index * top-level directories: Top-level directories. (line 6) * touching files to avoid rerunning: Build system tools. (line 39) +* Travis-CI: Continuous integration. + (line 6) * type cast, avoiding: Const. (line 38) * use-commit-times, Subversion: Build system tools. (line 34) * variable declarations, in source code: Declarations and definitions. @@ -5301,340 +5071,313 @@ Index Tag Table: Node: Top1208 -Node: Introduction2126 -Node: Overview of build system3878 -Node: Prerequisites5921 -Node: Building8319 -Node: Build iteration9567 -Node: Build problems10639 -Node: Build in parallel11042 -Node: Build distribution11634 -Node: Build one package12205 -Node: Installing15557 -Node: Installation directories16572 -Node: Linked scripts18388 -Node: Distro builds19869 -Node: Layout and infrastructure22259 -Node: Build system tools23087 -Node: Top-level directories25096 -Node: Autoconf macros27510 -Node: General setup macros28211 -Node: Macros for programs29078 -Node: Macros for compilers29890 -Node: Macros for libraries31324 -Node: Macros for library and header flags31750 -Node: Macros for Windows33630 -Node: Library modules35207 -Node: png library35696 -Node: zlib library37970 -Node: freetype library38485 -Node: kpathsea library39013 -Node: Program modules40412 -Node: t1utils package40840 -Node: xindy package41391 -Node: xdvik package42541 -Node: asymptote43614 -Node: Extending TeX Live44065 -Node: Adding a new program module44842 -Node: Adding a new generic library module46361 -Node: Adding a new TeX-specific library module48574 -Node: Configure options49261 -Node: Global configure options50643 -Node: --disable-native-texlive-build51185 -Node: --prefix --bindir ...52175 -Node: --disable-largefile52715 -Node: --disable-missing53400 -Node: --enable-compiler-warnings=LEVEL53801 -Node: --enable-cxx-runtime-hack54540 -Node: --enable-maintainer-mode54967 -Node: --enable-multiplatform55496 -Node: --enable-shared56034 -Node: --enable-silent-rules56405 -Node: --without-ln-s56861 -Node: --without-x57212 -Node: Program-specific configure options57400 -Node: --enable-PROG --disable-PROG58043 -Node: --disable-all-pkgs58320 -Node: Configure options for texk/web2c59306 -Node: Configure options for texk/bibtex-x61824 -Node: Configure options for texk/dvipdfm-x62367 -Node: Configure options for texk/dvisvgm63140 -Node: Configure options for texk/texlive64026 -Node: Configure options for texk/xdvik64447 -Node: Configure options for utils/xindy65051 -Node: Library-specific configure options65952 -Node: Configure options for kpathsea66963 -Node: Configure options for system poppler67672 -Node: Variables for configure68463 -Node: Cross compilation69891 -Node: Cross configuring71190 -Node: Cross problems72863 -Node: Coding conventions74510 -Node: Declarations and definitions75237 -Node: Const77419 -Node: install-tl79282 -Node: install-tl NAME79647 -Node: install-tl SYNOPSIS79805 -Node: install-tl DESCRIPTION80063 -Node: install-tl REFERENCES81130 -Node: install-tl OPTIONS81656 -Ref: install-tl *-gui* [[=]_module_]81997 -Ref: install-tl text82207 -Ref: install-tl wizard82330 -Ref: install-tl perltk82484 -Ref: install-tl *-no-gui*82915 -Ref: install-tl *-lang* _llcode_82996 -Ref: install-tl *-repository* _url|path_83683 -Ref: install-tl *-select-repository*85563 -Ref: install-tl *-all-options*85999 -Ref: install-tl *-custom-bin* _path_86254 -Ref: install-tl *-debug-translation*87085 -Ref: install-tl *-force-platform* _platform_87304 -Ref: install-tl *-help*, *--help*, *-?*87548 -Ref: install-tl *-in-place*87955 -Ref: install-tl *-init-from-profile* _profile_file_88500 -Ref: install-tl *-logfile* _file_88720 -Ref: install-tl *-no-cls*89071 -Ref: install-tl *-non-admin*89205 -Ref: install-tl *-persistent-downloads*89310 -Ref: install-tl *-no-persistent-downloads*89338 -Ref: install-tl *-no-verify-downloads*89956 -Ref: install-tl *-portable*90317 -Ref: install-tl *-print-platform*90456 -Ref: install-tl *-profile* _profile_file_90654 -Ref: install-tl *-q*90834 -Ref: install-tl *-scheme* _scheme_90896 -Ref: install-tl *-v*91370 -Ref: install-tl *-version*, *--version*91525 -Node: install-tl PROFILES91656 -Ref: install-tl instopt_adjustpath (default 0 on Unix, 1 on Windows)94306 -Ref: install-tl instopt_adjustrepo (default 1)94382 -Ref: install-tl instopt_letter (default 0)94519 -Ref: install-tl instopt_portable (default 0)94610 -Ref: install-tl instopt_write18_restricted (default 1)94706 -Node: install-tl ENVIRONMENT VARIABLES96025 -Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK96416 -Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE96618 -Ref: install-tl TEXLIVE_INSTALL_NO_WELCOME96728 -Ref: install-tl TEXLIVE_INSTALL_PREFIX96849 -Ref: install-tl TEXLIVE_INSTALL_TEXDIR96875 -Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG96906 -Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR96934 -Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME96963 -Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL96993 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG97027 -Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR97058 -Ref: install-tl NOPERLDOC97429 -Node: install-tl AUTHORS AND COPYRIGHT97493 -Node: tlmgr97905 -Node: tlmgr NAME98358 -Node: tlmgr SYNOPSIS98490 -Node: tlmgr DESCRIPTION98680 -Node: tlmgr EXAMPLES99776 -Ref: tlmgr tlmgr option repository ctan100027 -Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet100099 -Ref: tlmgr tlmgr update --list100551 -Ref: tlmgr tlmgr update --all100644 -Ref: tlmgr tlmgr info _what_100801 -Node: tlmgr OPTIONS101063 -Ref: tlmgr *--repository* _url|path_101583 -Ref: tlmgr *--gui* [_action_]102308 -Ref: tlmgr *--gui-lang* _llcode_102715 -Ref: tlmgr *--debug-translation*103398 -Ref: tlmgr *--machine-readable*103601 -Ref: tlmgr *--no-execute-actions*103869 -Ref: tlmgr *--package-logfile* _file_104062 -Ref: tlmgr *--pause*104316 -Ref: tlmgr *--persistent-downloads*104471 -Ref: tlmgr *--no-persistent-downloads*104499 -Ref: tlmgr *--pin-file*104993 -Ref: tlmgr *--require-verification*105223 -Ref: tlmgr *--no-require-verification*105251 -Ref: tlmgr *--usermode*105487 -Ref: tlmgr *--usertree* _dir_105607 -Ref: tlmgr *--verify-downloads*105722 -Ref: tlmgr *--no-verify-downloads*105746 -Node: tlmgr ACTIONS106499 -Node: tlmgr help107883 -Node: tlmgr version108359 -Node: tlmgr backup [--clean[=_N_]] [--backupdir _dir_] [--all | _pkg_]...108677 -Ref: tlmgr *--backupdir* _directory_109771 -Ref: tlmgr *--all*109968 -Ref: tlmgr *--clean*[=_N_]110190 -Ref: tlmgr *--dry-run*110487 -Node: tlmgr candidates _pkg_110607 -Ref: tlmgr *candidates _pkg_* 1110894 -Node: tlmgr check [_option_]... [files|depends|executes|runfiles|all]111038 -Ref: tlmgr *files*111481 -Ref: tlmgr *depends*111616 -Ref: tlmgr *executes*111958 -Ref: tlmgr *runfiles*112076 -Ref: tlmgr *--use-svn*112197 -Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]112314 -Node: tlmgr conf auxtrees [--conffile _file_] [show|add|delete] [_value_]112752 -Node: tlmgr dump-tlpdb [--local|--remote]115320 -Ref: tlmgr *--local*115817 -Ref: tlmgr *--remote*115856 -Node: tlmgr generate [_option_]... _what_116278 -Ref: tlmgr *generate language*116519 -Ref: tlmgr *generate language.dat*116544 -Ref: tlmgr *generate language.def*116569 -Ref: tlmgr *generate language.dat.lua*116598 -Ref: tlmgr *--dest* _output_file_118924 -Ref: tlmgr *--localcfg* _local_conf_file_119500 -Ref: tlmgr *--rebuild-sys*119623 -Node: tlmgr gui120438 -Node: tlmgr info [_option_...] [collections|schemes|_pkg_...]120684 -Ref: tlmgr *--list*122377 -Ref: tlmgr *--only-installed*122656 -Node: tlmgr init-usertree122809 -Node: tlmgr install [_option_]... _pkg_...123235 -Ref: tlmgr *--dry-run* 1123776 -Ref: tlmgr *--file*123893 -Ref: tlmgr *--force*124115 -Ref: tlmgr *--no-depends*124335 -Ref: tlmgr *--no-depends-at-all*124494 -Ref: tlmgr *--reinstall*124894 -Ref: tlmgr *--with-doc*125272 -Ref: tlmgr *--with-src*125285 -Node: tlmgr key list|add _file_|remove _keyid_125807 -Node: tlmgr option126602 -Ref: tlmgr *option [show]*126779 -Ref: tlmgr *option showall*126797 -Ref: tlmgr *option _key_ [_value_]*126823 -Node: tlmgr paper130863 -Ref: tlmgr *paper [a4|letter]*131048 -Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*131122 -Node: tlmgr path [--w32mode=user|admin] [add|remove]132149 -Node: tlmgr pinning133632 -Ref: tlmgr pinning show133939 -Ref: tlmgr pinning add _repo_ _pkgglob_...134012 -Ref: tlmgr pinning remove _repo_ _pkgglob_...134131 -Ref: tlmgr pinning remove _repo_ --all134284 -Node: tlmgr platform list|add|remove _platform_...134338 -Node: tlmgr platform set _platform_134586 -Node: tlmgr platform set auto134814 -Ref: tlmgr *--dry-run* 2135931 -Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...136040 -Node: tlmgr print-platform137342 -Node: tlmgr remove [_option_]... _pkg_...137792 -Ref: tlmgr *--backup*138274 -Ref: tlmgr *--backupdir* _directory_ 1138300 -Ref: tlmgr *--no-depends* 1139393 -Ref: tlmgr *--no-depends-at-all* 1139455 -Ref: tlmgr *--force* 1139511 -Ref: tlmgr *--dry-run* 3139983 -Node: tlmgr repository140090 -Ref: tlmgr *repository list*140322 -Ref: tlmgr *repository list _path|tag_*140352 -Ref: tlmgr *repository add _path_ [_tag_]*140385 -Ref: tlmgr *repository remove _path|tag_*140417 -Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*140471 -Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]141555 -Ref: tlmgr *--all* 1142494 -Ref: tlmgr *--backupdir* _directory_ 2142688 -Ref: tlmgr *--dry-run* 4142844 -Ref: tlmgr *--force* 2142961 -Node: tlmgr search [_option_...] _what_142989 -Node: tlmgr search [_option_...] --file _what_143329 -Node: tlmgr search [_option_...] --all _what_143575 -Ref: tlmgr *--file* 1144016 -Ref: tlmgr *--all* 2144068 -Ref: tlmgr *--global*144147 -Ref: tlmgr *--word*144259 -Node: tlmgr shell144549 -Ref: tlmgr protocol145310 -Ref: tlmgr help 1145374 -Ref: tlmgr version 1145427 -Ref: tlmgr quit, end, bye, byebye, EOF145495 -Ref: tlmgr restart145516 -Ref: tlmgr load [local|remote]145639 -Ref: tlmgr save145709 -Ref: tlmgr get [_var_] =item set [_var_ [_val_]]145832 -Node: tlmgr uninstall146324 -Ref: tlmgr *--force* 3146556 -Node: tlmgr update [_option_]... [_pkg_]...146612 -Ref: tlmgr *--all* 3146983 -Ref: tlmgr *--self*148724 -Ref: tlmgr *--dry-run* 5149488 -Ref: tlmgr *--list* [_pkg_]149665 -Ref: tlmgr *--exclude* _pkg_150354 -Ref: tlmgr *--no-auto-remove* [_pkg_]...151047 -Ref: tlmgr *--no-auto-install* [_pkg_]...151498 -Ref: tlmgr *--reinstall-forcibly-removed*152154 -Ref: tlmgr *--backup* 1152689 -Ref: tlmgr *--backupdir* _directory_ 3152715 -Ref: tlmgr *--no-depends* 2153912 -Ref: tlmgr *--no-depends-at-all* 2154115 -Ref: tlmgr *--force* 4154171 -Node: tlmgr CONFIGURATION FILE FOR TLMGR154986 -Ref: tlmgr auto-remove, value 0 or 1 (default 1), same as command-line option.155999 -Ref: tlmgr gui-expertmode, value 0 or 1 (default 1). This switches between the full GUI and a simplified GUI with only the most common settings.156136 -Ref: tlmgr gui-lang _llcode_, with a language code value as with the command-line option.156218 -Ref: tlmgr no-checksums, value 0 or 1 (default 0, see below).156272 -Ref: tlmgr persistent-downloads, value 0 or 1 (default 1), same as command-line option.156352 -Ref: tlmgr require-verification, value 0 or 1 (default 0), same as command-line option.156432 -Ref: tlmgr verify-downloads, value 0 or 1 (default 1), same as command-line option.156508 -Ref: tlmgr allowed-actions _action1_ [,_action_,...] The value is a comma-separated list of tlmgr actions which are allowed to be executed when tlmgr is invoked in system mode (that is, without --usermode).156777 -Node: tlmgr CRYPTOGRAPHIC VERIFICATION158101 -Node: tlmgr Configuration of GnuPG invocation159774 -Node: tlmgr USER MODE160412 -Node: tlmgr User mode install163235 -Node: tlmgr User mode backup, restore, remove, update164379 -Node: tlmgr User mode generate, option, paper164821 -Node: tlmgr MULTIPLE REPOSITORIES165197 -Node: tlmgr Pinning166926 -Node: tlmgr GUI FOR TLMGR168901 -Node: tlmgr Main display170241 -Node: tlmgr Display configuration area170493 -Ref: tlmgr Status170854 -Ref: tlmgr Category171018 -Ref: tlmgr Match171204 -Ref: tlmgr Selection171385 -Ref: tlmgr Display configuration buttons171589 -Node: tlmgr Package list area171772 -Ref: tlmgr a checkbox172356 -Ref: tlmgr package name172492 -Ref: tlmgr local revision (and version)172591 -Ref: tlmgr remote revision (and version)172966 -Ref: tlmgr short description173263 -Node: tlmgr Main display action buttons173308 -Ref: tlmgr Update all installed173574 -Ref: tlmgr Update173946 -Ref: tlmgr Install173996 -Ref: tlmgr Remove174182 -Ref: tlmgr Backup174360 -Node: tlmgr Menu bar174517 -Ref: tlmgr tlmgr menu174740 -Ref: tlmgr Options menu175048 -Ref: tlmgr Actions menu176131 -Ref: tlmgr Help menu176559 -Node: tlmgr GUI options176692 -Ref: tlmgr -background _color_176938 -Ref: tlmgr -font " _fontname_ _fontsize_ "177003 -Ref: tlmgr -foreground _color_177161 -Ref: tlmgr -geometry _geomspec_177213 -Ref: tlmgr -xrm _xresource_177405 -Node: tlmgr MACHINE-READABLE OUTPUT177673 -Node: tlmgr Machine-readable update and install output178483 -Ref: tlmgr location-url _location_179759 -Ref: tlmgr total-bytes _count_179975 -Ref: tlmgr _pkgname_180385 -Ref: tlmgr _status_180595 -Ref: tlmgr d180673 -Ref: tlmgr f180733 -Ref: tlmgr u180912 -Ref: tlmgr r180958 -Ref: tlmgr a181081 -Ref: tlmgr i181259 -Ref: tlmgr I181378 -Ref: tlmgr _localrev_181480 -Ref: tlmgr _serverrev_181587 -Ref: tlmgr _size_181699 -Ref: tlmgr _runtime_181868 -Ref: tlmgr _esttot_181938 -Node: tlmgr Machine-readable option output181971 -Node: tlmgr AUTHORS AND COPYRIGHT182483 -Node: Index182882 +Node: Introduction2183 +Node: Overview of build system3906 +Node: Prerequisites5949 +Node: Building8347 +Node: Build iteration9595 +Node: Build problems10667 +Node: Build in parallel11070 +Node: Build distribution11662 +Node: Build one package12233 +Node: Installing15585 +Node: Installation directories16600 +Node: Linked scripts18416 +Node: Distro builds19897 +Node: Layout and infrastructure22287 +Node: Build system tools23115 +Node: Top-level directories25126 +Node: Autoconf macros27540 +Node: General setup macros28241 +Node: Macros for programs29108 +Node: Macros for compilers29920 +Node: Macros for libraries31354 +Node: Macros for library and header flags31780 +Node: Macros for Windows33660 +Node: Library modules35237 +Node: png library35726 +Node: zlib library38000 +Node: freetype library38515 +Node: kpathsea library39043 +Node: Program modules40442 +Node: t1utils package40870 +Node: xindy package41421 +Node: xdvik package42571 +Node: asymptote43644 +Node: Extending TeX Live44095 +Node: Adding a new program module44872 +Node: Adding a new generic library module48167 +Node: Adding a new TeX-specific library module50380 +Node: Configure options51067 +Node: Global configure options52449 +Node: --disable-native-texlive-build52991 +Node: --prefix --bindir ...53981 +Node: --disable-largefile54521 +Node: --disable-missing55206 +Node: --enable-compiler-warnings=LEVEL55607 +Node: --enable-cxx-runtime-hack56346 +Node: --enable-maintainer-mode56773 +Node: --enable-multiplatform57302 +Node: --enable-shared57840 +Node: --enable-silent-rules58211 +Node: --without-ln-s58667 +Node: --without-x59018 +Node: Program-specific configure options59206 +Node: --enable-PROG --disable-PROG59849 +Node: --disable-all-pkgs60126 +Node: Configure options for texk/web2c61112 +Node: Configure options for texk/bibtex-x63630 +Node: Configure options for texk/dvipdfm-x64173 +Node: Configure options for texk/dvisvgm64946 +Node: Configure options for texk/texlive65832 +Node: Configure options for texk/xdvik66253 +Node: Configure options for utils/xindy66857 +Node: Library-specific configure options67758 +Node: Configure options for kpathsea68769 +Node: Configure options for system poppler69478 +Node: Variables for configure70269 +Node: Cross compilation71697 +Node: Cross configuring72996 +Node: Cross problems74669 +Node: Coding conventions76316 +Node: Declarations and definitions77055 +Node: Const79237 +Node: Continuous integration81100 +Node: install-tl84634 +Node: install-tl NAME84979 +Node: install-tl SYNOPSIS85137 +Node: install-tl DESCRIPTION85345 +Node: install-tl REFERENCES86346 +Node: install-tl OPTIONS86862 +Ref: install-tl *-gui* [[=]_module_]87216 +Ref: install-tl text87425 +Ref: install-tl wizard87548 +Ref: install-tl perltk87702 +Ref: install-tl *-no-gui*88136 +Ref: install-tl *-lang* _llcode_88217 +Ref: install-tl *-repository* _url|path_88904 +Ref: install-tl *-select-repository*90715 +Ref: install-tl *-all-options*91151 +Ref: install-tl *-custom-bin* _path_91458 +Ref: install-tl *-debug-translation*92113 +Ref: install-tl *-force-platform* _platform_92332 +Ref: install-tl *-help*, *--help*, *-?*92576 +Ref: install-tl *-in-place*92969 +Ref: install-tl *-logfile* _file_93496 +Ref: install-tl *-no-cls*93847 +Ref: install-tl *-non-admin*93978 +Ref: install-tl *--persistent-downloads*94083 +Ref: install-tl *--no-persistent-downloads*94111 +Ref: install-tl *-portable*94719 +Ref: install-tl *-print-platform*94858 +Ref: install-tl *-profile* _profile_95051 +Ref: install-tl *-q*96545 +Ref: install-tl *-scheme* _scheme_96607 +Ref: install-tl *-v*97081 +Ref: install-tl *-version*, *--version*97242 +Node: install-tl ENVIRONMENT VARIABLES97373 +Ref: install-tl TEXLIVE_INSTALL_ENV_NOCHECK97762 +Ref: install-tl TEXLIVE_INSTALL_NO_CONTEXT_CACHE97964 +Ref: install-tl TEXLIVE_INSTALL_PREFIX98070 +Ref: install-tl TEXLIVE_INSTALL_TEXMFCONFIG98101 +Ref: install-tl TEXLIVE_INSTALL_TEXMFHOME98130 +Ref: install-tl TEXLIVE_INSTALL_TEXMFLOCAL98160 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSCONFIG98194 +Ref: install-tl TEXLIVE_INSTALL_TEXMFSYSVAR98225 +Ref: install-tl TEXLIVE_INSTALL_TEXMFVAR98253 +Ref: install-tl NOPERLDOC98308 +Node: install-tl AUTHORS AND COPYRIGHT98372 +Node: tlmgr98730 +Node: tlmgr NAME99167 +Node: tlmgr SYNOPSIS99292 +Node: tlmgr DESCRIPTION99482 +Node: tlmgr EXAMPLES100578 +Ref: tlmgr tlmgr option repository http://mirror.ctan.org/systems/texlive/tlnet100869 +Ref: tlmgr tlmgr update --list101050 +Ref: tlmgr tlmgr update --all101143 +Ref: tlmgr tlmgr info _pkg_101299 +Node: tlmgr OPTIONS101505 +Ref: tlmgr *--repository* _url|path_102025 +Ref: tlmgr *--gui* [_action_]102750 +Ref: tlmgr *--gui-lang* _llcode_103157 +Ref: tlmgr *--debug-translation*103840 +Ref: tlmgr *--machine-readable*104043 +Ref: tlmgr *--no-execute-actions*104311 +Ref: tlmgr *--package-logfile* _file_104504 +Ref: tlmgr *--pause*104759 +Ref: tlmgr *--persistent-downloads*104914 +Ref: tlmgr *--no-persistent-downloads*104942 +Ref: tlmgr *--pin-file*105436 +Ref: tlmgr *--usermode*105654 +Ref: tlmgr *--usertree* _dir_105774 +Node: tlmgr ACTIONS106324 +Node: tlmgr help107556 +Node: tlmgr version108032 +Node: tlmgr backup [--clean[=_N_]] [--backupdir _dir_] [--all | _pkg_]...108350 +Ref: tlmgr *--backupdir* _directory_109444 +Ref: tlmgr *--all*109641 +Ref: tlmgr *--clean*[=_N_]109863 +Ref: tlmgr *--dry-run*110160 +Node: tlmgr candidates _pkg_110280 +Ref: tlmgr *candidates _pkg_* 1110567 +Node: tlmgr check [_option_]... [files|depends|executes|runfiles|all]110711 +Ref: tlmgr *files*111154 +Ref: tlmgr *depends*111289 +Ref: tlmgr *executes*111631 +Ref: tlmgr *runfiles*111749 +Ref: tlmgr *--use-svn*111861 +Node: tlmgr conf [texmf|tlmgr|updmap [--conffile _file_] [--delete] [_key_ [_value_]]]111978 +Node: tlmgr dump-tlpdb [--local|--remote]114050 +Ref: tlmgr *--local*114560 +Ref: tlmgr *--remote*114599 +Node: tlmgr generate [_option_]... _what_115021 +Ref: tlmgr *generate language*115262 +Ref: tlmgr *generate language.dat*115287 +Ref: tlmgr *generate language.def*115312 +Ref: tlmgr *generate language.dat.lua*115341 +Ref: tlmgr *generate fmtutil*115361 +Ref: tlmgr *--dest* _output_file_117598 +Ref: tlmgr *--localcfg* _local_conf_file_118174 +Ref: tlmgr *--rebuild-sys*118297 +Node: tlmgr gui119158 +Node: tlmgr info [_option_...] [collections|schemes|_pkg_...]119402 +Ref: tlmgr *--list*120607 +Ref: tlmgr *--only-installed*120886 +Ref: tlmgr *--taxonomy*121101 +Ref: tlmgr *--keyword*121113 +Ref: tlmgr *--functionality*121131 +Ref: tlmgr *--characterization*121152 +Node: tlmgr init-usertree121365 +Node: tlmgr install [_option_]... _pkg_...121791 +Ref: tlmgr *--file*122155 +Ref: tlmgr *--reinstall*122381 +Ref: tlmgr *--no-depends*122761 +Ref: tlmgr *--no-depends-at-all*122920 +Ref: tlmgr *--dry-run* 1123318 +Ref: tlmgr *--force*123436 +Node: tlmgr option123642 +Ref: tlmgr *option [show]*123815 +Ref: tlmgr *option showall*123833 +Ref: tlmgr *option _key_ [_value_]*123859 +Node: tlmgr paper127707 +Ref: tlmgr *paper [a4|letter]*127892 +Ref: tlmgr *[xdvi|pdftex|dvips|dvipdfmx|context|psutils] paper [_papersize_|--list]*127966 +Node: tlmgr path [--w32mode=user|admin] [add|remove]128993 +Node: tlmgr pinning130476 +Ref: tlmgr pinning show130783 +Ref: tlmgr pinning add _repo_ _pkgglob_...130856 +Ref: tlmgr pinning remove _repo_ _pkgglob_...130975 +Ref: tlmgr pinning remove _repo_ --all131128 +Node: tlmgr platform list|add|remove _platform_...131182 +Node: tlmgr platform set _platform_131430 +Node: tlmgr platform set auto131658 +Ref: tlmgr *--dry-run* 2132775 +Node: tlmgr postaction [--w32mode=user|admin] [--fileassocmode=1|2] [--all] [install|remove] [shortcut|fileassoc|script] [_pkg_]...132884 +Node: tlmgr print-platform134186 +Node: tlmgr restore [--backupdir _dir_] [--all | _pkg_ [_rev_]]134658 +Ref: tlmgr *--all* 1135554 +Ref: tlmgr *--backupdir* _directory_ 1135748 +Ref: tlmgr *--dry-run* 3135904 +Ref: tlmgr *--force* 1136021 +Node: tlmgr remove [_option_]... _pkg_...136049 +Ref: tlmgr *--no-depends* 1136572 +Ref: tlmgr *--no-depends-at-all* 1136634 +Ref: tlmgr *--force* 2136690 +Ref: tlmgr *--dry-run* 4137162 +Node: tlmgr repository137269 +Ref: tlmgr *repository list*137477 +Ref: tlmgr *repository list _path|tag_*137507 +Ref: tlmgr *repository add _path_ [_tag_]*137540 +Ref: tlmgr *repository remove _path|tag_*137572 +Ref: tlmgr *repository set _path_[#_tag_] [_path_[#_tag_] ...]*137626 +Node: tlmgr search [_option_...] _what_138710 +Node: tlmgr search [_option_...] --file _what_139221 +Node: tlmgr search [_option_...] --taxonomy _what_139472 +Node: tlmgr search [_option_...] --keyword _what_139783 +Node: tlmgr search [_option_...] --functionality _what_140101 +Node: tlmgr search [_option_...] --characterization _what_140439 +Node: tlmgr search [_option_...] --all _what_140779 +Ref: tlmgr *--global*141227 +Ref: tlmgr *--word*141339 +Ref: tlmgr *--list* 1141578 +Ref: tlmgr *--file* 1141924 +Ref: tlmgr *--taxonomy* 1141981 +Ref: tlmgr *--keyword* 1141993 +Ref: tlmgr *--functionality* 1142011 +Ref: tlmgr *--characterization* 1142032 +Ref: tlmgr *--all* 2142187 +Node: tlmgr uninstall142270 +Ref: tlmgr *--force* 3142524 +Node: tlmgr update [_option_]... [_pkg_]...142580 +Ref: tlmgr *--all* 3142951 +Ref: tlmgr *--self*144692 +Ref: tlmgr *--dry-run* 5145456 +Ref: tlmgr *--list* [_pkg_]145633 +Ref: tlmgr *--exclude* _pkg_146322 +Ref: tlmgr *--no-auto-remove* [_pkg_]...147015 +Ref: tlmgr *--no-auto-install* [_pkg_]...147466 +Ref: tlmgr *--reinstall-forcibly-removed*148122 +Ref: tlmgr *--backup* and *--backupdir* _directory_148686 +Ref: tlmgr *--no-depends* 2149867 +Ref: tlmgr *--no-depends-at-all* 2150070 +Ref: tlmgr *--force* 4150126 +Node: tlmgr USER MODE150552 +Node: tlmgr user mode install153363 +Node: tlmgr user mode backup; restore; remove; update154310 +Node: tlmgr user mode generate; option; paper154752 +Node: tlmgr CONFIGURATION FILE FOR TLMGR155128 +Node: tlmgr TAXONOMIES156219 +Ref: tlmgr --keyword 2156845 +Ref: tlmgr --functionality 2156930 +Ref: tlmgr --characterization 2157086 +Ref: tlmgr --taxonomy 2157227 +Node: tlmgr MULTIPLE REPOSITORIES157768 +Node: tlmgr Pinning159489 +Node: tlmgr GUI FOR TLMGR161464 +Node: tlmgr Main display162686 +Node: tlmgr Display configuration area162938 +Ref: tlmgr Status163299 +Ref: tlmgr Category163463 +Ref: tlmgr Match163649 +Ref: tlmgr Selection163909 +Ref: tlmgr Display configuration buttons164113 +Node: tlmgr Package list area164296 +Ref: tlmgr a checkbox164880 +Ref: tlmgr package name165016 +Ref: tlmgr local revision (and version)165115 +Ref: tlmgr remote revision (and version)165490 +Ref: tlmgr short description165787 +Node: tlmgr Main display action buttons165832 +Ref: tlmgr Update all installed166098 +Ref: tlmgr Update166470 +Ref: tlmgr Install166520 +Ref: tlmgr Remove166706 +Ref: tlmgr Backup166884 +Node: tlmgr Menu bar167041 +Ref: tlmgr tlmgr menu167238 +Ref: tlmgr Options menu167546 +Ref: tlmgr Actions menu168629 +Ref: tlmgr Help menu169057 +Node: tlmgr MACHINE-READABLE OUTPUT169190 +Node: tlmgr Machine-readable update and install output170000 +Ref: tlmgr location-url _location_171276 +Ref: tlmgr total-bytes _count_171492 +Ref: tlmgr _pkgname_171902 +Ref: tlmgr _status_172112 +Ref: tlmgr d172190 +Ref: tlmgr f172250 +Ref: tlmgr u172429 +Ref: tlmgr r172475 +Ref: tlmgr a172598 +Ref: tlmgr i172776 +Ref: tlmgr I172895 +Ref: tlmgr _localrev_172997 +Ref: tlmgr _serverrev_173104 +Ref: tlmgr _size_173216 +Ref: tlmgr _runtime_173385 +Ref: tlmgr _esttot_173455 +Node: tlmgr Machine-readable option output173488 +Node: tlmgr AUTHORS AND COPYRIGHT174000 +Node: Index174347 End Tag Table diff --git a/Master/texmf-dist/doc/info/web2c.info b/Master/texmf-dist/doc/info/web2c.info index 767f53994ee..a8c61bf1d05 100644 --- a/Master/texmf-dist/doc/info/web2c.info +++ b/Master/texmf-dist/doc/info/web2c.info @@ -1,4 +1,4 @@ -This is web2c.info, produced by makeinfo version 6.3 from web2c.texi. +This is web2c.info, produced by makeinfo version 6.5 from web2c.texi. This file documents the installation and use of the programs in Web2c, an implementation of Donald Knuth's TeX system. @@ -58,7 +58,7 @@ Web2c 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 2017, released in April 2017. +corresponds to Web2c version 2018, released in February 2018. * Menu: @@ -82,8 +82,8 @@ File: web2c.info, Node: Introduction, Next: Installation, Prev: Top, Up: Top 1 Introduction ************** -This manual corresponds to version 2017 of Web2c, released in April -2017. +This manual corresponds to version 2018 of Web2c, released in February +2018. "Web2c" is the name of a TeX implementation, originally for Unix, but now also running under DOS, Amiga, and other operating systems. By "TeX @@ -2227,9 +2227,13 @@ macros. BibTeX searches for '.bib' files using the 'BIBINPUTS' and even if it was not explicitly referenced in the .aux file. For example, E might be a conference proceedings as a whole, with the cross-referencing entries being individual articles published in - the proceedings. In some circumstances, you may want to avoid - these automatic inclusions altogether; to do this, make N a - sufficiently large number. + the proceedings. + + If you want to avoid these automatic inclusions altogether, make N + a sufficiently large number, and be sure to remove any previous + .aux and .bbl files. Otherwise the option may appear to have no + effect, since BibTeX will have added the citation for E to the + .aux, and nothing will remove it. See also: 'btxdoc.tex' @@ -2318,9 +2322,9 @@ available in many other places, of course). * Menu: -* tangle invocation:: -* weave invocation:: -* pooltype invocation:: +* tangle invocation:: +* weave invocation:: +* pooltype invocation:: File: web2c.info, Node: tangle invocation, Next: weave invocation, Up: WEB @@ -2559,7 +2563,7 @@ program. * Menu: -* dvitype output example:: +* dvitype output example:: File: web2c.info, Node: dvitype output example, Up: dvitype invocation @@ -3635,7 +3639,7 @@ Index * bibliography items, cross-referenced: bibtex invocation. (line 31) * bibtex: bibtex invocation. (line 6) * BibTeX: BibTeX. (line 6) -* BibTeX collection: bibtex invocation. (line 54) +* BibTeX collection: bibtex invocation. (line 58) * BibTeX style files: Basic BibTeX style files. (line 6) * BigEndian machines: Hardware and memory dumps. @@ -3647,9 +3651,9 @@ Index * Breitenlohner, Peter: Introduction. (line 9) * BSTINPUTS, search path for bst files: bibtex invocation. (line 18) * btex for MetaPost labels: mpost invocation. (line 48) -* btxdoc.bib: bibtex invocation. (line 48) -* btxdoc.tex: bibtex invocation. (line 42) -* btxhak.tex: bibtex invocation. (line 45) +* btxdoc.bib: bibtex invocation. (line 52) +* btxdoc.tex: bibtex invocation. (line 46) +* btxhak.tex: bibtex invocation. (line 49) * byte position: pktype invocation. (line 40) * byte position <1>: gftype invocation. (line 76) * byte swapping: Hardware and memory dumps. @@ -3830,7 +3834,7 @@ Index (line 21) * Free Software Foundation documentation system: Formats. (line 47) * freedom of Web2c: Introduction. (line 23) -* ftp.math.utah.edu: bibtex invocation. (line 54) +* ftp.math.utah.edu: bibtex invocation. (line 58) * generating source specials: tex invocation. (line 133) * geometric designs: Metafont. (line 6) * geometric font scaling: Font file formats. (line 21) @@ -4212,7 +4216,7 @@ Index * string numbers, displaying: pooltype invocation. (line 6) * string pool, writing: tangle invocation. (line 16) * string representation: pooltype invocation. (line 30) -* style design, for BibTeX: bibtex invocation. (line 45) +* style design, for BibTeX: bibtex invocation. (line 49) * style files: mft invocation. (line 67) * substitutions of font glyphs: MLTeX. (line 6) * sun: Online Metafont graphics. @@ -4245,7 +4249,7 @@ Index * terminator for filenames: \input filenames. (line 10) * terse output: bibtex invocation. (line 28) * tex: tex invocation. (line 6) -* TeX, bibliographies for: bibtex invocation. (line 54) +* TeX, bibliographies for: bibtex invocation. (line 58) * TeX, creating from Metafont: mft invocation. (line 6) * TeX, creating from WEB: weave invocation. (line 6) * TeX, description of: TeX. (line 6) @@ -4297,7 +4301,7 @@ Index * Troff, and MetaPost: mpost invocation. (line 65) * Troff, WEB for: WEB. (line 12) * Trojan horses and TeX programs: tex invocation. (line 48) -* TUGboat bibliography: bibtex invocation. (line 54) +* TUGboat bibliography: bibtex invocation. (line 58) * Type 1 conversion: Font utilities available elsewhere. (line 39) * type design, personal: Initial Metafont. (line 31) @@ -4362,7 +4366,7 @@ Index (line 69) * X toolkits and Metafont: Online Metafont graphics. (line 59) -* xampl.bib: bibtex invocation. (line 51) +* xampl.bib: bibtex invocation. (line 55) * xbfe, bitmap font editor: Font utilities available elsewhere. (line 23) * XeTeX: TeX extensions. (line 31) @@ -4386,74 +4390,74 @@ Index Tag Table: Node: Top2754 -Node: Introduction3749 -Node: Installation6907 -Node: configure options9009 -Node: Compile-time options11031 -Node: Additional targets12133 -Node: Triptrap13410 -Node: Runtime options14937 -Node: Commonalities16695 -Node: Option conventions17296 -Node: Common options18519 -Node: Path searching22899 -Node: Output file location23871 -Node: Three programs25196 -Node: Initial and virgin25950 -Node: Memory dumps26879 -Node: Creating memory dumps27335 -Node: Determining the memory dump to use28546 -Node: Hardware and memory dumps30127 -Node: Editor invocation32577 -Node: \input filenames33444 -Node: TeX36437 -Node: tex invocation37588 -Node: Initial TeX44491 -Node: Formats45855 -Node: Languages and hyphenation48781 -Node: MLTeX49211 -Node: \charsubdef50699 -Node: \tracingcharsubdef53022 -Node: TCX files53597 -Node: patgen invocation59037 -Node: Shell escapes59743 -Node: IPC and TeX63307 -Node: TeX extensions63877 -Node: Metafont65008 -Node: mf invocation66296 -Node: Initial Metafont70133 -Node: Modes71763 -Node: Online Metafont graphics74013 -Node: gftodvi invocation77438 -Node: mft invocation80258 -Node: MetaPost84256 -Node: mpost invocation85018 -Node: Initial MetaPost90194 -Node: dvitomp invocation91116 -Node: BibTeX91781 -Node: bibtex invocation92142 -Node: Basic BibTeX style files94440 -Node: WEB95770 -Node: tangle invocation97011 -Node: weave invocation99134 -Node: pooltype invocation100541 -Node: DVI utilities101671 -Node: dvicopy invocation102603 -Node: dvitype invocation103886 -Node: dvitype output example106221 -Node: Font utilities109272 -Node: Font file formats110452 -Node: gftopk invocation113721 -Node: pktogf invocation114912 -Node: pktype invocation116078 -Node: gftype invocation118901 -Node: tftopl invocation123404 -Node: pltotf invocation127997 -Node: vftovp invocation129048 -Node: vptovf invocation131283 -Node: Font utilities available elsewhere132310 -Node: Legalisms134690 -Node: References136844 -Node: Index141411 +Node: Introduction3752 +Node: Installation6913 +Node: configure options9015 +Node: Compile-time options11037 +Node: Additional targets12139 +Node: Triptrap13416 +Node: Runtime options14943 +Node: Commonalities16701 +Node: Option conventions17302 +Node: Common options18525 +Node: Path searching22905 +Node: Output file location23877 +Node: Three programs25202 +Node: Initial and virgin25956 +Node: Memory dumps26885 +Node: Creating memory dumps27341 +Node: Determining the memory dump to use28552 +Node: Hardware and memory dumps30133 +Node: Editor invocation32583 +Node: \input filenames33450 +Node: TeX36443 +Node: tex invocation37594 +Node: Initial TeX44497 +Node: Formats45861 +Node: Languages and hyphenation48787 +Node: MLTeX49217 +Node: \charsubdef50705 +Node: \tracingcharsubdef53028 +Node: TCX files53603 +Node: patgen invocation59043 +Node: Shell escapes59749 +Node: IPC and TeX63313 +Node: TeX extensions63883 +Node: Metafont65014 +Node: mf invocation66302 +Node: Initial Metafont70139 +Node: Modes71769 +Node: Online Metafont graphics74019 +Node: gftodvi invocation77444 +Node: mft invocation80264 +Node: MetaPost84262 +Node: mpost invocation85024 +Node: Initial MetaPost90200 +Node: dvitomp invocation91122 +Node: BibTeX91787 +Node: bibtex invocation92148 +Node: Basic BibTeX style files94622 +Node: WEB95952 +Node: tangle invocation97161 +Node: weave invocation99284 +Node: pooltype invocation100691 +Node: DVI utilities101821 +Node: dvicopy invocation102753 +Node: dvitype invocation104036 +Node: dvitype output example106365 +Node: Font utilities109416 +Node: Font file formats110596 +Node: gftopk invocation113865 +Node: pktogf invocation115056 +Node: pktype invocation116222 +Node: gftype invocation119045 +Node: tftopl invocation123548 +Node: pltotf invocation128141 +Node: vftovp invocation129192 +Node: vptovf invocation131427 +Node: Font utilities available elsewhere132454 +Node: Legalisms134834 +Node: References136988 +Node: Index141555 End Tag Table diff --git a/Master/texmf-dist/doc/kpathsea/kpathsea.html b/Master/texmf-dist/doc/kpathsea/kpathsea.html index d533e3c5b67..1099a4a469a 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.html +++ b/Master/texmf-dist/doc/kpathsea/kpathsea.html @@ -2,7 +2,7 @@ <html> <!-- This file documents the Kpathsea library for path searching. -Copyright (C) 1996-2017 Karl Berry & Olaf Weber. +Copyright (C) 1996-2018 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 @@ -18,8 +18,9 @@ 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 approved by the TeX Users Group. --> -<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Kpathsea: A library for path searching</title> <meta name="description" content="Kpathsea: A library for path searching"> @@ -27,7 +28,6 @@ approved by the TeX Users Group. --> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> @@ -103,18 +103,23 @@ ul.no-bullet {list-style: none} <li><a name="toc-KPSE_005fDOT-expansion-1" href="#KPSE_005fDOT-expansion">5.3.5 <code>KPSE_DOT</code> expansion</a></li> <li><a name="toc-Subdirectory-expansion-1" href="#Subdirectory-expansion">5.3.6 Subdirectory expansion</a></li> </ul></li> - <li><a name="toc-Filename-database-_0028ls_002dR_0029" href="#Filename-database">5.4 Filename database (<code>ls-R</code>)</a> + <li><a name="toc-Casefolding-search-1" href="#Casefolding-search">5.4 Casefolding search</a> + <ul class="no-bullet"> + <li><a name="toc-Casefolding-rationale-1" href="#Casefolding-rationale">5.4.1 Casefolding rationale</a></li> + <li><a name="toc-Casefolding-examples-1" href="#Casefolding-examples">5.4.2 Casefolding examples</a></li> + </ul></li> + <li><a name="toc-Filename-database-_0028ls_002dR_0029" href="#Filename-database">5.5 Filename database (<code>ls-R</code>)</a> <ul class="no-bullet"> - <li><a name="toc-ls_002dR-1" href="#ls_002dR">5.4.1 <samp>ls-R</samp></a></li> - <li><a name="toc-Filename-aliases-1" href="#Filename-aliases">5.4.2 Filename aliases</a></li> - <li><a name="toc-Database-format-1" href="#Database-format">5.4.3 Database format</a></li> + <li><a name="toc-ls_002dR-1" href="#ls_002dR">5.5.1 <samp>ls-R</samp></a></li> + <li><a name="toc-Filename-aliases-1" href="#Filename-aliases">5.5.2 Filename aliases</a></li> + <li><a name="toc-Database-format-1" href="#Database-format">5.5.3 Database format</a></li> </ul></li> - <li><a name="toc-kpsewhich_003a-Standalone-path-searching" href="#Invoking-kpsewhich">5.5 <code>kpsewhich</code>: Standalone path searching</a> + <li><a name="toc-kpsewhich_003a-Standalone-path-searching" href="#Invoking-kpsewhich">5.6 <code>kpsewhich</code>: Standalone path searching</a> <ul class="no-bullet"> - <li><a name="toc-Path-searching-options-1" href="#Path-searching-options">5.5.1 Path searching options</a></li> - <li><a name="toc-Specially_002drecognized-files-for-kpsewhich" href="#Specially_002drecognized-files">5.5.2 Specially-recognized files for <code>kpsewhich</code></a></li> - <li><a name="toc-Auxiliary-tasks-1" href="#Auxiliary-tasks">5.5.3 Auxiliary tasks</a></li> - <li><a name="toc-Standard-options-1" href="#Standard-options">5.5.4 Standard options</a></li> + <li><a name="toc-Path-searching-options-1" href="#Path-searching-options">5.6.1 Path searching options</a></li> + <li><a name="toc-Specially_002drecognized-files-for-kpsewhich" href="#Specially_002drecognized-files">5.6.2 Specially-recognized files for <code>kpsewhich</code></a></li> + <li><a name="toc-Auxiliary-tasks-1" href="#Auxiliary-tasks">5.6.3 Auxiliary tasks</a></li> + <li><a name="toc-Standard-options-1" href="#Standard-options">5.6.4 Standard options</a></li> </ul></li> </ul></li> <li><a name="toc-TeX-support-1" href="#TeX-support">6 TeX support</a> @@ -171,8 +176,8 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a <h1 class="top">Kpathsea library</h1> <p>This manual documents the Kpathsea library for path searching. It -corresponds to version 6.2.3, released in -April 2017. +corresponds to version 6.3.0, released in +February 2018. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a>:</td><td> </td><td align="left" valign="top">Overview and history. @@ -216,8 +221,8 @@ Next: <a href="#unixtex_002eftp" accesskey="n" rel="next">unixtex.ftp</a>, Previ <a name="index-introduction"></a> <a name="index-fundamental-purpose-of-Kpathsea"></a> -<p>This manual corresponds to version 6.2.3 of the Kpathsea -library, released in April 2017. +<p>This manual corresponds to version 6.3.0 of the Kpathsea +library, released in February 2018. </p> <p>The library’s fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do when @@ -235,12 +240,12 @@ this library: </li><li> Xdvik (see the ‘<samp>xdvi</samp>’ man page) </li></ul> -<p>Other software that we do not maintain also uses it. +<p>Other software that we do not maintain also uses it. </p> <p>Kpathsea is now maintained as part of the TeX Live distribution -(<a href="http://tug.org/texlive">http://tug.org/texlive</a>). For information on configuration, -building, installing, and more, see <cite><a href="http://tug.org/texinfohtml/tlbuild.html#Top">Building TeX -Live</a></cite>. +(<a href="http://tug.org/texlive">http://tug.org/texlive</a>), which includes several more +Kpathsea-using programs. For information on configuration, building, +installing, and more, see <cite><a href="http://tug.org/texinfohtml/tlbuild.html#Top">Building TeX Live</a></cite>. </p> <a name="index-interface_002c-not-frozen"></a> <a name="index-comments_002c-making"></a> @@ -252,13 +257,14 @@ suggestions, please send along (see <a href="#Reporting-bugs">Reporting bugs</a> <a name="index-license-for-using-the-library"></a> <a name="index-GNU-General-Public-License"></a> <p>The Kpathsea library is distributed under the GNU Library General -Public License (LGPL). In short, this means if you write a program -using the library, you must (offer to) distribute the source to the -library, along with any changes you have made, and allow anyone to -modify the library source and distribute their modifications. It does -not mean you have to distribute the source to your program, although -we hope you will. See accompanying files for the text of the GNU -licenses, or <a href="http://www.gnu.org/licenses">http://www.gnu.org/licenses</a>. +Public License (LGPL), version 2.1 or (at your option) any later +version. In short, this means if you write a program using the +library, you must (offer to) distribute the source to the library, +along with any changes you have made, and allow anyone to modify the +library source and distribute their modifications. It does not mean +you have to distribute the source to your program using the library, +although we hope you will. See accompanying files for the text of the +GNU licenses, or <a href="http2://www.gnu.org/licenses">http2://www.gnu.org/licenses</a>. </p> <a name="index-TeX-Users-Group"></a> <p>If you know enough about TeX to be reading this manual, then you (or @@ -266,7 +272,7 @@ your institution) should consider joining the TeX Users Group (if you’re already a member, thanks!). TUG produces the periodical <cite>TUGboat</cite>, sponsors an annual meeting and publishes the proceedings, and arranges courses on TeX for all levels of users -throughout the world. See <a href="http://tug.org">http://tug.org</a> for information. +throughout the world. See <a href="https://tug.org">https://tug.org</a> for information. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#History" accesskey="1">History</a>:</td><td> </td><td align="left" valign="top"> @@ -374,14 +380,14 @@ part of the burden, and I volunteered. <a name="index-Hoekwater_002c-Taco"></a> <a name="index-Breitenlohner_002c-Peter"></a> <p>[Karl writes again.] Indeed, time goes on. As of 2006 or so, Olaf’s -available time for Kpathsea became rather reduced, and I started -taking overall care of it again, although I did not do any significant -new development. In 2009, Taco Hoekwater made a major rearrangement -to make the library suitable for use within the MetaPost library -(see <a href="#Programming-overview">Programming overview</a>). Also, for some years now, Peter -Breitenlohner has made many improvements to the infrastructure and -kept up-to-date with respect to the overall TeX Live build, where -Kpathsea is now maintained. +available time for Kpathsea was reduced, and I started taking overall +care of it again, although I did not do any significant new +development. In 2009, Taco Hoekwater implemented a major +rearrangement to make the library suitable for use within the MetaPost +library (see <a href="#Programming-overview">Programming overview</a>). Also, for some years now, +Peter Breitenlohner has made many improvements to the infrastructure +and kept it up-to-date with respect to the overall TeX Live build, +where Kpathsea is now maintained. </p> @@ -402,18 +408,17 @@ Next: <a href="#Security" accesskey="n" rel="next">Security</a>, Previous: <a hr <a name="index-www_002etug_002eorg"></a> <a name="index-ftp_002etug_002eorg"></a> <p>This -is <a href="ftp://ftp.tug.org/tex/unixtex.ftp">ftp://ftp.tug.org/tex/unixtex.ftp</a>, last updated 13 June -2010. Also available as <a href="http://www.tug.org/unixtex.ftp">http://www.tug.org/unixtex.ftp</a>. Email -<a href="mailto:tex-k@tug.org">tex-k@tug.org</a> with comments or questions. +is <a href="https://tug.org/tex/unixtex.ftp">https://tug.org/tex/unixtex.ftp</a>, last updated 28 November +2017. Email <a href="mailto:tex-k@tug.org">tex-k@tug.org</a> with comments or questions. </p> <p>The principal free TeX distribution for Unix-like systems is TeX Live, on the web at <a href="http://tug.org/texlive">http://tug.org/texlive</a>. The pages there -describe many ways to acquire and build TeX, over the Internet or -on physical media, both the sources and precompiled binaries for many -systems, either standalone or as part of various operating system +describe many ways to acquire and.or build TeX, over the Internet +or on physical media, both the sources and precompiled binaries for +many systems, either standalone or as part of various operating system distributions. </p> -<p>Web2C, Kpathsea, Dvips, and Dviljk are no longer released as a +<p>Web2c, Kpathsea, Dvips, and Dviljk are no longer released as a separate packages. Their sources are now maintained as part of TeX Live. </p> @@ -422,16 +427,16 @@ Live. <a name="index-Knuth_002c-Donald-E_002e_002c-archive-of-programs-by"></a> <p>The host <tt>ftp.cs.stanford.edu</tt> is the original source for the files for which Donald Knuth is directly responsible: <samp>tex.web</samp>, -<samp>plain.tex</samp>, etc. However, unless you want to undertake the very -significant project of building your TeX installation from scratch, -it is far more reliable and less work to retrieve these files as part -of a larger package +<samp>plain.tex</samp>, etc. However, unless you want to undertake the +project of building your TeX installation from scratch, it is more +reliable and less work to retrieve these files as part of a larger +package. </p> <p>In any case, the Stanford ftp site is not the canonical source for anything except what was created as part of Knuth’s original TeX, so do not rely on any other files available there being up-to-date. The best place to check for up-to-date files is CTAN (the -Comprehensive TeX Archive Network), <a href="http://www.ctan.org">http://www.ctan.org</a>. +Comprehensive TeX Archive Network), <a href="https://ctan.org">https://ctan.org</a>. </p> @@ -629,9 +634,11 @@ provides. For information about searching for particular file types </td></tr> <tr><td align="left" valign="top">• <a href="#Path-expansion" accesskey="3">Path expansion</a>:</td><td> </td><td align="left" valign="top">Special constructs in search paths. </td></tr> -<tr><td align="left" valign="top">• <a href="#Filename-database" accesskey="4">Filename database</a>:</td><td> </td><td align="left" valign="top">Using an externally-built list to search. +<tr><td align="left" valign="top">• <a href="#Casefolding-search" accesskey="4">Casefolding search</a>:</td><td> </td><td align="left" valign="top">Fallback to case-insensitive search. </td></tr> -<tr><td align="left" valign="top">• <a href="#Invoking-kpsewhich" accesskey="5">Invoking kpsewhich</a>:</td><td> </td><td align="left" valign="top">Standalone path lookup. +<tr><td align="left" valign="top">• <a href="#Filename-database" accesskey="5">Filename database</a>:</td><td> </td><td align="left" valign="top">Using an externally-built list to search. +</td></tr> +<tr><td align="left" valign="top">• <a href="#Invoking-kpsewhich" accesskey="6">Invoking kpsewhich</a>:</td><td> </td><td align="left" valign="top">Standalone path lookup. </td></tr> </table> @@ -695,11 +702,17 @@ be wrong to search the disk for them. Therefore, if you fail to update <samp>ls-R</samp> when you install a new VF file, it will not be found. </p> -<p>Each path element is checked in turn: first the database, then the disk. -If a match is found, the search stops and the result is returned. This +<p>Each path element is checked in turn: first the database, then the +disk. If a match is found, the search stops and the result is +returned (unless the search explicitly requested all matches). This avoids possibly-expensive processing of path specifications that are -never needed on a particular run. (Unless the search explicitly -requested all matches.) +never needed on a particular run. +</p> +<p>On Unix-like systems, if no match is found by any of the above, and +the path element allows checking the filesystem (per the above), a +final check is made for a case-insensitive match. Thus, looking for a +name like ‘<samp>./FooBar.TeX</samp>’ will match a file ‘<samp>./foobar.tex</samp>’, +and vice versa. This is not done on Windows. See <a href="#Casefolding-search">Casefolding search</a>. </p> <a name="index-expansion_002c-path-element"></a> <p>Although the simplest and most common path element is a directory name, @@ -717,7 +730,8 @@ order as the sections. <a name="index-filenames_002c-absolute-or-explicitly-relative"></a> <p>Exception to all of the above: If the filename being searched for is absolute or explicitly relative, i.e., starts with ‘<samp>/</samp>’ or ‘<samp>./</samp>’ -or ‘<samp>../</samp>’, Kpathsea simply checks if that file exists. +or ‘<samp>../</samp>’, Kpathsea simply checks if that file exists, with a +fallback to a casefolding match if needed and enabled, as described above. </p> <a name="index-permission-denied"></a> <a name="index-unreadable-files"></a> @@ -749,8 +763,8 @@ Next: <a href="#Path-expansion" accesskey="n" rel="next">Path expansion</a>, Pre <a name="index-path-sources"></a> <a name="index-sources-for-search-paths"></a> -<p>A search path can come from many sources. In the order in which -Kpathsea uses them: +<p>A search path or other configuration value can come from many sources. +In the order in which Kpathsea looks for them: </p> <ol> <li> <a name="index-environment-variable_002c-source-for-path"></a> @@ -911,7 +925,7 @@ couldn’t affect its parent’s environment. <a name="Path-expansion"></a> <div class="header"> <p> -Next: <a href="#Filename-database" accesskey="n" rel="next">Filename database</a>, Previous: <a href="#Path-sources" accesskey="p" rel="prev">Path sources</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Casefolding-search" accesskey="n" rel="next">Casefolding search</a>, Previous: <a href="#Path-sources" accesskey="p" rel="prev">Path sources</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Path-expansion-1"></a> <h3 class="section">5.3 Path expansion</h3> @@ -923,8 +937,9 @@ Next: <a href="#Filename-database" accesskey="n" rel="next">Filename database</a search paths, similar to that in shells. As a general example: ‘<samp>~$USER/{foo,bar}//baz</samp>’ expands to all subdirectories under directories <samp>foo</samp> and <samp>bar</samp> in <tt>$USER</tt>’s home directory that -contain a directory or file <samp>baz</samp>. These expansions are explained -in the sections below. +contain a directory or file <samp>baz</samp>. +</p> +<p>These expansions are explained in the sections below. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#Default-expansion" accesskey="1">Default expansion</a>:</td><td> </td><td align="left" valign="top">a: or :a or a::b expands to a default. @@ -1247,13 +1262,203 @@ let me know. </p> <hr> +<a name="Casefolding-search"></a> +<div class="header"> +<p> +Next: <a href="#Filename-database" accesskey="n" rel="next">Filename database</a>, Previous: <a href="#Path-expansion" accesskey="p" rel="prev">Path expansion</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +</div> +<a name="Casefolding-search-1"></a> +<h3 class="section">5.4 Casefolding search</h3> + +<a name="index-casefolding-search"></a> +<a name="index-search_002c-case_002dinsensitive"></a> + +<p>In Kpathsea version 6.3.0 (released with TeX Live 2018), a new +fallback search was implemented on Unix-like systems, including Macs: +for each path element in turn, if no match is found by the normal +search, and the path element allows for checking the filesystem, a +second check is made for a case-insensitive match. +</p> +<a name="index-texmf_005fcasefold_005fsearch"></a> +<p>This is enabled at compile-time on Unix systems, and enabled at +runtime by setting the configuration variable +<code>texmf_casefold_search</code>, to a true value, e.g., ‘<samp>1</samp>’; this is +done by default in TeX Live. +</p> +<table class="menu" border="0" cellspacing="0"> +<tr><td align="left" valign="top">• <a href="#Casefolding-rationale" accesskey="1">Rationale</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +<tr><td align="left" valign="top">• <a href="#Casefolding-examples" accesskey="2">Examples</a>:</td><td> </td><td align="left" valign="top"> +</td></tr> +</table> + +<hr> +<a name="Casefolding-rationale"></a> +<div class="header"> +<p> +Next: <a href="#Casefolding-examples" accesskey="n" rel="next">Casefolding examples</a>, Up: <a href="#Casefolding-search" accesskey="u" rel="up">Casefolding search</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +</div> +<a name="Casefolding-rationale-1"></a> +<h4 class="subsection">5.4.1 Casefolding rationale</h4> + +<a name="index-casefolding-fallback-rationale"></a> +<a name="index-rationale-for-casefolding-fallback"></a> +<a name="index-system_002ddependent-casefolding-behavior"></a> + +<a name="index-filesystem_002c-case_002d_0028in_0029sensitive"></a> +<a name="index-Apple-filesystem_002c-case_002dinsensitive"></a> +<a name="index-Mac-filesystem_002c-case_002dinsensitive"></a> +<p>The purpose of the fallback casefolding search is to ease moving +complex documents between case-insensitive (file)systems and +case-sensitive ones. In particular, Apple decided to make the default +filesystem on Macs be case-insensitive some years ago, and this has +exacerbated a problem of people creating documents that use, say, an +image under the name <samp>foo.jpg</samp>, while the actual file is named +<samp>foo.JPG</samp> or <samp>Foo.jpg</samp>. It works on the Mac but if the +document is transferred and run on a standard case-sensitive Unix +(file)system, the file can’t be found, due only to differences in +case. +</p> +<p>This same problematic scenario has always existed on Windows, but for +whatever reason, it has become much more common since Apple also went +to a case-insensitive filesystem. Hence the move to change the +Kpathsea behavior now. +</p> +<a name="index-Windows-and-casefolding"></a> +<p>The fallback case-insensitive search is omitted at compile-time on +Windows, where (for practical purposes) all file names are +case-insensitive at the kernel level, and so the normal search will +already have definitively matched or not. Therefore, search results +in unusual cases can be different on Windows and Unix—but this has +always been true. +</p> + +<hr> +<a name="Casefolding-examples"></a> +<div class="header"> +<p> +Previous: <a href="#Casefolding-rationale" accesskey="p" rel="prev">Casefolding rationale</a>, Up: <a href="#Casefolding-search" accesskey="u" rel="up">Casefolding search</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +</div> +<a name="Casefolding-examples-1"></a> +<h4 class="subsection">5.4.2 Casefolding examples</h4> + +<a name="index-casefolding-examples"></a> +<a name="index-examples_002c-of-casefolding-searches"></a> + +<p>The casefolding implementation prefers exact matches to casefolded +matches within a given path element, so as to retain most +compatibility. Backward compatibility is not perfect, however, as a +casefolded match may be found in an earlier path element than an exact +match was previously found (see example #4 below). Still, preferring +the match in the earlier element seemed potentially less confusing +than otherwise, and is in fact consistent with past behavior on +Windows. Since case mismatches are rare to begin with, and name +collisions with respect only to case thus even more rare, the hope is +that it will not cause difficulties in practice. +</p> +<p>If it’s desirable in a given situation to have the exact same search +behavior as previously, that can be accomplished by setting the +configuration variable <code>texmf_casefold_search</code> to ‘<samp>0</samp>’ +(see <a href="#Path-sources">Path sources</a>). +</p> +<p>Some examples to illustrate the new behavior follow. +</p> +<p>Example #1: suppose the file <samp>./foobar.tex</samp> exists. Now, +searching for <samp>./FooBar.TeX</samp> (or any other case variation) will +succeed, returning <samp>./foobar.tex</samp>—the name as stored on disk. +In previous releases, or if <code>texmf_casefold_search</code> is false, the +search would fail. +</p> +<p>Example #2: suppose we are using a case-sensitive (file)system, and +the search path is ‘<samp>.:/somedir</samp>’, and the files +<samp>./foobar.tex</samp> and <samp>/somedir/FooBar.TeX</samp> both exist. Both +now and previously, searching for <samp>foobar.tex</samp> returns +<samp>./foobar.tex</samp>. However, searching for <samp>FooBar.TeX</samp> now +returns <samp>./foobar.tex</samp> instead of <samp>/somedir/FooBar.TeX</samp>; +this is the incompatibility mentioned above. Also (as expected), +searching for <samp>FOOBAR.TEX</samp> (or whatever variation) will now +return <samp>./foobar.tex</samp>, whereas before it would fail. Searching +for all (‘<samp>kpsewhich --all</samp>’) <samp>foobar.tex</samp> will return both +matches. +</p> +<p>Example #3: same as example #2, but on a case-insensitive +(file)system: both now and previously, searching for <samp>FooBar.TeX</samp> +returns <samp>./foobar.tex</samp>, since the system considers that a match. +The Kpathsea casefolding never comes into play. +</p> +<p>Example #4: if we have (on a case-sensitive system) both +<samp>./foobar.tex</samp> and <samp>./FOOBAR.TEX</samp>, searching with the exact +case returns that exact match, now and previously. Searching for +<samp>FooBar.tex</samp> will now return one or the other (chosen +arbitrarily), rather than failing. Perhaps unexpectedly, searching +for all <samp>foobar.tex</samp> or <samp>FooBar.tex</samp> will also return only +one or the other, not both (see more below). +</p> +<p>Example #5: the font file <samp>STIX-Regular.otf</samp> is included in +TeX Live in the system directory +<samp>texmf-dist/fonts/opentype/public/stix</samp>. Because Kpathsea never +searches the disk in the big system directory, the casefolding is not +done, and a search for ‘<samp>stix-regular.otf</samp>’ will fail (on +case-sensitive systems), as it always has. +</p> +<p>The caveat about not searching the disk amounts to saying that +casefolding does not happen in the trees specified with ‘<samp>!!</samp>’ +(see <a href="#ls_002dR">ls-R</a>), that is, where only database (<samp>ls-R</samp>) searching +is done. In TeX Live, that is the ‘<samp>texmf-local</samp>’ and +‘<samp>texmf-dist</samp>’ trees (also <code>$TEXMFSYSCONFIG</code> and +<code>$TEXMFSYSVAR</code>, but those are rarely noticed). The rationale for +this is that in practice, case mangling happens with user-created +files, not with packages distributed as part of the TeX system. +</p> +<p>One more caveat: the purpose of <code>kpsewhich</code> is to exercise the +path searching in Kpathsea as it is actually done. Therefore, as +shown above, ‘<samp>kpsewhich --all</samp>’ will not return all matches +regardless of case within a given path element. If you want to find +all matches in all directories, <code>find</code> is the best tool, although +the setup takes a couple steps: +</p> +<div class="example"> +<pre class="example">kpsewhich -show-path=tex >/tmp/texpath # search path specification +kpsewhich -expand-path="`cat /tmp/texpath`" >/tmp/texdirs # all dirs +tr ':' '\n' </tmp/texdirs >/tmp/texdirlist # colons to newlines +find `cat /tmp/texdirlist` -iname somefile.tex -print </tmp/texdirlist +</pre></div> + +<a name="index-Findutils_002c-GNU-package"></a> +<a name="index-_002diname_002c-find-predicate"></a> +<p>Sorry that it’s annoyingly lengthy, but implementing this inside +Kpathsea would be a lot of error-prone trouble for something that is +only useful for debugging. If your <code>find</code> does not support +<code>-iname</code>, you can get GNU Find from +<a href="https://www.gnu.org/software/findutils">https://www.gnu.org/software/findutils</a>. +</p> +<p>The casefolding search is implemented in the source file +<samp>kpathsea/pathsearch.c</samp>. Two implementation points: +</p> +<ul> +<li> <a name="index-access-system-call"></a> +Kpathsea never tries to check if a given directory resides on a +case-insensitive filesystem, because there is no efficient and +portable way to do so. All it does is try to see if a potential file +name is a readable normal file (with, usually, the <code>access</code> +system call). + +</li><li> Kpathsea does not do any case-insensitive matching of the directories +along the path. It’s not going to find <samp>/Some/Random/file.tex</samp> +when looking for <samp>/some/random/file.tex</samp>. The casefolding only +happens with the elements of the leaf directory. + +</li></ul> + + +<hr> <a name="Filename-database"></a> <div class="header"> <p> -Next: <a href="#Invoking-kpsewhich" accesskey="n" rel="next">Invoking kpsewhich</a>, Previous: <a href="#Path-expansion" accesskey="p" rel="prev">Path expansion</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Invoking-kpsewhich" accesskey="n" rel="next">Invoking kpsewhich</a>, Previous: <a href="#Casefolding-search" accesskey="p" rel="prev">Casefolding search</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Filename-database-_0028ls_002dR_0029"></a> -<h3 class="section">5.4 Filename database (<code>ls-R</code>)</h3> +<h3 class="section">5.5 Filename database (<code>ls-R</code>)</h3> <a name="index-filename-database"></a> <a name="index-database_002c-for-filenames"></a> @@ -1292,7 +1497,7 @@ source file <samp>kpathsea/db.c</samp>. Next: <a href="#Filename-aliases" accesskey="n" rel="next">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="ls_002dR-1"></a> -<h4 class="subsection">5.4.1 <samp>ls-R</samp></h4> +<h4 class="subsection">5.5.1 <samp>ls-R</samp></h4> <a name="index-ls_002dR-database-file"></a> <a name="index-TEXMFDBS"></a> @@ -1380,7 +1585,7 @@ is not in any of the default search paths. Next: <a href="#Database-format" accesskey="n" rel="next">Database format</a>, Previous: <a href="#ls_002dR" accesskey="p" rel="prev">ls-R</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Filename-aliases-1"></a> -<h4 class="subsection">5.4.2 Filename aliases</h4> +<h4 class="subsection">5.5.2 Filename aliases</h4> <a name="index-filename-aliases"></a> <a name="index-aliases_002c-for-filenames"></a> @@ -1417,7 +1622,7 @@ aliases. Previous: <a href="#Filename-aliases" accesskey="p" rel="prev">Filename aliases</a>, Up: <a href="#Filename-database" accesskey="u" rel="up">Filename database</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Database-format-1"></a> -<h4 class="subsection">5.4.3 Database format</h4> +<h4 class="subsection">5.5.3 Database format</h4> <a name="index-format-of-external-database"></a> <a name="index-database_002c-format-of"></a> @@ -1471,7 +1676,7 @@ btxdoc.bib Previous: <a href="#Filename-database" accesskey="p" rel="prev">Filename database</a>, Up: <a href="#Path-searching" accesskey="u" rel="up">Path searching</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="kpsewhich_003a-Standalone-path-searching"></a> -<h3 class="section">5.5 <code>kpsewhich</code>: Standalone path searching</h3> +<h3 class="section">5.6 <code>kpsewhich</code>: Standalone path searching</h3> <a name="index-kpsewhich"></a> <a name="index-path-searching_002c-standalone"></a> @@ -1512,7 +1717,7 @@ abbreviation is accepted. Next: <a href="#Specially_002drecognized-files" accesskey="n" rel="next">Specially-recognized files</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Path-searching-options-1"></a> -<h4 class="subsection">5.5.1 Path searching options</h4> +<h4 class="subsection">5.6.1 Path searching options</h4> <a name="index-path-searching-options"></a> @@ -1529,6 +1734,19 @@ filename, and returns the first file found. than one match, just one will be reported (chosen effectively at random). </p> </dd> +<dt>‘<samp>--casefold-search</samp>’</dt> +<dt>‘<samp>--no-casefold-search</samp>’</dt> +<dd><a name="index-_002d_002dcasefold_002dsearch"></a> +<a name="index-_002d_002dno_002dcasefold_002dsearch"></a> +<p>Explicitly enable or disable the fallback to a case-insensitive search +on Unix platforms (see <a href="#Casefolding-search">Casefolding search</a>); no effect on Windows. +The default is enabled, set in <code>texmf.cnf</code>. Disabling +(<code>--no-casefold-search</code>) does not mean that searches magically +become case-sensitive when the underlying (file)system is +case-insensitive, it merely means that Kpathsea does not do any +casefolding itself. +</p> +</dd> <dt>‘<samp>--dpi=<var>num</var></samp>’</dt> <dd><a name="index-_002d_002ddpi_003dnum"></a> <a name="index-_002dD-num"></a> @@ -1778,7 +1996,7 @@ in <samp>/some/coincidental/pkg1/path/</samp>, and we wouldn’t want to mat Next: <a href="#Auxiliary-tasks" accesskey="n" rel="next">Auxiliary tasks</a>, Previous: <a href="#Path-searching-options" accesskey="p" rel="prev">Path searching options</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Specially_002drecognized-files-for-kpsewhich"></a> -<h4 class="subsection">5.5.2 Specially-recognized files for <code>kpsewhich</code></h4> +<h4 class="subsection">5.6.2 Specially-recognized files for <code>kpsewhich</code></h4> <p><code>kpsewhich</code> recognizes a few special filenames on the command line and defaults to using the ‘known’ file formats for them, merely @@ -1857,7 +2075,7 @@ information about the above configuration files (among others). Next: <a href="#Standard-options" accesskey="n" rel="next">Standard options</a>, Previous: <a href="#Specially_002drecognized-files" accesskey="p" rel="prev">Specially-recognized files</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Auxiliary-tasks-1"></a> -<h4 class="subsection">5.5.3 Auxiliary tasks</h4> +<h4 class="subsection">5.6.3 Auxiliary tasks</h4> <a name="index-auxiliary-tasks"></a> @@ -1945,7 +2163,7 @@ the previous section. Previous: <a href="#Auxiliary-tasks" accesskey="p" rel="prev">Auxiliary tasks</a>, Up: <a href="#Invoking-kpsewhich" accesskey="u" rel="up">Invoking kpsewhich</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Standard-options-1"></a> -<h4 class="subsection">5.5.4 Standard options</h4> +<h4 class="subsection">5.6.4 Standard options</h4> <a name="index-standard-options"></a> @@ -1972,22 +2190,23 @@ Next: <a href="#Programming" accesskey="n" rel="next">Programming</a>, Previous: <a name="index-TeX-support"></a> -<p>Although the basic features in Kpathsea can be used for any type of path -searching, it came about (like all libraries) with a specific -application in mind: I wrote Kpathsea specifically for TeX system -programs. I had been struggling with the programs I was using (Dvips, -Xdvi, and TeX itself) having slightly different notions of how to -specify paths; and debugging was painful, since no code was shared. +<p>Although the basic features in Kpathsea can be used for any type of +path searching, it came about, as usual, with a specific application +in mind: I wrote Kpathsea specifically for TeX system programs. I +had been struggling with the programs I was using (Dvips, Xdvi, and +TeX itself) having slightly different notions of how to specify +paths; and debugging was painful, since no code was shared. </p> -<p>Therefore, Kpathsea provides some TeX-specific formats and features. -Indeed, many of the supposedly generic path searching features were -provided because they seemed useful in that conTeXt (font lookup, -particularly). +<p>Therefore, Kpathsea provides some TeX-specific formats and +features. Indeed, many of the purportedly generic path searching +features were provided because they seemed useful in that conTeXt +(font lookup, particularly). </p> <p>Kpathsea provides a standard way to search for files of any of the -supported file types; glyph fonts are a bit different than all the rest. -Searches are based solely on filenames, not file contents—if a GF -file is named <samp>cmr10.600pk</samp>, it will be found as a PK file. +supported file types; glyph fonts are a bit different than all the +rest. Searches are based solely on names of files, not their +contents—if a GF file is (mis)named <samp>cmr10.600pk</samp>, it will be +found as a PK file. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#Supported-file-formats" accesskey="1">Supported file formats</a>:</td><td> </td><td align="left" valign="top">File types Kpathsea knows about. @@ -2714,16 +2933,24 @@ file is; TeX documents will find their favorite name. </p> <ul> <li> <a name="index-comments_002c-in-fontmap-files"></a> -Comments start with ‘<samp>%</samp>’ and continue to the end of the line. +Comments start with the last ‘<samp>%</samp>’ on a line and continue to +the end of the line. (This provides for names that include a %, +ill-advised as that may be.) + </li><li> <a name="index-whitespace_002c-in-fontmap-files"></a> Blank lines are ignored. + </li><li> Each nonblank line is broken up into a series of <em>words</em>: a sequence of non-whitespace characters. + </li><li> <a name="index-include-fontmap-directive"></a> If the first word is ‘<samp>include</samp>’, the second word is used as a filename, and it is searched for and read. + </li><li> Otherwise, the first word on each line is the true filename; + </li><li> the second word is the alias; + </li><li> subsequent words are ignored. </li></ul> @@ -3238,7 +3465,6 @@ script. </dl> - <hr> <a name="Programming"></a> <div class="header"> @@ -3249,7 +3475,8 @@ Next: <a href="#Reporting-bugs" accesskey="n" rel="next">Reporting bugs</a>, Pre <h2 class="chapter">7 Programming</h2> <p>This chapter is for programmers who wish to use Kpathsea. -See <a href="#Introduction">Introduction</a>, for the conditions under which you may do so. +See <a href="#Introduction">Introduction</a>, for the conditions under which you may do so (in +short, it is released under LGPLv2.1 or later). </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#Programming-overview" accesskey="1">Overview</a>:</td><td> </td><td align="left" valign="top">Introduction. @@ -3276,24 +3503,26 @@ Next: <a href="#Calling-sequence" accesskey="n" rel="next">Calling sequence</a>, <a name="index-overview-of-programming-with-Kpathsea"></a> <p>Aside from this manual, your best source of information is the source -to the programs that use Kpathsea (see <a href="#Introduction">Introduction</a>). Of those, -Dviljk is probably the simplest, and hence a good place to start. -Xdvik adds VF support and the complication of X resources. Dvipsk -adds the complication of its own config files. Web2c is source code I -also maintain, so it uses Kpathsea rather straightforwardly, but is of -course complicated by the Web to C translation. Finally, Kpsewhich is -a small utility program whose sole purpose is to exercise the main -path-searching functionality. +to the programs that use Kpathsea (see <a href="#Introduction">Introduction</a>). First, +Kpsewhich is a small utility program whose sole purpose is to exercise +the main path-searching functionality. Of the drivers, Dviljk is +probably the simplest full application program. Xdvik adds VF support +and the complication of X resources. Dvipsk adds the complication of +its own config files. Web2c is source code I also maintain, so it +uses Kpathsea rather straightforwardly, but is of course complicated +by the Web to C translation. </p> <a name="index-re_002dentrant-API"></a> <a name="index-API_002c-re_002dentrant"></a> <p>When looking at these program sources, you should know that previous -versions of the library had a different programming interface, to -support re-entrancy. In that interface the library function names -were prefixed with <code>kpse_</code> instead of <code>kpathsea_</code>, and they -did not need an instance variable as first argument. This change was -made in 2009. Some of the programs mentioned above may still be using -the previous interface. +versions of the library had a different programming interface; the +current interface supports re-entrancy. Historically, the library +function names were prefixed with <code>kpse_</code> instead of +<code>kpathsea_</code>, and they did not need an instance variable as first +argument. This change was made in 2009. The old functions will never +disappear, and can reliably continue to be used when they suffice, as +they do for the programs above. The main application using the +re-entrant API is the MetaPost library used by MetaPost and LuaTeX. </p> <a name="index-pathsearch_002eh"></a> <a name="index-tex_002dfile_002eh"></a> @@ -4288,6 +4517,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_symbol-3">-</a></th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dall"><code>--all</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002d_002dcasefold_002dsearch"><code>--casefold-search</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dcolor_003dtty"><code>--color=tty</code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002ddebug_003dnum"><code>--debug=<var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Auxiliary-tasks">Auxiliary tasks</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002ddpi_003dnum"><code>--dpi=<var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> @@ -4302,6 +4532,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-_002d_002dmktex_003dfiletype"><code>--mktex=<var>filetype</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dmode_003dstring"><code>--mode=<var>string</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dmust_002dexist"><code>--must-exist</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dcasefold_002dsearch"><code>--no-casefold-search</code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dno_002dmktex_003dfiletype"><code>--no-mktex=<var>filetype</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dpath_003dstring"><code>--path=<var>string</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002d_002dprogname_003dname"><code>--progname=<var>name</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> @@ -4321,6 +4552,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-_002d1-debugging-value"><code>-1 <span class="roman">debugging value</span></code></a>:</td><td> </td><td valign="top"><a href="#Debugging">Debugging</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dA-option-to-ls"><code>-A <span class="roman">option to <code>ls</code></span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dD-num"><code>-D <var>num</var></code></a>:</td><td> </td><td valign="top"><a href="#Path-searching-options">Path searching options</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002diname_002c-find-predicate"><code>-iname<span class="roman">, find predicate</span></code></a>:</td><td> </td><td valign="top"><a href="#Casefolding-examples">Casefolding examples</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dL-option-to-ls"><code>-L <span class="roman">option to <code>ls</code></span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_symbol-4">.</a></th><td></td><td></td></tr> @@ -4408,6 +4640,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-absolute-filenames">absolute filenames</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-access-system-call"><code>access <span class="roman">system call</span></code></a>:</td><td> </td><td valign="top"><a href="#Casefolding-examples">Casefolding examples</a></td></tr> <tr><td></td><td valign="top"><a href="#index-access-warnings">access warnings</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> <tr><td></td><td valign="top"><a href="#index-AFMFONTS"><code>AFMFONTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-aliases-for-fonts">aliases for fonts</a>:</td><td> </td><td valign="top"><a href="#Fontmap">Fontmap</a></td></tr> @@ -4419,6 +4652,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-API_002c-re_002dentrant">API, re-entrant</a>:</td><td> </td><td valign="top"><a href="#Programming-overview">Programming overview</a></td></tr> <tr><td></td><td valign="top"><a href="#index-append_002donly-directories-and-mktexpk">append-only directories and <code>mktexpk</code></a>:</td><td> </td><td valign="top"><a href="#Security">Security</a></td></tr> <tr><td></td><td valign="top"><a href="#index-appendonlydir"><code>appendonlydir</code></a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-Apple-filesystem_002c-case_002dinsensitive">Apple filesystem, case-insensitive</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr> <tr><td></td><td valign="top"><a href="#index-arguments-to-mktex">arguments to <samp>mktex</samp></a>:</td><td> </td><td valign="top"><a href="#mktex-script-arguments">mktex script arguments</a></td></tr> <tr><td></td><td valign="top"><a href="#index-argv_005b0_005d"><code>argv[0]</code></a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr> <tr><td></td><td valign="top"><a href="#index-autoconf_002c-recommended"><code>autoconf<span class="roman">, recommended</span></code></a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr> @@ -4448,6 +4682,9 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-c_002dauto_002eh"><code>c-auto.h</code></a>:</td><td> </td><td valign="top"><a href="#Programming-overview">Programming overview</a></td></tr> <tr><td></td><td valign="top"><a href="#index-cache-of-fonts_002c-local">cache of fonts, local</a>:</td><td> </td><td valign="top"><a href="#Security">Security</a></td></tr> <tr><td></td><td valign="top"><a href="#index-calling-sequence">calling sequence</a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-casefolding-examples">casefolding examples</a>:</td><td> </td><td valign="top"><a href="#Casefolding-examples">Casefolding examples</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-casefolding-fallback-rationale">casefolding fallback rationale</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-casefolding-search">casefolding search</a>:</td><td> </td><td valign="top"><a href="#Casefolding-search">Casefolding search</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ChangeLog-entry"><code>ChangeLog <span class="roman">entry</span></code></a>:</td><td> </td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr> <tr><td></td><td valign="top"><a href="#index-checklist-for-bug-reports">checklist for bug reports</a>:</td><td> </td><td valign="top"><a href="#Bug-checklist">Bug checklist</a></td></tr> <tr><td></td><td valign="top"><a href="#index-checksum"><code>checksum</code></a>:</td><td> </td><td valign="top"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr> @@ -4534,6 +4771,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-environment-variables_002c-old">environment variables, old</a>:</td><td> </td><td valign="top"><a href="#Unable-to-find-files">Unable to find files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-epoch_002c-seconds-since">epoch, seconds since</a>:</td><td> </td><td valign="top"><a href="#Logging">Logging</a></td></tr> <tr><td></td><td valign="top"><a href="#index-error-message-macros">error message macros</a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-examples_002c-of-casefolding-searches">examples, of casefolding searches</a>:</td><td> </td><td valign="top"><a href="#Casefolding-examples">Casefolding examples</a></td></tr> <tr><td></td><td valign="top"><a href="#index-excessive-startup-time">excessive startup time</a>:</td><td> </td><td valign="top"><a href="#Slow-path-searching">Slow path searching</a></td></tr> <tr><td></td><td valign="top"><a href="#index-expand_002ec"><code>expand.c</code></a>:</td><td> </td><td valign="top"><a href="#Brace-expansion">Brace expansion</a></td></tr> <tr><td></td><td valign="top"><a href="#index-expanding-symlinks">expanding symlinks</a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr> @@ -4563,6 +4801,8 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-filenames_002c-absolute-or-explicitly-relative">filenames, absolute or explicitly relative</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> <tr><td></td><td valign="top"><a href="#index-files_002c-unable-to-find">files, unable to find</a>:</td><td> </td><td valign="top"><a href="#Unable-to-find-files">Unable to find files</a></td></tr> <tr><td></td><td valign="top"><a href="#index-filesystem-search">filesystem search</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-filesystem_002c-case_002d_0028in_0029sensitive">filesystem, case-(in)sensitive</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-Findutils_002c-GNU-package">Findutils, GNU package</a>:</td><td> </td><td valign="top"><a href="#Casefolding-examples">Casefolding examples</a></td></tr> <tr><td></td><td valign="top"><a href="#index-floating-directories">floating directories</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> <tr><td></td><td valign="top"><a href="#index-fmtutil"><code>fmtutil</code></a>:</td><td> </td><td valign="top"><a href="#mktex-script-names">mktex script names</a></td></tr> <tr><td></td><td valign="top"><a href="#index-fmtutil_002ecnf"><code>fmtutil.cnf</code></a>:</td><td> </td><td valign="top"><a href="#Specially_002drecognized-files">Specially-recognized files</a></td></tr> @@ -4682,6 +4922,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-ls_002dR_002c-simplest-build"><code>ls-R<span class="roman">, simplest build</span></code></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_letter-M">M</a></th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-Mac-filesystem_002c-case_002dinsensitive">Mac filesystem, case-insensitive</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr> <tr><td></td><td valign="top"><a href="#index-MacKenzie_002c-David">MacKenzie, David</a>:</td><td> </td><td valign="top"><a href="#History">History</a></td></tr> <tr><td></td><td valign="top"><a href="#index-MacKenzie_002c-David-1">MacKenzie, David</a>:</td><td> </td><td valign="top"><a href="#Subdirectory-expansion">Subdirectory expansion</a></td></tr> <tr><td></td><td valign="top"><a href="#index-magic-characters">magic characters</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> @@ -4789,6 +5030,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-quoting-variable-values">quoting variable values</a>:</td><td> </td><td valign="top"><a href="#Variable-expansion">Variable expansion</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_letter-R">R</a></th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-rationale-for-casefolding-fallback">rationale for casefolding fallback</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr> <tr><td></td><td valign="top"><a href="#index-re_002dentrant-API">re-entrant API</a>:</td><td> </td><td valign="top"><a href="#Programming-overview">Programming overview</a></td></tr> <tr><td></td><td valign="top"><a href="#index-readable"><code>readable</code></a>:</td><td> </td><td valign="top"><a href="#Suppressing-warnings">Suppressing warnings</a></td></tr> <tr><td></td><td valign="top"><a href="#index-reading-arbitrary_002dlength-lines">reading arbitrary-length lines</a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr> @@ -4810,6 +5052,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-Sauter-fonts_002c-and-dynamic-source-creation">Sauter fonts, and dynamic source creation</a>:</td><td> </td><td valign="top"><a href="#mktex-scripts">mktex scripts</a></td></tr> <tr><td></td><td valign="top"><a href="#index-scripts-for-file-creation">scripts for file creation</a>:</td><td> </td><td valign="top"><a href="#mktex-scripts">mktex scripts</a></td></tr> <tr><td></td><td valign="top"><a href="#index-search-path_002c-defined">search path, defined</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-search_002c-case_002dinsensitive">search, case-insensitive</a>:</td><td> </td><td valign="top"><a href="#Casefolding-search">Casefolding search</a></td></tr> <tr><td></td><td valign="top"><a href="#index-searching-for-files">searching for files</a>:</td><td> </td><td valign="top"><a href="#File-lookup">File lookup</a></td></tr> <tr><td></td><td valign="top"><a href="#index-searching-for-glyphs">searching for glyphs</a>:</td><td> </td><td valign="top"><a href="#Glyph-lookup">Glyph lookup</a></td></tr> <tr><td></td><td valign="top"><a href="#index-searching-overview">searching overview</a>:</td><td> </td><td valign="top"><a href="#Searching-overview">Searching overview</a></td></tr> @@ -4854,6 +5097,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-symbolic-links_002c-and-ls_002dR">symbolic links, and <samp>ls-R</samp></a>:</td><td> </td><td valign="top"><a href="#ls_002dR">ls-R</a></td></tr> <tr><td></td><td valign="top"><a href="#index-symlinks_002c-resolving">symlinks, resolving</a>:</td><td> </td><td valign="top"><a href="#Calling-sequence">Calling sequence</a></td></tr> <tr><td></td><td valign="top"><a href="#index-system-C-compiler-bugs">system C compiler bugs</a>:</td><td> </td><td valign="top"><a href="#TeX-or-Metafont-failing">TeX or Metafont failing</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-system_002ddependent-casefolding-behavior">system-dependent casefolding behavior</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_letter-T">T</a></th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-T1FONTS"><code>T1FONTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> @@ -4907,6 +5151,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-TEXMFSCRIPTS"><code>TEXMFSCRIPTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-texmfvar"><code>texmfvar</code></a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TEXMFVAR"><code>TEXMFVAR</code></a>:</td><td> </td><td valign="top"><a href="#mktex-configuration">mktex configuration</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-texmf_005fcasefold_005fsearch"><code>texmf_casefold_search</code></a>:</td><td> </td><td valign="top"><a href="#Casefolding-search">Casefolding search</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TEXPICTS"><code>TEXPICTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TEXPKS"><code>TEXPKS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TEXPOOL"><code>TEXPOOL</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> @@ -4969,6 +5214,7 @@ Previous: <a href="#Reporting-bugs" accesskey="p" rel="prev">Reporting bugs</a>, <tr><td></td><td valign="top"><a href="#index-WEBINPUTS"><code>WEBINPUTS</code></a>:</td><td> </td><td valign="top"><a href="#Supported-file-formats">Supported file formats</a></td></tr> <tr><td></td><td valign="top"><a href="#index-whitespace_002c-in-fontmap-files">whitespace, in fontmap files</a>:</td><td> </td><td valign="top"><a href="#Fontmap">Fontmap</a></td></tr> <tr><td></td><td valign="top"><a href="#index-whitespace_002c-not-ignored-on-continuation-lines">whitespace, not ignored on continuation lines</a>:</td><td> </td><td valign="top"><a href="#Config-files">Config files</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-Windows-and-casefolding">Windows and casefolding</a>:</td><td> </td><td valign="top"><a href="#Casefolding-rationale">Casefolding rationale</a></td></tr> <tr><td></td><td valign="top"><a href="#index-www_002etug_002eorg"><code>www.tug.org</code></a>:</td><td> </td><td valign="top"><a href="#unixtex_002eftp">unixtex.ftp</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_letter-X">X</a></th><td></td><td></td></tr> diff --git a/Master/texmf-dist/doc/kpathsea/kpathsea.pdf b/Master/texmf-dist/doc/kpathsea/kpathsea.pdf Binary files differindex 484c7ea177d..cf88c22dea7 100644 --- a/Master/texmf-dist/doc/kpathsea/kpathsea.pdf +++ b/Master/texmf-dist/doc/kpathsea/kpathsea.pdf diff --git a/Master/texmf-dist/doc/man/man1/afm2pl.man1.pdf b/Master/texmf-dist/doc/man/man1/afm2pl.man1.pdf Binary files differindex e9922eac922..ec3132cf36a 100644 --- a/Master/texmf-dist/doc/man/man1/afm2pl.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/afm2pl.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/afm2tfm.man1.pdf b/Master/texmf-dist/doc/man/man1/afm2tfm.man1.pdf Binary files differindex f3d1e7c4bba..8c4161d0483 100644 --- a/Master/texmf-dist/doc/man/man1/afm2tfm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/afm2tfm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/aleph.1 b/Master/texmf-dist/doc/man/man1/aleph.1 index cb1b99966c8..0be54ff0681 100644 --- a/Master/texmf-dist/doc/man/man1/aleph.1 +++ b/Master/texmf-dist/doc/man/man1/aleph.1 @@ -1,4 +1,4 @@ -.TH ALEPH 1 "16 June 2015" "Web2C 2017" +.TH ALEPH 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/aleph.man1.pdf b/Master/texmf-dist/doc/man/man1/aleph.man1.pdf Binary files differindex cad800cda0f..49fbf67d1ed 100644 --- a/Master/texmf-dist/doc/man/man1/aleph.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/aleph.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/allcm.man1.pdf b/Master/texmf-dist/doc/man/man1/allcm.man1.pdf Binary files differindex ab5ffeb1a9a..1cc2efb936b 100644 --- a/Master/texmf-dist/doc/man/man1/allcm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/allcm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/allec.man1.pdf b/Master/texmf-dist/doc/man/man1/allec.man1.pdf Binary files differindex 0cdab102bb4..795ac669014 100644 --- a/Master/texmf-dist/doc/man/man1/allec.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/allec.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/allneeded.man1.pdf b/Master/texmf-dist/doc/man/man1/allneeded.man1.pdf Binary files differindex 59d782f5f37..ccfdd987380 100644 --- a/Master/texmf-dist/doc/man/man1/allneeded.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/allneeded.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/amstex.1 b/Master/texmf-dist/doc/man/man1/amstex.1 index 4bc10a00591..6ad67fd1716 100644 --- a/Master/texmf-dist/doc/man/man1/amstex.1 +++ b/Master/texmf-dist/doc/man/man1/amstex.1 @@ -1,4 +1,4 @@ -.TH AMSTEX 1 "16 June 2015" "Web2C 2017" +.TH AMSTEX 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/amstex.man1.pdf b/Master/texmf-dist/doc/man/man1/amstex.man1.pdf Binary files differindex 5671d98d828..ae40f6badd8 100644 --- a/Master/texmf-dist/doc/man/man1/amstex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/amstex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/autosp.man1.pdf b/Master/texmf-dist/doc/man/man1/autosp.man1.pdf Binary files differindex 57be0cec183..c0904cc0581 100644 --- a/Master/texmf-dist/doc/man/man1/autosp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/autosp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/axohelp.1 b/Master/texmf-dist/doc/man/man1/axohelp.1 new file mode 100644 index 00000000000..47f62fd5ff8 --- /dev/null +++ b/Master/texmf-dist/doc/man/man1/axohelp.1 @@ -0,0 +1,48 @@ +.TH "axohelp" "1.1" "22 Jan 2018" "" +.SH NAME +axohelp - helper program for use of LaTeX package axodraw2 with +pdflatex. +.SH SYNOPSIS +.B axohelp [options] [filename] +.SH DESCRIPTION +Axohelp is a program used with the axodraw2, which is a LaTeX package +for drawing Feynman graphs (and some other simple graphics) in LaTeX +documents. + +When the axodraw2 package is used with pdflatex (or lualatex or +xelatex) it creates a file with extension .ax1. This contains +specifications of the graphics elements. Axohelp converts this to a +file with extension ax2 that contains the necessary pdf code. +The .ax2 file is read by pdflatex (etc) on its next run, and the +contents of the .ax2 file are used in the final .pdf output file to +draw the desired graphics. + +The files processed are specified as follows: When the filename on the +command line is of the form file.ax1, then the input file is file.ax1 +and the output file is file.ax2. If the filename on the command line +does not have extension .ax1, then this extension is appended. + + +.SH OPTIONS +Options can be introduced by single or double hyphen characters. The +possible options are: + +.TP +.B -h, --help +Gives usage information + +.TP +.B -v, --version +Gives version information + +.TP +.B -V +NOT CURRENTLY IMPLEMENTED: Give information on each function used. + +.SH AUTHOR +Current version, by John Collins (username jcc8 at node psu.edu) and +Jos Vermaseren (username t68 at nikhef dot nl). + +The released version can be obtained from CTAN: +<http://www.ctan.org/pkg/axodraw2/>, and an author's website +<https://www.nikhef.nl/~form/maindir/others/axodraw2/axodraw2.html>. diff --git a/Master/texmf-dist/doc/man/man1/bbox.man1.pdf b/Master/texmf-dist/doc/man/man1/bbox.man1.pdf Binary files differindex cbee131db07..e2f4626ad05 100644 --- a/Master/texmf-dist/doc/man/man1/bbox.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/bbox.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/bg5conv.man1.pdf b/Master/texmf-dist/doc/man/man1/bg5conv.man1.pdf Binary files differindex e0f9073dc09..bd99cad7629 100644 --- a/Master/texmf-dist/doc/man/man1/bg5conv.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/bg5conv.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/bibtex.1 b/Master/texmf-dist/doc/man/man1/bibtex.1 index cf828c0cf42..0d75cb5a662 100644 --- a/Master/texmf-dist/doc/man/man1/bibtex.1 +++ b/Master/texmf-dist/doc/man/man1/bibtex.1 @@ -1,4 +1,4 @@ -.TH BIBTEX 1 "16 June 2015" "bibtex 0.99d" "Web2C 2017" +.TH BIBTEX 1 "23 February 2018" "bibtex 0.99d" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX @@ -63,8 +63,20 @@ The .B \-min-crossrefs option defines the minimum number of .B crossref -required for automatic inclusion of the crossref'd entry on the citation +required for automatic inclusion of the crossref base entry in the citation list; the default is two. +To avoid these automatic inclusions altogether, give this option +a sufficiently large number, and be sure to remove any +previous +.B .aux +and +.B .bbl +files. Otherwise the option may +appear to have no effect, since \*(BX will have added the citation +for the base entry to the +.B .aux +file, and nothing will remove it. +.PP With the .B \-terse option, \*(BX operates silently. Without it, a banner and progress diff --git a/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf b/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf Binary files differindex 78cd1711c60..078d4287ce7 100644 --- a/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/bibtex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cef5conv.man1.pdf b/Master/texmf-dist/doc/man/man1/cef5conv.man1.pdf Binary files differindex cfac56a6fad..807741ce200 100644 --- a/Master/texmf-dist/doc/man/man1/cef5conv.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cef5conv.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cefconv.man1.pdf b/Master/texmf-dist/doc/man/man1/cefconv.man1.pdf Binary files differindex c0c95c52243..128f86deb05 100644 --- a/Master/texmf-dist/doc/man/man1/cefconv.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cefconv.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cefsconv.man1.pdf b/Master/texmf-dist/doc/man/man1/cefsconv.man1.pdf Binary files differindex 66182fff178..0bdf417e164 100644 --- a/Master/texmf-dist/doc/man/man1/cefsconv.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cefsconv.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cfftot1.1 b/Master/texmf-dist/doc/man/man1/cfftot1.1 index fdc6c71a821..a4624a52fed 100644 --- a/Master/texmf-dist/doc/man/man1/cfftot1.1 +++ b/Master/texmf-dist/doc/man/man1/cfftot1.1 @@ -1,4 +1,4 @@ -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/cfftot1.man1.pdf b/Master/texmf-dist/doc/man/man1/cfftot1.man1.pdf Binary files differindex ccd29d75fad..9a07c0b58e6 100644 --- a/Master/texmf-dist/doc/man/man1/cfftot1.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cfftot1.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/chktex.man1.pdf b/Master/texmf-dist/doc/man/man1/chktex.man1.pdf Binary files differindex 46342422413..e0f2a2febf5 100644 --- a/Master/texmf-dist/doc/man/man1/chktex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/chktex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/chkweb.man1.pdf b/Master/texmf-dist/doc/man/man1/chkweb.man1.pdf Binary files differindex 633bbcfba20..e68963410a7 100644 --- a/Master/texmf-dist/doc/man/man1/chkweb.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/chkweb.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf b/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf Binary files differindex 32e6173adb0..742ef80ac15 100644 --- a/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ctangle.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ctie.1 b/Master/texmf-dist/doc/man/man1/ctie.1 index 6c1d6184aea..cd8b9014cf5 100644 --- a/Master/texmf-dist/doc/man/man1/ctie.1 +++ b/Master/texmf-dist/doc/man/man1/ctie.1 @@ -1,4 +1,4 @@ -.TH CTIE 1 "7 April 2010" "Web2C 2017" +.TH CTIE 1 "7 April 2010" "Web2C 2018" .\"===================================================================== .SH NAME ctie \- merge or apply CWEB change files diff --git a/Master/texmf-dist/doc/man/man1/ctie.man1.pdf b/Master/texmf-dist/doc/man/man1/ctie.man1.pdf Binary files differindex f25ab6b158c..35144c9d2bc 100644 --- a/Master/texmf-dist/doc/man/man1/ctie.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ctie.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cweave.man1.pdf b/Master/texmf-dist/doc/man/man1/cweave.man1.pdf Binary files differindex ec7898cc846..c09c6a316b8 100644 --- a/Master/texmf-dist/doc/man/man1/cweave.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cweave.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/cweb.1 b/Master/texmf-dist/doc/man/man1/cweb.1 index 0d2446c0504..20df712a52a 100644 --- a/Master/texmf-dist/doc/man/man1/cweb.1 +++ b/Master/texmf-dist/doc/man/man1/cweb.1 @@ -1,4 +1,4 @@ -.TH CWEB 1 "7 April 2010" "Web2C 2017" +.TH CWEB 1 "7 April 2010" "Web2C 2018" .\"===================================================================== .SH NAME ctangle, cweave \- translate CWEB to C and/or TeX diff --git a/Master/texmf-dist/doc/man/man1/cweb.man1.pdf b/Master/texmf-dist/doc/man/man1/cweb.man1.pdf Binary files differindex 5face173095..abcb5c71953 100644 --- a/Master/texmf-dist/doc/man/man1/cweb.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/cweb.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/detex.man1.pdf b/Master/texmf-dist/doc/man/man1/detex.man1.pdf Binary files differindex 13bced697ce..1757b555290 100644 --- a/Master/texmf-dist/doc/man/man1/detex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/detex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/devnag.man1.pdf b/Master/texmf-dist/doc/man/man1/devnag.man1.pdf Binary files differindex 6c34dee84d6..65f740b520d 100644 --- a/Master/texmf-dist/doc/man/man1/devnag.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/devnag.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/deweb.man1.pdf b/Master/texmf-dist/doc/man/man1/deweb.man1.pdf Binary files differindex eafc9b0711d..20e6b393cdf 100644 --- a/Master/texmf-dist/doc/man/man1/deweb.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/deweb.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/disdvi.man1.pdf b/Master/texmf-dist/doc/man/man1/disdvi.man1.pdf Binary files differindex c03cc30f6fa..568de9e8823 100644 --- a/Master/texmf-dist/doc/man/man1/disdvi.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/disdvi.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dt2dv.man1.pdf b/Master/texmf-dist/doc/man/man1/dt2dv.man1.pdf Binary files differindex 8737c37bd50..20c03df65d7 100644 --- a/Master/texmf-dist/doc/man/man1/dt2dv.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dt2dv.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dv2dt.man1.pdf b/Master/texmf-dist/doc/man/man1/dv2dt.man1.pdf Binary files differindex eed4f7e285d..4c4eb014cdd 100644 --- a/Master/texmf-dist/doc/man/man1/dv2dt.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dv2dt.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvi2fax.man1.pdf b/Master/texmf-dist/doc/man/man1/dvi2fax.man1.pdf Binary files differindex 48d323e45e1..cd03ff8e366 100644 --- a/Master/texmf-dist/doc/man/man1/dvi2fax.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvi2fax.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvi2tty.man1.pdf b/Master/texmf-dist/doc/man/man1/dvi2tty.man1.pdf Binary files differindex a8eb47ecda2..0f1f83a8a6c 100644 --- a/Master/texmf-dist/doc/man/man1/dvi2tty.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvi2tty.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvibook.1 b/Master/texmf-dist/doc/man/man1/dvibook.1 index 01ee1d6b05e..715c9be766b 100644 --- a/Master/texmf-dist/doc/man/man1/dvibook.1 +++ b/Master/texmf-dist/doc/man/man1/dvibook.1 @@ -10,6 +10,8 @@ dvibook \- rearrange pages in DVI file into signatures ] [ .B \-s\fI<num> ] [ +.B \-r +] [ .B \-i .I infile ] [ @@ -35,6 +37,12 @@ should be a multiple of four. The default is to use one signature for the whole file. Extra blank sides will be added if the file does not contain a multiple of four pages. .PP +By default, dvibook rearranges the pages into left\-hand side binding +signatures; the +.I \-r +option switches to right\-hand side binding signatures. This might be useful +for pTeX vertical writing (tate\-kumi) documents. +.PP Dvibook normally prints the page numbers of the pages rearranged; the .I \-q option suppresses this. diff --git a/Master/texmf-dist/doc/man/man1/dvibook.man1.pdf b/Master/texmf-dist/doc/man/man1/dvibook.man1.pdf Binary files differindex 7a481977c5c..04f9ea76b2b 100644 --- a/Master/texmf-dist/doc/man/man1/dvibook.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvibook.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dviconcat.man1.pdf b/Master/texmf-dist/doc/man/man1/dviconcat.man1.pdf Binary files differindex fde8faefea9..1617e513615 100644 --- a/Master/texmf-dist/doc/man/man1/dviconcat.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dviconcat.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvicopy.1 b/Master/texmf-dist/doc/man/man1/dvicopy.1 index b4ccc68b919..66a27c0ee81 100644 --- a/Master/texmf-dist/doc/man/man1/dvicopy.1 +++ b/Master/texmf-dist/doc/man/man1/dvicopy.1 @@ -1,4 +1,4 @@ -.TH DVICOPY 1 TeX "24 January 1999" "Web2C 2017" +.TH DVICOPY 1 TeX "24 January 1999" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf b/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf Binary files differindex e080977ac52..0422f643b80 100644 --- a/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvicopy.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvidvi.man1.pdf b/Master/texmf-dist/doc/man/man1/dvidvi.man1.pdf Binary files differindex bf72b7fc792..cd1478c94f5 100644 --- a/Master/texmf-dist/doc/man/man1/dvidvi.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvidvi.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf b/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf Binary files differindex 5538b6099df..2eb1b2b31c2 100644 --- a/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvigif.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvihp.man1.pdf b/Master/texmf-dist/doc/man/man1/dvihp.man1.pdf Binary files differindex 513965ac5b9..04318b0ac13 100644 --- a/Master/texmf-dist/doc/man/man1/dvihp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvihp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvilj.man1.pdf b/Master/texmf-dist/doc/man/man1/dvilj.man1.pdf Binary files differindex dfc6e2322d1..656014e4896 100644 --- a/Master/texmf-dist/doc/man/man1/dvilj.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvilj.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvilj2p.man1.pdf b/Master/texmf-dist/doc/man/man1/dvilj2p.man1.pdf Binary files differindex 65e73428552..c4be3a79eb2 100644 --- a/Master/texmf-dist/doc/man/man1/dvilj2p.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvilj2p.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvilj4.man1.pdf b/Master/texmf-dist/doc/man/man1/dvilj4.man1.pdf Binary files differindex 2c9d3b62904..71a545ce5da 100644 --- a/Master/texmf-dist/doc/man/man1/dvilj4.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvilj4.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvilj4l.man1.pdf b/Master/texmf-dist/doc/man/man1/dvilj4l.man1.pdf Binary files differindex c765bc191d5..3711c1daaa4 100644 --- a/Master/texmf-dist/doc/man/man1/dvilj4l.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvilj4l.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvilj6.man1.pdf b/Master/texmf-dist/doc/man/man1/dvilj6.man1.pdf Binary files differindex 7173231d5c6..3d8800b8428 100644 --- a/Master/texmf-dist/doc/man/man1/dvilj6.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvilj6.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvipdfm.man1.pdf b/Master/texmf-dist/doc/man/man1/dvipdfm.man1.pdf Binary files differindex 141f916d499..a4bf38e93e1 100644 --- a/Master/texmf-dist/doc/man/man1/dvipdfm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvipdfm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvipdfmx.man1.pdf b/Master/texmf-dist/doc/man/man1/dvipdfmx.man1.pdf Binary files differindex ff1be920f82..3a6e0e02c62 100644 --- a/Master/texmf-dist/doc/man/man1/dvipdfmx.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvipdfmx.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvipdft.man1.pdf b/Master/texmf-dist/doc/man/man1/dvipdft.man1.pdf Binary files differindex a0aab842ee2..c773d4b8184 100644 --- a/Master/texmf-dist/doc/man/man1/dvipdft.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvipdft.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvipng.1 b/Master/texmf-dist/doc/man/man1/dvipng.1 index 1e6c1956607..895a17c001d 100644 --- a/Master/texmf-dist/doc/man/man1/dvipng.1 +++ b/Master/texmf-dist/doc/man/man1/dvipng.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32) +.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== @@ -129,7 +129,7 @@ .\" ======================================================================== .\" .IX Title "DVIPNG 1" -.TH DVIPNG 1 "2017-04-28" "dvipng (TeX Live) 1.15" "User commands" +.TH DVIPNG 1 "2018-03-27" "dvipng (TeX Live) 1.15" "User commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l diff --git a/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf b/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf Binary files differindex d63dc759d7a..f615bc50e90 100644 --- a/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvipng.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvipos.man1.pdf b/Master/texmf-dist/doc/man/man1/dvipos.man1.pdf Binary files differindex b0d08653ab3..8f590a41ba0 100644 --- a/Master/texmf-dist/doc/man/man1/dvipos.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvipos.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvips.man1.pdf b/Master/texmf-dist/doc/man/man1/dvips.man1.pdf Binary files differindex 122eec812c1..d28f53100b7 100644 --- a/Master/texmf-dist/doc/man/man1/dvips.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvips.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvired.man1.pdf b/Master/texmf-dist/doc/man/man1/dvired.man1.pdf Binary files differindex 46b5b3bc086..594b1889a58 100644 --- a/Master/texmf-dist/doc/man/man1/dvired.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvired.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dviselect.man1.pdf b/Master/texmf-dist/doc/man/man1/dviselect.man1.pdf Binary files differindex f2366c3b906..f07b4d825b4 100644 --- a/Master/texmf-dist/doc/man/man1/dviselect.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dviselect.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvitodvi.man1.pdf b/Master/texmf-dist/doc/man/man1/dvitodvi.man1.pdf Binary files differindex 7025ac3e13b..78cdaed18dd 100644 --- a/Master/texmf-dist/doc/man/man1/dvitodvi.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvitodvi.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvitomp.1 b/Master/texmf-dist/doc/man/man1/dvitomp.1 index e59f4fd6e50..e51a44f69e1 100644 --- a/Master/texmf-dist/doc/man/man1/dvitomp.1 +++ b/Master/texmf-dist/doc/man/man1/dvitomp.1 @@ -1,4 +1,4 @@ -.TH DVITOMP 1 "16 June 2015" "Web2C 2017" +.TH DVITOMP 1 "16 June 2015" "Web2C 2018" .\" man page by Jim Van Zandt <jrv@vanzandt.mv.com> .SH NAME dvitomp \- convert a TeX DVI file to a MetaPost MPXFILE diff --git a/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf b/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf Binary files differindex 8e785c0fc36..7401622beb7 100644 --- a/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvitomp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/dvitype.1 b/Master/texmf-dist/doc/man/man1/dvitype.1 index 27d203d99f2..7cc1ec61d21 100644 --- a/Master/texmf-dist/doc/man/man1/dvitype.1 +++ b/Master/texmf-dist/doc/man/man1/dvitype.1 @@ -1,4 +1,4 @@ -.TH DVITYPE 1 "16 June 2015" "Web2C 2017" +.TH DVITYPE 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf b/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf Binary files differindex e6562737535..ec3cedb95bf 100644 --- a/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/dvitype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/e2pall.man1.pdf b/Master/texmf-dist/doc/man/man1/e2pall.man1.pdf Binary files differindex cb2866e8d47..d7bae397ba5 100644 --- a/Master/texmf-dist/doc/man/man1/e2pall.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/e2pall.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ebb.man1.pdf b/Master/texmf-dist/doc/man/man1/ebb.man1.pdf Binary files differindex 10406758b9b..5959a4107b8 100644 --- a/Master/texmf-dist/doc/man/man1/ebb.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ebb.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/epsffit.man1.pdf b/Master/texmf-dist/doc/man/man1/epsffit.man1.pdf Binary files differindex cf0535fb8ea..45ccb1979b6 100644 --- a/Master/texmf-dist/doc/man/man1/epsffit.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/epsffit.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/extconv.man1.pdf b/Master/texmf-dist/doc/man/man1/extconv.man1.pdf Binary files differindex e2092c76882..09168bcf456 100644 --- a/Master/texmf-dist/doc/man/man1/extconv.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/extconv.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/extractbb.man1.pdf b/Master/texmf-dist/doc/man/man1/extractbb.man1.pdf Binary files differindex 47a6e4f9c3c..745ed2b34df 100644 --- a/Master/texmf-dist/doc/man/man1/extractbb.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/extractbb.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/extractres.man1.pdf b/Master/texmf-dist/doc/man/man1/extractres.man1.pdf Binary files differindex 1acdb7d3813..6e27c7e7c37 100644 --- a/Master/texmf-dist/doc/man/man1/extractres.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/extractres.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf Binary files differindex fb933c06a23..1c44a8ca8f7 100644 --- a/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/fmtutil-sys.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf Binary files differindex 66216c97a6d..5e4f9056c48 100644 --- a/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/fmtutil-user.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/fmtutil.1 b/Master/texmf-dist/doc/man/man1/fmtutil.1 index 0fe2a33f396..1b4357cdfa9 100644 --- a/Master/texmf-dist/doc/man/man1/fmtutil.1 +++ b/Master/texmf-dist/doc/man/man1/fmtutil.1 @@ -1,90 +1,65 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4. -.TH FMTUTIL "1" "May 2017" "TeX Live" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.46.5. +.TH FMTUTIL "1" "April 2015" "TeX Live" "User Commands" .SH NAME -fmtutil \- manage TeX formats and Metafont bases, per-user +fmtutil \- manage TeX formats, Metafont bases and Metapost mems, per-user .br -fmtutil-sys \- manage TeX formats and Metafont bases, system-wide +fmtutil-sys \- manage TeX formats, Metafont bases and Metapost mems, system-wide .br -mktexfmt \- create a TeX format or Metafont base +mktexfmt \- create a TeX format, Metafont base, or Metapost mem .SH SYNOPSIS .B fmtutil -[\fI\,-user|-sys\/\fR] [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] -.br -.B fmtutil-sys [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] .br -.B fmtutil-user +.B fmtutil-sys [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] .br .B mktexfmt -\fI\,FORMAT.fmt|BASE.base|FMTNAME.EXT\/\fR +\fI\,FORMAT.fmt|BASE.base|MEM.mem|FMTNAME.EXT\/\fR .SH DESCRIPTION -fmtutil version r43794 (2017\-04\-15 02:12:54 +0200) +fmtutil version svn36788 (2015\-04\-13 00:53:26 +0900) .PP -Rebuild and manage TeX fmts and Metafont bases, collectively called -"formats" here. (MetaPost no longer uses the past\-equivalent "mems".) +Rebuild and manage TeX formats, Metafont bases and MetaPost mems. .PP If the command name ends in mktexfmt, only one format can be created. The only options supported are \fB\-\-help\fR and \fB\-\-version\fR, and the command -line must be either a format name, with extension, or a plain name that -is passed as the argument to \fB\-\-byfmt\fR (see below). The full name of the -generated file (if any) is written to stdout, and nothing else. -.PP -If not operating in mktexfmt mode, exactly one command must be given, -extensions should generally not be specified, no non\-option arguments -are allowed, and multiple formats can be generated, as follows. +line must consist of either a format name, with its extension, or a +plain name that is passed as the argument to \fB\-\-byfmt\fR (see below). The +full name of the generated file (if any) is written to stdout, and +nothing else. .PP -By default, the return status is zero if all formats requested are -successfully built, else nonzero. +If not operating in mktexfmt mode, the command line can be more general, +and multiple formats can be generated, as follows. .SH OPTIONS .TP -\fB\-\-sys\fR -use TEXMFSYS{VAR,CONFIG} -.TP -\fB\-\-user\fR -use TEXMF{VAR,CONFIG} -.TP \fB\-\-cnffile\fR FILE read FILE instead of fmtutil.cnf (can be given multiple times, in which case all the files are used) -.TP -\fB\-\-fmtdir\fR DIR -write formats under DIR instead of TEXMF[SYS]VAR +.HP +\fB\-\-fmtdir\fR DIRECTORY .TP \fB\-\-no\-engine\-subdir\fR don't use engine\-specific subdir of the fmtdir -.HP -\fB\-\-no\-error\-if\-no\-format\fR exit successfully if no format is selected +.TP +\fB\-\-no\-error\-if\-no\-format\fR +exit successfully if no format is selected .TP \fB\-\-no\-error\-if\-no\-engine\fR=\fI\,ENGINE1\/\fR,ENGINE2,... -exit successfully even if a required engine +exit successfully even if the required engine .IP is missing, if it is included in the list. .TP -\fB\-\-no\-strict\fR -exit successfully even if a format fails to build -.TP -\fB\-\-nohash\fR -don't update ls\-R files -.TP -\fB\-\-recorder\fR -pass the \fB\-recorder\fR option and save .fls files -.TP \fB\-\-quiet\fR be silent .TP -\fB\-\-catcfg\fR -(does nothing, exists for compatibility) +\fB\-\-test\fR +(not implemented, just for compatibility) .TP \fB\-\-dolinks\fR -(does nothing, exists for compatibility) +(not implemented, just for compatibility) .TP \fB\-\-force\fR -(does nothing, exists for compatibility) -.TP -\fB\-\-test\fR -(does nothing, exists for compatibility) +(not implemented, just for compatibility) .SS "Commands:" .TP \fB\-\-all\fR @@ -96,29 +71,30 @@ create all missing format files \fB\-\-refresh\fR recreate only existing format files .TP -\fB\-\-byengine\fR ENGINE -(re)create formats built with ENGINE +\fB\-\-byengine\fR ENGINENAME +(re)create formats using ENGINENAME .TP -\fB\-\-byfmt\fR FORMAT -(re)create format FORMAT +\fB\-\-byfmt\fR FORMATNAME +(re)create format for FORMATNAME .TP \fB\-\-byhyphen\fR HYPHENFILE (re)create formats that depend on HYPHENFILE .TP -\fB\-\-enablefmt\fR -FORMAT[/ENGINE] enable FORMAT, as built with ENGINE +\fB\-\-enablefmt\fR FORMATNAME +enable formatname in config file .TP -\fB\-\-disablefmt\fR FORMAT[/ENGINE] disable FORMAT, as built with ENGINE -If multiple formats have the same name and -.IP -different engines, \fI\,/ENGINE\/\fP specifier is required. +\fB\-\-disablefmt\fR FORMATNAME +disable formatname in config file .TP \fB\-\-listcfg\fR list (enabled and disabled) configurations, filtered to available formats .TP -\fB\-\-showhyphen\fR FORMAT -print name of hyphen file for FORMAT +\fB\-\-catcfg\fR +output the content of the config file +.TP +\fB\-\-showhyphen\fR FORMATNAME +print name of hyphenfile for format FORMATNAME .TP \fB\-\-version\fR show version information and exit @@ -148,7 +124,7 @@ TEXMFSYSVAR \fI\,$TEXLIVE/YYYY/texmf\-var/web2c/fmtutil.cnf\/\fP TEXMFLOCAL \fI\,$TEXLIVE/texmf\-local/web2c/fmtutil.cnf\/\fP TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/fmtutil.cnf\/\fP .IP -For fmtutil\-user: +For fmtutil: TEXMFCONFIG $HOME/.texliveYYYY/texmf\-config/web2c/fmtutil.cnf TEXMFVAR $HOME/.texliveYYYY/texmf\-var/web2c/fmtutil.cnf TEXMFHOME \fI\,$HOME/texmf/web2c/fmtutil.cnf\/\fP @@ -163,19 +139,7 @@ TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/fmtutil.cnf\/\fP According to the actions, fmtutil might write to one of the given files or create a new fmtutil.cnf, described further below. .PP -Where formats are written: -.IP -By default, format files are (re)written in TEXMFSYSVAR/ENGINE by -fmtutil\-sys, and TEXMFVAR/ENGINE by fmtutil, where \fI\,/ENGINE\/\fP is a -subdirectory named for the engine used, such as "pdftex". -.IP -If the \fB\-\-fmtdir\fR=\fI\,DIR\/\fR option is specified, DIR is used instead of -TEXMF[SYS]VAR, but the \fI\,/ENGINE\/\fP subdir is still used by default. -.IP -In any case, if the \fB\-\-no\-engine\-subdir\fR option is specified, the -\fI\,/ENGINE\/\fP subdir is omitted. -.PP -Where configuration changes are saved: +Where changes are saved: .IP If config files are given on the command line, then the first one given will be used to save any changes from \fB\-\-enable\fR or \fB\-\-disable\fR. @@ -192,8 +156,8 @@ new config file is created in \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP. .IP In general, the idea is that if a given config file is not writable, a higher\-level one can be used. That way, the distribution's settings -can be overridden system\-wide using TEXMFLOCAL, and system settings -can be overridden again in a particular user's TEXMFHOME. +can be overridden for system\-wide using TEXMFLOCAL, and then system +settings can be overridden again for a particular using using TEXMFHOME. .PP Resolving multiple definitions of a format: .IP @@ -203,45 +167,30 @@ coming from the first\-listed fmtutil.cnf is used. Disabling formats: .IP fmtutil.cnf files with higher priority (listed earlier) can disable -formats in lower priority (listed later) fmtutil.cnf files by -writing a line like +formats mentioned in lower priority (listed later) fmtutil.cnf files by +writing, e.g., .IP #! <fmtname> <enginename> <hyphen> <args> -.TP -in the higher\-priority fmtutil.cnf file. -The #! must be at the .IP -beginning of the line, with at least one space or tab afterward, and -there must be whitespace between each word on the list. +in the higher\-priority fmtutil.cnf file. .IP -For example, you can disable the luajitlatex format by creating -the file \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP with the line +As an example, suppose you have want to disable the luajitlatex format. +You can create the file \fI\,$TEXMFCONFIG/web2c/fmtutil.cnf\/\fP with the content .IP #! luajitlatex luajittex language.dat,language.dat.lua lualatex.ini .IP -(As it happens, the luajittex\-related formats are precisely why the -\fB\-\-no\-error\-if\-no\-engine\fR option exists, since luajittex cannot be -compiled on all platforms.) +and call fmtutil. .PP -fmtutil\-user (fmtutil \fB\-user\fR) vs. fmtutil\-sys (fmtutil \fB\-sys\fR): +fmtutil vs. fmtutil\-sys (fmtutil \fB\-\-sys\fR): .IP -When fmtutil\-sys is run or the command line option \fB\-sys\fR is used, +When fmtutil\-sys is run or the command line option \fB\-\-sys\fR is used, TEXMFSYSCONFIG and TEXMFSYSVAR are used instead of TEXMFCONFIG and TEXMFVAR, respectively. This is the primary difference between -fmtutil\-sys and fmtutil\-user. -.IP -See http://tug.org/texlive/scripts\-sys\-user.html for details. +fmtutil\-sys and fmtutil. .IP Other locations may be used if you give them on the command line, or these trees don't exist, or you are not using the original TeX Live. -.PP -Supporting development binaries -.IP -If an engine name ends with "\-dev", formats are created in -the respective directory with the \fB\-dev\fR stripped. This allows for -easily running development binaries in parallel with the released -binaries. .SH "REPORTING BUGS" -Report bugs to: tex\-live@tug.org +Report bugs to: tex\-k@tug.org .br TeX Live home page: <http://tug.org/texlive/> diff --git a/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf b/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf Binary files differindex 8ff1f27bde8..fa66f987fcd 100644 --- a/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/fmtutil.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/fontinst.man1.pdf b/Master/texmf-dist/doc/man/man1/fontinst.man1.pdf Binary files differindex 7434ce5fbad..b3f944c4f91 100644 --- a/Master/texmf-dist/doc/man/man1/fontinst.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/fontinst.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/gftodvi.1 b/Master/texmf-dist/doc/man/man1/gftodvi.1 index 195b0f4205f..77f94dac3a4 100644 --- a/Master/texmf-dist/doc/man/man1/gftodvi.1 +++ b/Master/texmf-dist/doc/man/man1/gftodvi.1 @@ -1,4 +1,4 @@ -.TH GFTODVI 1 "16 June 2015" "Web2C 2017" +.TH GFTODVI 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf b/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf Binary files differindex dcce780b9f1..4476078f5ba 100644 --- a/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/gftodvi.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/gftopk.1 b/Master/texmf-dist/doc/man/man1/gftopk.1 index c706fa73538..acd7e72717a 100644 --- a/Master/texmf-dist/doc/man/man1/gftopk.1 +++ b/Master/texmf-dist/doc/man/man1/gftopk.1 @@ -1,4 +1,4 @@ -.TH GFTOPK 1 "16 June 2015" "Web2C 2017" +.TH GFTOPK 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf b/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf Binary files differindex 97bfef77005..f26f3506353 100644 --- a/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/gftopk.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/gftype.1 b/Master/texmf-dist/doc/man/man1/gftype.1 index 9dc4708041d..671e91906c5 100644 --- a/Master/texmf-dist/doc/man/man1/gftype.1 +++ b/Master/texmf-dist/doc/man/man1/gftype.1 @@ -1,4 +1,4 @@ -.TH GFTYPE 1 "16 June 2015" "Web2C 2017" +.TH GFTYPE 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/gftype.man1.pdf b/Master/texmf-dist/doc/man/man1/gftype.man1.pdf Binary files differindex 50b648cccc6..dd4b1df44be 100644 --- a/Master/texmf-dist/doc/man/man1/gftype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/gftype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/gsftopk.man1.pdf b/Master/texmf-dist/doc/man/man1/gsftopk.man1.pdf Binary files differindex cd1c58d31cb..9d9babe277f 100644 --- a/Master/texmf-dist/doc/man/man1/gsftopk.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/gsftopk.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/hbf2gf.man1.pdf b/Master/texmf-dist/doc/man/man1/hbf2gf.man1.pdf Binary files differindex b551fcfa22e..f5dc9f083d1 100644 --- a/Master/texmf-dist/doc/man/man1/hbf2gf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/hbf2gf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/includeres.man1.pdf b/Master/texmf-dist/doc/man/man1/includeres.man1.pdf Binary files differindex 8f4f9dc2d49..1024607a7ba 100644 --- a/Master/texmf-dist/doc/man/man1/includeres.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/includeres.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/inimf.man1.pdf b/Master/texmf-dist/doc/man/man1/inimf.man1.pdf Binary files differindex 41eeec6aac7..9175afe1caa 100644 --- a/Master/texmf-dist/doc/man/man1/inimf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/inimf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/initex.man1.pdf b/Master/texmf-dist/doc/man/man1/initex.man1.pdf Binary files differindex 56ee50a3b8e..816f81c8646 100644 --- a/Master/texmf-dist/doc/man/man1/initex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/initex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpseaccess.1 b/Master/texmf-dist/doc/man/man1/kpseaccess.1 index 373839855f9..63eed2c7cbc 100644 --- a/Master/texmf-dist/doc/man/man1/kpseaccess.1 +++ b/Master/texmf-dist/doc/man/man1/kpseaccess.1 @@ -1,4 +1,4 @@ -.TH KPSEACCESS 1 "1 March 2011" "Kpathsea 6.2.3" +.TH KPSEACCESS 1 "1 March 2011" "Kpathsea 6.3.0" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf b/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf Binary files differindex 7ef0eb1e9b4..b22bbd2ae14 100644 --- a/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpseaccess.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsepath.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsepath.man1.pdf Binary files differindex 30aa8dd043b..2fe31fd74d8 100644 --- a/Master/texmf-dist/doc/man/man1/kpsepath.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsepath.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsereadlink.1 b/Master/texmf-dist/doc/man/man1/kpsereadlink.1 index fa75e089975..6b24afc61f1 100644 --- a/Master/texmf-dist/doc/man/man1/kpsereadlink.1 +++ b/Master/texmf-dist/doc/man/man1/kpsereadlink.1 @@ -1,4 +1,4 @@ -.TH KPSEREADLINK 1 "1 March 2011" "Kpathsea 6.2.3" +.TH KPSEREADLINK 1 "1 March 2011" "Kpathsea 6.3.0" .\"===================================================================== .SH NAME kpsereadlink \- print contents of symbolic link diff --git a/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf Binary files differindex eac6997a158..8a2a9b4be36 100644 --- a/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsereadlink.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsestat.1 b/Master/texmf-dist/doc/man/man1/kpsestat.1 index 69a1a11b92f..9eaec421044 100644 --- a/Master/texmf-dist/doc/man/man1/kpsestat.1 +++ b/Master/texmf-dist/doc/man/man1/kpsestat.1 @@ -1,4 +1,4 @@ -.TH KPSESTAT 1 "1 March 2011" "Kpathsea 6.2.3" +.TH KPSESTAT 1 "1 March 2011" "Kpathsea 6.3.0" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf Binary files differindex 6c1a7f4bd85..f1aeb901828 100644 --- a/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsestat.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsetool.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsetool.man1.pdf Binary files differindex 28f7505a3b6..dba2488d029 100644 --- a/Master/texmf-dist/doc/man/man1/kpsetool.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsetool.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsewhere.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsewhere.man1.pdf Binary files differindex 4d43837992c..91cddcd381c 100644 --- a/Master/texmf-dist/doc/man/man1/kpsewhere.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsewhere.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsewhich.1 b/Master/texmf-dist/doc/man/man1/kpsewhich.1 index b26108650e5..76acf6c38d8 100644 --- a/Master/texmf-dist/doc/man/man1/kpsewhich.1 +++ b/Master/texmf-dist/doc/man/man1/kpsewhich.1 @@ -1,4 +1,4 @@ -.TH KPSEWHICH 1 "1 March 2011" "Kpathsea 6.2.3" +.TH KPSEWHICH 1 "1 March 2011" "Kpathsea 6.3.0" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf Binary files differindex 1111d1bc528..acda51e35c5 100644 --- a/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsewhich.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/kpsexpand.man1.pdf b/Master/texmf-dist/doc/man/man1/kpsexpand.man1.pdf Binary files differindex b23ba33436e..2e895c6ebbd 100644 --- a/Master/texmf-dist/doc/man/man1/kpsexpand.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/kpsexpand.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/lacheck.man1.pdf b/Master/texmf-dist/doc/man/man1/lacheck.man1.pdf Binary files differindex 1bf4d14680a..21ad43930b2 100644 --- a/Master/texmf-dist/doc/man/man1/lacheck.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/lacheck.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/lamed.man1.pdf b/Master/texmf-dist/doc/man/man1/lamed.man1.pdf Binary files differindex 8f118306666..4b57e31bdfe 100644 --- a/Master/texmf-dist/doc/man/man1/lamed.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/lamed.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/latex.1 b/Master/texmf-dist/doc/man/man1/latex.1 index 4a84c4d781a..00bbab35390 100644 --- a/Master/texmf-dist/doc/man/man1/latex.1 +++ b/Master/texmf-dist/doc/man/man1/latex.1 @@ -1,4 +1,4 @@ -.TH LATEX 1 "16 June 2015" "Web2C 2017" +.TH LATEX 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/latex.man1.pdf b/Master/texmf-dist/doc/man/man1/latex.man1.pdf Binary files differindex 55e17915ff4..65df7643426 100644 --- a/Master/texmf-dist/doc/man/man1/latex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/latex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/luatex.1 b/Master/texmf-dist/doc/man/man1/luatex.1 index 40f6f647916..c0ebddf1881 100644 --- a/Master/texmf-dist/doc/man/man1/luatex.1 +++ b/Master/texmf-dist/doc/man/man1/luatex.1 @@ -1,4 +1,4 @@ -.TH LUATEX 1 "16 June 2015" "Web2C 2017" +.TH LUATEX 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/luatex.man1.pdf b/Master/texmf-dist/doc/man/man1/luatex.man1.pdf Binary files differindex 93f79c0a126..6ba22a77e8a 100644 --- a/Master/texmf-dist/doc/man/man1/luatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/luatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mag.man1.pdf b/Master/texmf-dist/doc/man/man1/mag.man1.pdf Binary files differindex 3095323435e..f585641baeb 100644 --- a/Master/texmf-dist/doc/man/man1/mag.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mag.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/makeindex.man1.pdf b/Master/texmf-dist/doc/man/man1/makeindex.man1.pdf Binary files differindex 8588c4ea22b..402b6676da8 100644 --- a/Master/texmf-dist/doc/man/man1/makeindex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/makeindex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/makejvf.1 b/Master/texmf-dist/doc/man/man1/makejvf.1 index bed1a5cdaea..b50785f8cc0 100644 --- a/Master/texmf-dist/doc/man/man1/makejvf.1 +++ b/Master/texmf-dist/doc/man/man1/makejvf.1 @@ -1,13 +1,117 @@ .if t .ds TX T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X .if t .ds LX L\\h'-0.36m'\\v'-0.15v'\\s-2A\\s+2\\h'-0.15m'\\v'0.15v'T\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X -.TH MAKEJVF L +.TH MAKEJVF 1 .SH NAME makejvf \- Make Japanese VF file from Japanese \*(TX TFM file .SH SYNOPSIS -\fBmakejvf\fR [\fI<options>\fR] \fI<\*(TX TFM file>\fR \fI<TFM name of PS font>\fR +\fBmakejvf\fR [<\fIoptions\fR>] <\fI\*(TX TFM file\fR> <\fIPS font TFM\fR> .SH DESCRIPTION -\fBmakejvf\fP is a tool to generate Japanese VF file from Japanese \*(TX TFM +\fBmakejvf\fR is a tool to generate Japanese VF file from Japanese \*(TX TFM (JFM) file for use with dvips. +.TP 5 +When processing Japanese texts, p\*(TX refers to JFM (min10.tfm, jis.tfm \ +etc.), which includes definitions of some different character widths and \ +metric glue/kerns. For most punctuations and quotation marks, the \ +character widths are truncated to less than 1 zw (zenkaku-width; the \ +width of ordinary Kanji characters), and metric glue/kerns are inserted \ +as a substitute. +.TP 5 +On the other hand, in Japanese PS fonts, all punctuations and quotation \ +marks have the same character widths as ordinary Kanji characters. \ +For this reason, when dvips processes the resulting DVI, these characters \ +have to be shifted to the left by the amount of glue/kerns inserted. +.TP 5 +To achieve this, Virtual fonts (VF) and PS TFM files are required; \ +When VF contains the commands of shifting characters, PS font TFM can \ +have the exact character widths of PS fonts. +.TP 5 +The program \fBmakejvf\fR can be used for this purpose. \ +It inputs a p\*(TX JFM file (refered to as <\fI\*(TX TFM file\fR> in \ +\fBSYNOPSIS\fR above), and outputs a corresponding VF file \ +(with the same basename as <\fI\*(TX TFM file\fR>) and \ +a JFM file for a PS font JFM file (<\fIPS font TFM\fR> above). +.SH OPTIONS +.PP +.TP 10 +\fB-C\fR +Condensed ("Cho-tai") mode. +.TP 10 +\fB-K\fR <\fIPS-TFM\fR> +Map Kana (more exactly, non-Kanji) characters to another PS font JFM +named <\fIPS-TFM\fR>. +.TP 10 +\fB-b\fR <\fIinteger\fR> +Base line shift amount; the \fIinteger\fR represents a relative value, +using the character height as a base of 1000. +When a positive integer is specified, the characters are lowered. +When a negative integer is specified, the characters are raised. +.TP 10 +\fB-m\fR +Replace single/double quotation marks (', '') with single/double prime +quotation marks (so-called "minute") in vertical writing. +The replacement is realized by manipulating glyphs of prime and +double prime (JIS 0x216C and 0x216D; Unicode U+2032 and U+2033), +\fInot\fR by putting actual glyphs designed for quotation marks +(Unicode U+301D and U+301E/U+301F). +.TP 10 +\fB-a\fR <\fIAFMfile\fR> +Name of the input AFM file used for Kana-tsume mode. +This option is unsupported. +.TP 10 +\fB-k\fR <\fIinteger\fR> +Kana-tsume (narrower spaces between Kana characters) margin amount; +the \fIinteger\fR represents a relative value, using the character width +as a base of 1000. This option should be accompanied with \fB-a\fR option. +This option is unsupported. +.TP 10 +\fB-i\fR +Start mapped font ID from No. 0 in output VF +(by default, makejvf defaults to No. 1). +.TP 10 +\fB-e\fR +Enhanced mode; the horizontal shift amount is determined from the +glue/kern table of input JFM file. +.TP 10 +By default, \fBmakejvf\fR uses the hard-coded value as the horizontal \ +shift amount, which is (mostly) optimized for Japanese fonts. \ +When enhanced mode (option \fB-e\fR) is enabled, the shift amount is \ +determined from the input p\*(TX TFM (JFM) file, which is likely to \ +output most suitable VF for the JFM. +.TP 10 +For most standard Japanese JFM (like jis.tfm and its derivatives), \ +the output VFs from both modes will have no significant difference. \ +For simplified/traditional Chinese JFM (like upschrm-h.tfm and \ +uptchrm-h.tfm), the output VF from enhanced mode will be better. \ +For min10.tfm and its derivatives, enhanced mode should \fInever\fR be \ +enabled, since the characterization in min10.tfm is non-standard. +.TP 10 +\fB-t\fR <\fICNFfile\fR> +Use <\fICNFfile\fR> as a configuration file. +.TP 10 +\fB-u\fR <\fICharset\fR> +UCS mode. Available charsets are: gb (GB = Simplified Chinese), +cns (CNS = Traditional Chinese), ks (KS = Korean), +jis (JIS = Japanese), jisq (JIS quote only), +custom (user-defined CHARSET from <CNFfile>; +see \fBCONFIGURATION FILE FORMAT\fR section). +.TP 10 +Options below are effective only in UCS mode: +.TP 10 +\fB-J\fR <\fIPS-TFM\fR> +Map single/double quote to another JIS-encoded PSfont TFM. +.TP 10 +\fB-U\fR <\fIPS-TFM\fR> +Map single/double quote to another UCS-encoded PSfont TFM +.TP 10 +\fB-3\fR +Use set3, that is, enable non-BMP characters support (with UCS mode). +By default \fBmakejvf\fR does not output >=U+10000, to reduce file +size and to avoid problems with old DVI drivers. Recent versions of +dvipdfmx and others can handle VF with >=U+10000 (= set3 in DVI +language), therefore \fB-3\fR might be helpful. +.TP 10 +\fB-H\fR +Use half-width Katakana. .SH EXAMPLE .TP 5 If you want to use min10 as Ryumin-Light-H, run @@ -16,6 +120,32 @@ If you want to use min10 as Ryumin-Light-H, run This generates min10.vf and rml.tfm. Put these files in an appropriate \ directory under TEXMF tree, and add the following line to psfonts.map. rml Ryumin-Light-H +.SH CONFIGURATION FILE FORMAT +.TP 5 +With \fB-t\fR option, you can give \fBmakejvf\fR a custom settings \ +for generating VF. The syntax is: + + % comment line + MOVE <code> <right> <down> + + REPLACE <code> <new code> + CHARSET <code>,<code>,<code>..<code>,<code>, + + <code>,<code>..<code> + +.TP 5 +Each line should begin with a command, and should be TAB-separated. \ +Line starting with % is a comment, and empty lines are ignored. +.TP 5 +The \fBMOVE\fR command specifies horizontal/vertical shift amount \ +for the individual character <\fIcode\fR>. \ +The \fBREPLACE\fR command replaces the character <\fIcode\fR> with \ +<\fInew code\fR>. \ +The \fBCHARSET\fR command sets the custom character set of output VF; \ +the + character continues from the previous line. +.TP 5 +An example usage can be found in uptex-fonts project. \ +See GitHub repository + <https://github.com/texjporg/uptex-fonts>. .SH SEE ALSO More detailed description of \fBmakejvf\fR in Japanese is available at $TEXMFDIST/doc/fonts/ptex-fonts/README_makejvf @@ -23,5 +153,6 @@ More detailed description of \fBmakejvf\fR in Japanese is available at This manual page was written by Japanese \*(TX Development Community \ <https://texjp.org>. For more information, see GitHub repository \ <https://github.com/texjporg/ptex-fonts>. +.TP 5 Many thanks to Atsuhito KOHDA <kohda@debian.org>, \ for providing another manpage in Debian GNU/Linux system. diff --git a/Master/texmf-dist/doc/man/man1/makejvf.man1.pdf b/Master/texmf-dist/doc/man/man1/makejvf.man1.pdf Binary files differindex 2f2a4902c9f..baf203af568 100644 --- a/Master/texmf-dist/doc/man/man1/makejvf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/makejvf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf b/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf Binary files differindex ae7e5abe974..62ddfab3e61 100644 --- a/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mf-nowin.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mf.1 b/Master/texmf-dist/doc/man/man1/mf.1 index 3f21b02b4f7..149a57f308b 100644 --- a/Master/texmf-dist/doc/man/man1/mf.1 +++ b/Master/texmf-dist/doc/man/man1/mf.1 @@ -1,4 +1,4 @@ -.TH MF 1 "16 June 2015" "Web2C 2017" +.TH MF 1 "17 January 2018" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont @@ -54,7 +54,7 @@ file. When called as it will use the .I plain base. When called under any other name, \*(MF will use that name as -the name of the base to use. For example, when called as +the name of the base to use. For example, when called as .B mf the .I mf @@ -90,7 +90,7 @@ keep \*(MF from thinking that you want to produce a font called .IR mode . (Or you can just say .I mf -and give the other stuff on the next line, without quotes.) Other +and give the other stuff on the next line, without quotes.) Other control sequences, such as .I batchmode (for silent operation) can also appear. @@ -115,7 +115,7 @@ example is shown generically as <printengine>, a symbolic term for which the name of an actual device or, most commonly, the name .I localfont (see below) must -be substituted. If the mode is not specified or is not valid for your +be substituted. If the mode is not specified or is not valid for your site, \*(MF will default to .I proof mode which produces @@ -367,15 +367,13 @@ files in it, if they cannot be put in the current directory. Again, see .B MFINPUTS Search path for .I input -and -.I openin files. .TP .B MFEDIT Command template for switching to editor. .TP .B MFTERM -Determines the online graphics display. If MFTERM is not set, +Determines the online graphics display. If MFTERM is not set, and DISPLAY is set, the Metafont window support for X is used. (DISPLAY must be set to a valid X server specification, as usual.) If neither MFTERM nor DISPLAY is set, TERM is used to guess the window @@ -434,7 +432,7 @@ documentation for this version of \*(MF can be found in the info manual .\"===================================================================== .SH BUGS On January 4, 1986 the ``final'' bug in \*(MF was discovered -and removed. If an error still lurks in the code, Donald E. Knuth promises to +and removed. If an error still lurks in the code, Donald E. Knuth promises to pay a finder's fee which doubles every year to the first person who finds it. Happy hunting. .\"===================================================================== @@ -472,6 +470,7 @@ you see everywhere, especially those of your own design.'' .BR gftodvi (1), .BR gftype (1), .BR mft (1), +.BR mpost (1), .BR pltotf (1), .BR tftopl (1). .\"===================================================================== diff --git a/Master/texmf-dist/doc/man/man1/mf.man1.pdf b/Master/texmf-dist/doc/man/man1/mf.man1.pdf Binary files differindex 61563433a5a..5c680e0271d 100644 --- a/Master/texmf-dist/doc/man/man1/mf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mft.1 b/Master/texmf-dist/doc/man/man1/mft.1 index 35f1d0f561e..7707bf55712 100644 --- a/Master/texmf-dist/doc/man/man1/mft.1 +++ b/Master/texmf-dist/doc/man/man1/mft.1 @@ -1,4 +1,4 @@ -.TH MFT 1 "16 June 2015" "Web2C 2017" +.TH MFT 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/mft.man1.pdf b/Master/texmf-dist/doc/man/man1/mft.man1.pdf Binary files differindex f1e0832ca7a..80e99cc8ee3 100644 --- a/Master/texmf-dist/doc/man/man1/mft.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mft.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mkindex.man1.pdf b/Master/texmf-dist/doc/man/man1/mkindex.man1.pdf Binary files differindex 5d4b5929773..728030035c8 100644 --- a/Master/texmf-dist/doc/man/man1/mkindex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mkindex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mkocp.man1.pdf b/Master/texmf-dist/doc/man/man1/mkocp.man1.pdf Binary files differindex 036b82778c7..0522ed8bd3e 100644 --- a/Master/texmf-dist/doc/man/man1/mkocp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mkocp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mkofm.man1.pdf b/Master/texmf-dist/doc/man/man1/mkofm.man1.pdf Binary files differindex f2e50e4b8cb..6e7dc519f02 100644 --- a/Master/texmf-dist/doc/man/man1/mkofm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mkofm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf b/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf Binary files differindex 527cb873c83..9289a40276e 100644 --- a/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mktexfmt.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mktexlsr.1 b/Master/texmf-dist/doc/man/man1/mktexlsr.1 index 48ef840371d..6680db3259d 100644 --- a/Master/texmf-dist/doc/man/man1/mktexlsr.1 +++ b/Master/texmf-dist/doc/man/man1/mktexlsr.1 @@ -1,4 +1,4 @@ -.TH MKTEXLSR 1 "1 March 2011" "Kpathsea 6.2.3" +.TH MKTEXLSR 1 "1 March 2011" "Kpathsea 6.3.0" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/mktexlsr.man1.pdf b/Master/texmf-dist/doc/man/man1/mktexlsr.man1.pdf Binary files differindex af2d9e6afd0..e92729cd728 100644 --- a/Master/texmf-dist/doc/man/man1/mktexlsr.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mktexlsr.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mktexmf.1 b/Master/texmf-dist/doc/man/man1/mktexmf.1 index f293dd89d34..309486db119 100644 --- a/Master/texmf-dist/doc/man/man1/mktexmf.1 +++ b/Master/texmf-dist/doc/man/man1/mktexmf.1 @@ -1,4 +1,4 @@ -.TH MKTEXMF 1 "1 March 2011" "Kpathsea 6.2.3" +.TH MKTEXMF 1 "1 March 2011" "Kpathsea 6.3.0" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/mktexmf.man1.pdf b/Master/texmf-dist/doc/man/man1/mktexmf.man1.pdf Binary files differindex 959ea6ebd81..417b187e796 100644 --- a/Master/texmf-dist/doc/man/man1/mktexmf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mktexmf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mktexpk.1 b/Master/texmf-dist/doc/man/man1/mktexpk.1 index edb75f40f2a..08c1af2534d 100644 --- a/Master/texmf-dist/doc/man/man1/mktexpk.1 +++ b/Master/texmf-dist/doc/man/man1/mktexpk.1 @@ -1,4 +1,4 @@ -.TH MKTEXPK 1 "1 March 2011" "Kpathsea 6.2.3" +.TH MKTEXPK 1 "1 March 2011" "Kpathsea 6.3.0" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/mktexpk.man1.pdf b/Master/texmf-dist/doc/man/man1/mktexpk.man1.pdf Binary files differindex 7e7f50586e0..a9eb55fb0f1 100644 --- a/Master/texmf-dist/doc/man/man1/mktexpk.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mktexpk.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mktextfm.1 b/Master/texmf-dist/doc/man/man1/mktextfm.1 index 6c7dc38ef36..904f6f24c0a 100644 --- a/Master/texmf-dist/doc/man/man1/mktextfm.1 +++ b/Master/texmf-dist/doc/man/man1/mktextfm.1 @@ -1,4 +1,4 @@ -.TH MKTEXTFM 1 "1 March 2011" "Kpathsea 6.2.3" +.TH MKTEXTFM 1 "1 March 2011" "Kpathsea 6.3.0" .\"===================================================================== .if n .ds MP MetaPost .if t .ds MP MetaPost diff --git a/Master/texmf-dist/doc/man/man1/mktextfm.man1.pdf b/Master/texmf-dist/doc/man/man1/mktextfm.man1.pdf Binary files differindex 391c7393420..51be6b2bd0a 100644 --- a/Master/texmf-dist/doc/man/man1/mktextfm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mktextfm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mmafm.1 b/Master/texmf-dist/doc/man/man1/mmafm.1 index 3e05a70a1ed..c03f70aec73 100644 --- a/Master/texmf-dist/doc/man/man1/mmafm.1 +++ b/Master/texmf-dist/doc/man/man1/mmafm.1 @@ -1,5 +1,5 @@ .\" -*-nroff-*- -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/mmafm.man1.pdf b/Master/texmf-dist/doc/man/man1/mmafm.man1.pdf Binary files differindex 460d680bd3a..ee8cfc8508c 100644 --- a/Master/texmf-dist/doc/man/man1/mmafm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mmafm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mmpfb.1 b/Master/texmf-dist/doc/man/man1/mmpfb.1 index 5a6b01df4d5..8c4cf1cd9f9 100644 --- a/Master/texmf-dist/doc/man/man1/mmpfb.1 +++ b/Master/texmf-dist/doc/man/man1/mmpfb.1 @@ -1,5 +1,5 @@ .\" -*-nroff-*- -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/mmpfb.man1.pdf b/Master/texmf-dist/doc/man/man1/mmpfb.man1.pdf Binary files differindex a748e4246c4..f765f9cf75f 100644 --- a/Master/texmf-dist/doc/man/man1/mmpfb.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mmpfb.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/mpost.1 b/Master/texmf-dist/doc/man/man1/mpost.1 index dcde6b74011..7f064a0df86 100644 --- a/Master/texmf-dist/doc/man/man1/mpost.1 +++ b/Master/texmf-dist/doc/man/man1/mpost.1 @@ -1,4 +1,4 @@ -.TH MPOST 1 "16 June 2015" "Web2C 2017" +.TH MPOST 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .de URL \\$2 \(laURL: \\$1 \(ra\\$3 diff --git a/Master/texmf-dist/doc/man/man1/mpost.man1.pdf b/Master/texmf-dist/doc/man/man1/mpost.man1.pdf Binary files differindex 9e9058751d9..2c0e02d3470 100644 --- a/Master/texmf-dist/doc/man/man1/mpost.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/mpost.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf b/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf Binary files differindex 5b5ec316247..f95e7c4d4c7 100644 --- a/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/odvicopy.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf b/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf Binary files differindex 05247389f24..f5c7a715bbe 100644 --- a/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/odvitype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ofm2opl.1 b/Master/texmf-dist/doc/man/man1/ofm2opl.1 index e7b51e79ea8..ae8000fd3d9 100644 --- a/Master/texmf-dist/doc/man/man1/ofm2opl.1 +++ b/Master/texmf-dist/doc/man/man1/ofm2opl.1 @@ -1,4 +1,4 @@ -.TH OFM2OPL 1 "14 April 2016" "Web2C 2017" +.TH OFM2OPL 1 "14 April 2016" "Web2C 2018" .PP .SH "NAME" ofm2opl \- convert Omega and TeX font-metric files to property-list files diff --git a/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf b/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf Binary files differindex b0c62105d77..2e36be658da 100644 --- a/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ofm2opl.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/opl2ofm.1 b/Master/texmf-dist/doc/man/man1/opl2ofm.1 index b502642852b..04a22793a81 100644 --- a/Master/texmf-dist/doc/man/man1/opl2ofm.1 +++ b/Master/texmf-dist/doc/man/man1/opl2ofm.1 @@ -1,4 +1,4 @@ -.TH OPL2OFM 1 "16 June 2015" "Web2C 2017" +.TH OPL2OFM 1 "16 June 2015" "Web2C 2018" .PP .SH "NAME" opl2ofm \- convert Omega and TeX property-list files to font-metric files diff --git a/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf b/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf Binary files differindex d04d6da24ef..3a37181a74a 100644 --- a/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/opl2ofm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/otangle.man1.pdf b/Master/texmf-dist/doc/man/man1/otangle.man1.pdf Binary files differindex 4f0d83514f3..ab79bb6b8a2 100644 --- a/Master/texmf-dist/doc/man/man1/otangle.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/otangle.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/otfinfo.1 b/Master/texmf-dist/doc/man/man1/otfinfo.1 index 6d6eda433af..2586832528a 100644 --- a/Master/texmf-dist/doc/man/man1/otfinfo.1 +++ b/Master/texmf-dist/doc/man/man1/otfinfo.1 @@ -1,5 +1,5 @@ '\"t -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/otfinfo.man1.pdf b/Master/texmf-dist/doc/man/man1/otfinfo.man1.pdf Binary files differindex 5b8ae69724a..78b4daedce5 100644 --- a/Master/texmf-dist/doc/man/man1/otfinfo.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/otfinfo.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/otftotfm.1 b/Master/texmf-dist/doc/man/man1/otftotfm.1 index f3ebfc1dd96..2f6860c25c3 100644 --- a/Master/texmf-dist/doc/man/man1/otftotfm.1 +++ b/Master/texmf-dist/doc/man/man1/otftotfm.1 @@ -1,5 +1,5 @@ '\"t -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. @@ -868,15 +868,19 @@ Do not generate a font map line for the font. .BI \-\-truetype\-directory= dir .TP 5 .BI \-\-type42\-directory= dir +.TP 5 +.BI \-\-directory= dir Set the directory used for various output types. Each directory may be set by an environment variable, and defaults to a TDS directory in automatic mode, or to "." otherwise. Environment variable names and default TDS -locations are described in the Automatic Mode section above. +locations are described in the Automatic Mode section above. The +.B \-\-directory +option sets the default directory for all output types. ' .Sp .TP 5 .BI \-\-map\-file= filename -Set file in which +Set file in which .B otftotfm will write a font map line for the font. The default is the standard output in manual mode, and @@ -956,7 +960,7 @@ have the following format: This tells .B otftotfm that the glyph named -.I glyph +.I glyph translates into the first Unicode value in the .I choice list that has a character in the font. \fIGlyph\fR and the @@ -1042,7 +1046,7 @@ and .IR glyph2 . "{LK}" and "{KL}" inhibit both ligatures and kerns. .PP -You can set the +You can set the .B \-\-boundary\-char and .B \-\-altselector\-char @@ -1060,7 +1064,7 @@ has a default set of eight ligatures, namely: space l =: lslash ; space L =: Lslash ; question quoteleft =: questiondown ; exclam quoteleft =: exclamdown ; hyphen hyphen =: endash ; endash hyphen =: emdash ; - quoteleft quoteleft =: quotedblleft ; + quoteleft quoteleft =: quotedblleft ; quoteright quoteright =: quotedblright .fi LIGKERN commands in the encoding file and diff --git a/Master/texmf-dist/doc/man/man1/otftotfm.man1.pdf b/Master/texmf-dist/doc/man/man1/otftotfm.man1.pdf Binary files differindex 2b107a28d6f..0dc017623a6 100644 --- a/Master/texmf-dist/doc/man/man1/otftotfm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/otftotfm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/otp2ocp.man1.pdf b/Master/texmf-dist/doc/man/man1/otp2ocp.man1.pdf Binary files differindex cd70d765b34..199edfc4347 100644 --- a/Master/texmf-dist/doc/man/man1/otp2ocp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/otp2ocp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/outocp.man1.pdf b/Master/texmf-dist/doc/man/man1/outocp.man1.pdf Binary files differindex 3b719445cac..dfd922e8cc7 100644 --- a/Master/texmf-dist/doc/man/man1/outocp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/outocp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ovf2ovp.1 b/Master/texmf-dist/doc/man/man1/ovf2ovp.1 index ec12589e3b3..3cf8495e53e 100644 --- a/Master/texmf-dist/doc/man/man1/ovf2ovp.1 +++ b/Master/texmf-dist/doc/man/man1/ovf2ovp.1 @@ -1,4 +1,4 @@ -.TH OVF2OVP 1 "14 April 2016" "Web2C 2017" +.TH OVF2OVP 1 "14 April 2016" "Web2C 2018" .PP .SH "NAME" ovf2ovp \- convert virtual font file and associated font metrics to property-list format diff --git a/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf b/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf Binary files differindex 1637175941c..29305c9b09e 100644 --- a/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ovf2ovp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ovp2ovf.1 b/Master/texmf-dist/doc/man/man1/ovp2ovf.1 index 983ec6d1b53..988f2e06322 100644 --- a/Master/texmf-dist/doc/man/man1/ovp2ovf.1 +++ b/Master/texmf-dist/doc/man/man1/ovp2ovf.1 @@ -1,4 +1,4 @@ -.TH OVP2OVF 1 "16 June 2015" "Web2C 2017" +.TH OVP2OVF 1 "16 June 2015" "Web2C 2018" .PP .SH "NAME" ovp2ovf \- convert a virtual property-list file into a virtual font file and its associated font metric file diff --git a/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf b/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf Binary files differindex 5e69616918f..e3310239269 100644 --- a/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ovp2ovf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/patgen.1 b/Master/texmf-dist/doc/man/man1/patgen.1 index 9cdeb518f3b..36f855dc30a 100644 --- a/Master/texmf-dist/doc/man/man1/patgen.1 +++ b/Master/texmf-dist/doc/man/man1/patgen.1 @@ -1,4 +1,4 @@ -.TH PATGEN 1 "16 June 2015" "Web2C 2017" +.TH PATGEN 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/patgen.man1.pdf b/Master/texmf-dist/doc/man/man1/patgen.man1.pdf Binary files differindex d6d545b459c..c53f9d9137a 100644 --- a/Master/texmf-dist/doc/man/man1/patgen.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/patgen.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdfclose.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfclose.man1.pdf Binary files differindex e2f57da43c3..55462fe4d3c 100644 --- a/Master/texmf-dist/doc/man/man1/pdfclose.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdfclose.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdfetex.1 b/Master/texmf-dist/doc/man/man1/pdfetex.1 index 5941b9fba88..6ad134e7139 100644 --- a/Master/texmf-dist/doc/man/man1/pdfetex.1 +++ b/Master/texmf-dist/doc/man/man1/pdfetex.1 @@ -1,4 +1,4 @@ -.TH PDFETEX 1 "16 June 2015" "Web2C 2017" +.TH PDFETEX 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf Binary files differindex 1101c0028e1..bcca9a52c24 100644 --- a/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdfetex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf Binary files differindex 2787c97a306..538c299f2cf 100644 --- a/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdflatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdfopen.man1.pdf b/Master/texmf-dist/doc/man/man1/pdfopen.man1.pdf Binary files differindex c120dd436e0..9990dccfa8a 100644 --- a/Master/texmf-dist/doc/man/man1/pdfopen.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdfopen.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdftex.1 b/Master/texmf-dist/doc/man/man1/pdftex.1 index 2fa7ef0cdc4..ee38ce0c2f9 100644 --- a/Master/texmf-dist/doc/man/man1/pdftex.1 +++ b/Master/texmf-dist/doc/man/man1/pdftex.1 @@ -1,4 +1,4 @@ -.TH PDFTEX 1 "4 May 2016" "Web2C 2017" +.TH PDFTEX 1 "4 May 2016" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf b/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf Binary files differindex 5c5ec4f9247..d50cd6fdd74 100644 --- a/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdftex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pdftosrc.1 b/Master/texmf-dist/doc/man/man1/pdftosrc.1 index 194d248e8cd..90c320c1226 100644 --- a/Master/texmf-dist/doc/man/man1/pdftosrc.1 +++ b/Master/texmf-dist/doc/man/man1/pdftosrc.1 @@ -1,4 +1,4 @@ -.TH pdftosrc 1 "16 June 2015" "Web2C 2017" +.TH pdftosrc 1 "16 June 2015" "Web2C 2018" .SH NAME pdftosrc \- extract source file or stream from PDF file .SH SYNOPSIS diff --git a/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf b/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf Binary files differindex ca0a457598a..bbc8aff3322 100644 --- a/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pdftosrc.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pfb2pfa.man1.pdf b/Master/texmf-dist/doc/man/man1/pfb2pfa.man1.pdf Binary files differindex 5187d415e92..b635b035859 100644 --- a/Master/texmf-dist/doc/man/man1/pfb2pfa.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pfb2pfa.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pk2bm.man1.pdf b/Master/texmf-dist/doc/man/man1/pk2bm.man1.pdf Binary files differindex 9d78e498dd1..1d6e2b285d1 100644 --- a/Master/texmf-dist/doc/man/man1/pk2bm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pk2bm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pktogf.1 b/Master/texmf-dist/doc/man/man1/pktogf.1 index 840f08e5115..018ebe9e9f4 100644 --- a/Master/texmf-dist/doc/man/man1/pktogf.1 +++ b/Master/texmf-dist/doc/man/man1/pktogf.1 @@ -1,4 +1,4 @@ -.TH PKTOGF 1 "16 June 2015" "Web2C 2017" +.TH PKTOGF 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf b/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf Binary files differindex 13f12de2fdb..6313a8c8c90 100644 --- a/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pktogf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pktype.1 b/Master/texmf-dist/doc/man/man1/pktype.1 index d83baa941d9..2cbc2c4d295 100644 --- a/Master/texmf-dist/doc/man/man1/pktype.1 +++ b/Master/texmf-dist/doc/man/man1/pktype.1 @@ -1,4 +1,4 @@ -.TH PKTYPE 1 "16 June 2015" "Web2C 2017" +.TH PKTYPE 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pktype.man1.pdf b/Master/texmf-dist/doc/man/man1/pktype.man1.pdf Binary files differindex b8d09e11ec3..52ab9e9380e 100644 --- a/Master/texmf-dist/doc/man/man1/pktype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pktype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pltotf.1 b/Master/texmf-dist/doc/man/man1/pltotf.1 index c44eca38e32..e121ac57d9f 100644 --- a/Master/texmf-dist/doc/man/man1/pltotf.1 +++ b/Master/texmf-dist/doc/man/man1/pltotf.1 @@ -1,4 +1,4 @@ -.TH PLTOTF 1 "16 June 2015" "Web2C 2017" +.TH PLTOTF 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf b/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf Binary files differindex 9b703b7b2c1..28e0e9ea482 100644 --- a/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pltotf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pooltype.1 b/Master/texmf-dist/doc/man/man1/pooltype.1 index 82989c646cb..6660d017e05 100644 --- a/Master/texmf-dist/doc/man/man1/pooltype.1 +++ b/Master/texmf-dist/doc/man/man1/pooltype.1 @@ -1,4 +1,4 @@ -.TH POOLTYPE 1 "16 June 2015" "Web2C 2017" +.TH POOLTYPE 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf b/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf Binary files differindex 8ed035dabf5..52d34574302 100644 --- a/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pooltype.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/prepmx.man1.pdf b/Master/texmf-dist/doc/man/man1/prepmx.man1.pdf Binary files differindex a65280cdc1d..bd1bdf3b383 100644 --- a/Master/texmf-dist/doc/man/man1/prepmx.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/prepmx.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ps2eps.man1.pdf b/Master/texmf-dist/doc/man/man1/ps2eps.man1.pdf Binary files differindex 99433c3008e..571bb0463ce 100644 --- a/Master/texmf-dist/doc/man/man1/ps2eps.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ps2eps.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ps2frag.man1.pdf b/Master/texmf-dist/doc/man/man1/ps2frag.man1.pdf Binary files differindex b371e6c9e33..f2cd9c40a41 100644 --- a/Master/texmf-dist/doc/man/man1/ps2frag.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ps2frag.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ps2pk.man1.pdf b/Master/texmf-dist/doc/man/man1/ps2pk.man1.pdf Binary files differindex 19631136cc9..5b95fc09c35 100644 --- a/Master/texmf-dist/doc/man/man1/ps2pk.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ps2pk.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/psbook.man1.pdf b/Master/texmf-dist/doc/man/man1/psbook.man1.pdf Binary files differindex 81aae11f9ae..245e6912eee 100644 --- a/Master/texmf-dist/doc/man/man1/psbook.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/psbook.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/psjoin.man1.pdf b/Master/texmf-dist/doc/man/man1/psjoin.man1.pdf Binary files differindex f78e4599811..1e644f2ff91 100644 --- a/Master/texmf-dist/doc/man/man1/psjoin.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/psjoin.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pslatex.man1.pdf b/Master/texmf-dist/doc/man/man1/pslatex.man1.pdf Binary files differindex 8cb33b71495..e9cc8a8c284 100644 --- a/Master/texmf-dist/doc/man/man1/pslatex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pslatex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/psnup.man1.pdf b/Master/texmf-dist/doc/man/man1/psnup.man1.pdf Binary files differindex 9fd91fc3f15..9ff7f1dd2a5 100644 --- a/Master/texmf-dist/doc/man/man1/psnup.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/psnup.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/psresize.man1.pdf b/Master/texmf-dist/doc/man/man1/psresize.man1.pdf Binary files differindex e11505b57d0..b8a5dde36d8 100644 --- a/Master/texmf-dist/doc/man/man1/psresize.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/psresize.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/psselect.man1.pdf b/Master/texmf-dist/doc/man/man1/psselect.man1.pdf Binary files differindex 3bf7758db40..e8193f3f1b0 100644 --- a/Master/texmf-dist/doc/man/man1/psselect.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/psselect.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/pstops.man1.pdf b/Master/texmf-dist/doc/man/man1/pstops.man1.pdf Binary files differindex c6da783afca..deca03c3a61 100644 --- a/Master/texmf-dist/doc/man/man1/pstops.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/pstops.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/psutils.man1.pdf b/Master/texmf-dist/doc/man/man1/psutils.man1.pdf Binary files differindex b1a79c57eb1..471f3b9f1fc 100644 --- a/Master/texmf-dist/doc/man/man1/psutils.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/psutils.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/rubibtex.man1.pdf b/Master/texmf-dist/doc/man/man1/rubibtex.man1.pdf Binary files differindex 39d4f0dd647..0453bd4894e 100644 --- a/Master/texmf-dist/doc/man/man1/rubibtex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/rubibtex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/rumakeindex.man1.pdf b/Master/texmf-dist/doc/man/man1/rumakeindex.man1.pdf Binary files differindex 0da4a87c875..4751361d65c 100644 --- a/Master/texmf-dist/doc/man/man1/rumakeindex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/rumakeindex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/sjisconv.man1.pdf b/Master/texmf-dist/doc/man/man1/sjisconv.man1.pdf Binary files differindex 5563f4b9227..7ddde49628c 100644 --- a/Master/texmf-dist/doc/man/man1/sjisconv.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/sjisconv.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/synctex.man1.pdf b/Master/texmf-dist/doc/man/man1/synctex.man1.pdf Binary files differindex b5c43c6ef37..ab63d7a0b14 100644 --- a/Master/texmf-dist/doc/man/man1/synctex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/synctex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1ascii.1 b/Master/texmf-dist/doc/man/man1/t1ascii.1 index 5d883f99129..8fc7e884cf5 100644 --- a/Master/texmf-dist/doc/man/man1/t1ascii.1 +++ b/Master/texmf-dist/doc/man/man1/t1ascii.1 @@ -1,4 +1,4 @@ -.ds V 1.39 +.ds V 1.41 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1ascii.man1.pdf b/Master/texmf-dist/doc/man/man1/t1ascii.man1.pdf Binary files differindex 348ff9e7dff..a8145f86a47 100644 --- a/Master/texmf-dist/doc/man/man1/t1ascii.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1ascii.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1asm.1 b/Master/texmf-dist/doc/man/man1/t1asm.1 index 0621a0e2585..cdf5e59c198 100644 --- a/Master/texmf-dist/doc/man/man1/t1asm.1 +++ b/Master/texmf-dist/doc/man/man1/t1asm.1 @@ -1,4 +1,4 @@ -.ds V 1.39 +.ds V 1.41 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1asm.man1.pdf b/Master/texmf-dist/doc/man/man1/t1asm.man1.pdf Binary files differindex 0c2923a93ff..3b9e277e621 100644 --- a/Master/texmf-dist/doc/man/man1/t1asm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1asm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1binary.1 b/Master/texmf-dist/doc/man/man1/t1binary.1 index 19d04b5b161..9574b394989 100644 --- a/Master/texmf-dist/doc/man/man1/t1binary.1 +++ b/Master/texmf-dist/doc/man/man1/t1binary.1 @@ -1,4 +1,4 @@ -.ds V 1.39 +.ds V 1.41 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1binary.man1.pdf b/Master/texmf-dist/doc/man/man1/t1binary.man1.pdf Binary files differindex 51a9669a85b..ad2c907e9a9 100644 --- a/Master/texmf-dist/doc/man/man1/t1binary.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1binary.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1disasm.1 b/Master/texmf-dist/doc/man/man1/t1disasm.1 index 308241c91bc..f9ff3b54281 100644 --- a/Master/texmf-dist/doc/man/man1/t1disasm.1 +++ b/Master/texmf-dist/doc/man/man1/t1disasm.1 @@ -1,4 +1,4 @@ -.ds V 1.39 +.ds V 1.41 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1disasm.man1.pdf b/Master/texmf-dist/doc/man/man1/t1disasm.man1.pdf Binary files differindex 65c00335cbf..884e0617db2 100644 --- a/Master/texmf-dist/doc/man/man1/t1disasm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1disasm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1dotlessj.1 b/Master/texmf-dist/doc/man/man1/t1dotlessj.1 index 236e266bb63..b9c7077c5e7 100644 --- a/Master/texmf-dist/doc/man/man1/t1dotlessj.1 +++ b/Master/texmf-dist/doc/man/man1/t1dotlessj.1 @@ -1,4 +1,4 @@ -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1dotlessj.man1.pdf b/Master/texmf-dist/doc/man/man1/t1dotlessj.man1.pdf Binary files differindex 4bcb9bc7327..2aac54e51c9 100644 --- a/Master/texmf-dist/doc/man/man1/t1dotlessj.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1dotlessj.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1lint.1 b/Master/texmf-dist/doc/man/man1/t1lint.1 index e9eb52197e2..5b317df9459 100644 --- a/Master/texmf-dist/doc/man/man1/t1lint.1 +++ b/Master/texmf-dist/doc/man/man1/t1lint.1 @@ -1,4 +1,4 @@ -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1lint.man1.pdf b/Master/texmf-dist/doc/man/man1/t1lint.man1.pdf Binary files differindex 1412758daf6..082f7f8641d 100644 --- a/Master/texmf-dist/doc/man/man1/t1lint.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1lint.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1mac.1 b/Master/texmf-dist/doc/man/man1/t1mac.1 index a65fdc801c5..e48af31dbe3 100644 --- a/Master/texmf-dist/doc/man/man1/t1mac.1 +++ b/Master/texmf-dist/doc/man/man1/t1mac.1 @@ -1,4 +1,4 @@ -.ds V 1.39 +.ds V 1.41 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1mac.man1.pdf b/Master/texmf-dist/doc/man/man1/t1mac.man1.pdf Binary files differindex 0306f08ce1e..d55b6326e76 100644 --- a/Master/texmf-dist/doc/man/man1/t1mac.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1mac.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1rawafm.1 b/Master/texmf-dist/doc/man/man1/t1rawafm.1 index cfda238e4d1..753593c76f9 100644 --- a/Master/texmf-dist/doc/man/man1/t1rawafm.1 +++ b/Master/texmf-dist/doc/man/man1/t1rawafm.1 @@ -1,4 +1,4 @@ -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1rawafm.man1.pdf b/Master/texmf-dist/doc/man/man1/t1rawafm.man1.pdf Binary files differindex 3b2caeff6c7..50d7398072e 100644 --- a/Master/texmf-dist/doc/man/man1/t1rawafm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1rawafm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1reencode.1 b/Master/texmf-dist/doc/man/man1/t1reencode.1 index d39c3c49806..adc38badab9 100644 --- a/Master/texmf-dist/doc/man/man1/t1reencode.1 +++ b/Master/texmf-dist/doc/man/man1/t1reencode.1 @@ -1,4 +1,4 @@ -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1reencode.man1.pdf b/Master/texmf-dist/doc/man/man1/t1reencode.man1.pdf Binary files differindex 2df19837285..50006d52d5c 100644 --- a/Master/texmf-dist/doc/man/man1/t1reencode.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1reencode.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1testpage.1 b/Master/texmf-dist/doc/man/man1/t1testpage.1 index 1aac2917693..5c86e4233ab 100644 --- a/Master/texmf-dist/doc/man/man1/t1testpage.1 +++ b/Master/texmf-dist/doc/man/man1/t1testpage.1 @@ -1,4 +1,4 @@ -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1testpage.man1.pdf b/Master/texmf-dist/doc/man/man1/t1testpage.man1.pdf Binary files differindex 3ecc4de4525..40964069d9c 100644 --- a/Master/texmf-dist/doc/man/man1/t1testpage.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1testpage.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/t1unmac.1 b/Master/texmf-dist/doc/man/man1/t1unmac.1 index 372bb74ccd8..a86c9ea15af 100644 --- a/Master/texmf-dist/doc/man/man1/t1unmac.1 +++ b/Master/texmf-dist/doc/man/man1/t1unmac.1 @@ -1,4 +1,4 @@ -.ds V 1.39 +.ds V 1.41 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/t1unmac.man1.pdf b/Master/texmf-dist/doc/man/man1/t1unmac.man1.pdf Binary files differindex cb945a72fa8..fb2ac85b144 100644 --- a/Master/texmf-dist/doc/man/man1/t1unmac.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/t1unmac.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tangle.1 b/Master/texmf-dist/doc/man/man1/tangle.1 index 5435c2ce623..62eb1378278 100644 --- a/Master/texmf-dist/doc/man/man1/tangle.1 +++ b/Master/texmf-dist/doc/man/man1/tangle.1 @@ -1,4 +1,4 @@ -.TH TANGLE 1 "16 June 2015" "Web2C 2017" +.TH TANGLE 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/tangle.man1.pdf b/Master/texmf-dist/doc/man/man1/tangle.man1.pdf Binary files differindex 5d609e312a1..0a9f6a05a8f 100644 --- a/Master/texmf-dist/doc/man/man1/tangle.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tangle.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tex.1 b/Master/texmf-dist/doc/man/man1/tex.1 index 670e31675ad..6c6ee26fbff 100644 --- a/Master/texmf-dist/doc/man/man1/tex.1 +++ b/Master/texmf-dist/doc/man/man1/tex.1 @@ -1,4 +1,4 @@ -.TH TEX 1 "16 June 2015" "Web2C 2017" +.TH TEX 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/tex.man1.pdf b/Master/texmf-dist/doc/man/man1/tex.man1.pdf Binary files differindex 41462fe4245..6afb006ead3 100644 --- a/Master/texmf-dist/doc/man/man1/tex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tex2aspc.man1.pdf b/Master/texmf-dist/doc/man/man1/tex2aspc.man1.pdf Binary files differindex 157dcefdf56..d3fe0819bc7 100644 --- a/Master/texmf-dist/doc/man/man1/tex2aspc.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tex2aspc.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texconfig-sys.man1.pdf b/Master/texmf-dist/doc/man/man1/texconfig-sys.man1.pdf Binary files differindex 35dbc65a9bb..d47fa38ee2b 100644 --- a/Master/texmf-dist/doc/man/man1/texconfig-sys.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texconfig-sys.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texconfig.man1.pdf b/Master/texmf-dist/doc/man/man1/texconfig.man1.pdf Binary files differindex 95d6b8ab96a..1beb8d30134 100644 --- a/Master/texmf-dist/doc/man/man1/texconfig.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texconfig.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texdoctk.man1.pdf b/Master/texmf-dist/doc/man/man1/texdoctk.man1.pdf Binary files differindex b1f1f677c7c..13c31ee0f21 100644 --- a/Master/texmf-dist/doc/man/man1/texdoctk.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texdoctk.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texhash.man1.pdf b/Master/texmf-dist/doc/man/man1/texhash.man1.pdf Binary files differindex d91b1b23c41..e6a86fcee9d 100644 --- a/Master/texmf-dist/doc/man/man1/texhash.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texhash.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texlinks.man1.pdf b/Master/texmf-dist/doc/man/man1/texlinks.man1.pdf Binary files differindex 05a731e8ea6..4d782ecb975 100644 --- a/Master/texmf-dist/doc/man/man1/texlinks.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texlinks.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texlua.man1.pdf b/Master/texmf-dist/doc/man/man1/texlua.man1.pdf Binary files differindex c735957a5d7..6ed92b40633 100644 --- a/Master/texmf-dist/doc/man/man1/texlua.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texlua.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/texluac.man1.pdf b/Master/texmf-dist/doc/man/man1/texluac.man1.pdf Binary files differindex 1ef9077eaa4..57df361cee8 100644 --- a/Master/texmf-dist/doc/man/man1/texluac.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/texluac.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tftopl.1 b/Master/texmf-dist/doc/man/man1/tftopl.1 index 1cd458358f3..bfa2e81f341 100644 --- a/Master/texmf-dist/doc/man/man1/tftopl.1 +++ b/Master/texmf-dist/doc/man/man1/tftopl.1 @@ -1,4 +1,4 @@ -.TH TFTOPL 1 "16 June 2015" "Web2C 2017" +.TH TFTOPL 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf b/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf Binary files differindex 67fe25f2f4b..f73222bc31f 100644 --- a/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tftopl.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tie.1 b/Master/texmf-dist/doc/man/man1/tie.1 index cbec3b94410..7c39e7b634c 100644 --- a/Master/texmf-dist/doc/man/man1/tie.1 +++ b/Master/texmf-dist/doc/man/man1/tie.1 @@ -1,4 +1,4 @@ -.TH TIE 1 "7 April 2010" "Web2C 2017" +.TH TIE 1 "7 April 2010" "Web2C 2018" .\"===================================================================== .SH NAME tie \- merge or apply WEB change files diff --git a/Master/texmf-dist/doc/man/man1/tie.man1.pdf b/Master/texmf-dist/doc/man/man1/tie.man1.pdf Binary files differindex 9cb1ee7f447..b67be227db4 100644 --- a/Master/texmf-dist/doc/man/man1/tie.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tie.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/tpic2pdftex.man1.pdf b/Master/texmf-dist/doc/man/man1/tpic2pdftex.man1.pdf Binary files differindex b87e379984d..c3f65673bb4 100644 --- a/Master/texmf-dist/doc/man/man1/tpic2pdftex.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/tpic2pdftex.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ttf2afm.1 b/Master/texmf-dist/doc/man/man1/ttf2afm.1 index cfcb01e334c..3e027b7b94b 100644 --- a/Master/texmf-dist/doc/man/man1/ttf2afm.1 +++ b/Master/texmf-dist/doc/man/man1/ttf2afm.1 @@ -1,4 +1,4 @@ -.TH TTF2AFM 1 "8 March 2016" "Web2C 2017" +.TH TTF2AFM 1 "8 March 2016" "Web2C 2018" .PP .SH "NAME" ttf2afm \- utility to generate AFM files for TrueType fonts diff --git a/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf b/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf Binary files differindex 2908d08c839..8708e3320e8 100644 --- a/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ttf2afm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ttf2pk.man1.pdf b/Master/texmf-dist/doc/man/man1/ttf2pk.man1.pdf Binary files differindex a16fff7039c..96ac6473a19 100644 --- a/Master/texmf-dist/doc/man/man1/ttf2pk.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ttf2pk.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ttf2tfm.man1.pdf b/Master/texmf-dist/doc/man/man1/ttf2tfm.man1.pdf Binary files differindex 82115dd0828..4fa3354ef94 100644 --- a/Master/texmf-dist/doc/man/man1/ttf2tfm.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ttf2tfm.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ttfdump.man1.pdf b/Master/texmf-dist/doc/man/man1/ttfdump.man1.pdf Binary files differindex 09e77e352f1..c6c68893383 100644 --- a/Master/texmf-dist/doc/man/man1/ttfdump.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ttfdump.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/ttftotype42.1 b/Master/texmf-dist/doc/man/man1/ttftotype42.1 index 9748c53a194..cd44e49bd1c 100644 --- a/Master/texmf-dist/doc/man/man1/ttftotype42.1 +++ b/Master/texmf-dist/doc/man/man1/ttftotype42.1 @@ -1,4 +1,4 @@ -.ds V 2.106 +.ds V 2.107 .de M .BR "\\$1" "(\\$2)\\$3" .. diff --git a/Master/texmf-dist/doc/man/man1/ttftotype42.man1.pdf b/Master/texmf-dist/doc/man/man1/ttftotype42.man1.pdf Binary files differindex 6b877a64b74..1923dab0d46 100644 --- a/Master/texmf-dist/doc/man/man1/ttftotype42.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/ttftotype42.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf Binary files differindex 329360e93c1..586b82f34e2 100644 --- a/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/updmap-sys.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf Binary files differindex c1b6dfd08bb..cf55bf8e46d 100644 --- a/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/updmap-user.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/updmap.1 b/Master/texmf-dist/doc/man/man1/updmap.1 index 5a7518996d8..c72ae139fec 100644 --- a/Master/texmf-dist/doc/man/man1/updmap.1 +++ b/Master/texmf-dist/doc/man/man1/updmap.1 @@ -1,60 +1,33 @@ -.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.4. -.TH UPDMAP "1" "May 2017" "TeX Live" "User Commands" +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.45.1. +.TH UPDMAP "1" "May 2014" "TeX Live" "User Commands" .SH NAME updmap \- manage TeX font maps, per-user .br updmap-sys \- manage TeX font maps, system-wide .SH SYNOPSIS .B updmap -[\fI\,-user|-sys\/\fR] [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] -.br -.B updmap-user [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] .br .B updmap-sys [\fI\,OPTION\/\fR] ... [\fI\,COMMAND\/\fR] .SH DESCRIPTION -updmap version r44149 (2017\-05\-02 11:57:51 +0200) +updmap version svn33988 (2014\-05\-12 15:39:32 +0900) .PP -Update the default font map files used by pdftex (pdftex.map), dvips -(psfonts.map), and dvipdfm(x), and optionally pxdvi, as determined by -all configuration files updmap.cfg (the ones returned by running -"kpsewhich \fB\-\-all\fR updmap.cfg", but see below). +Update the default font map files used by pdftex, dvips, and dvipdfm(x), +and optionally pxdvi, as determined by all configuration files updmap.cfg +(the ones returned by running "kpsewhich \fB\-\-all\fR updmap.cfg", but see below). .PP Among other things, these map files are used to determine which fonts should be used as bitmaps and which as outlines, and to determine which -font files are included, typically subsetted, in the PDF or PostScript output. +font files are included in the PDF or PostScript output. .PP -updmap\-sys (or updmap \fB\-sys\fR) is intended to affect the system\-wide -configuration, while updmap\-user (or updmap \fB\-user\fR) affects personal -configuration files only, overriding the system files. -As a consequence, once updmap\-user has been run, even a single time, +updmap\-sys is intended to affect the system\-wide configuration, while +updmap affects personal configuration files only, overriding the system +files. As a consequence, once updmap has been run, even a single time, running updmap\-sys no longer has any effect. (updmap\-sys issues a warning in this situation.) .PP -See http://tug.org/texlive/scripts\-sys\-user.html for details. -.PP By default, the TeX filename database (ls\-R) is also updated. -.PP -The updmap system is regrettably complicated, for both inherent and -historical reasons. A general overview: -.PP -\- updmap.cfg files are mainly about listing other files, namely the -.IP -font\-specific .maps, in which each line gives information about a -different TeX (.tfm) font. -.PP -\- updmap reads the updmap.cfg files and then concatenates the -.IP -contents of those .map files into the main output files: psfonts.map -for dvips and pdftex.map for pdftex and dvipdfmx. -.PP -\- The updmap.cfg files themselves are created and updated at package -.IP -installation time, by the system installer or the package manager or -by hand, and not (by default) by updmap. -.PP -Good luck. .SH OPTIONS .TP \fB\-\-cnffile\fR FILE @@ -92,9 +65,6 @@ do not run texhash \fB\-\-sys\fR affect system\-wide files (equivalent to updmap\-sys) .TP -\fB\-\-user\fR -affect personal files (equivalent to updmap\-user) -.TP \fB\-n\fR, \fB\-\-dry\-run\fR only show the configuration, no output .TP @@ -135,46 +105,20 @@ add "Map MAPFILE" to updmap.cfg disable MAPFILE, of whatever type .TP \fB\-\-listmaps\fR -list all maps (details below) +list all active and inactive maps .TP \fB\-\-listavailablemaps\fR -list available maps (details below) +same as \fB\-\-listmaps\fR, but without +unavailable map files .TP \fB\-\-syncwithtrees\fR disable unavailable map files in updmap.cfg .PP -The main output: -.IP -The main output of updmap is the files containing the individual font -map lines which the drivers (dvips, pdftex, etc.) read to handle fonts. -.IP -The map files for dvips (psfonts.map) and pdftex and dvipdfmx -(pdftex.map) are written to TEXMFVAR/fonts/map/updmap/{dvips,pdftex}/. -.IP -In addition, information about Kanji fonts is written to -TEXMFVAR/fonts/map/updmap/dvipdfmx/kanjix.map, and optionally to -TEXMFVAR/fonts/map/updmap/pxdvi/xdvi\-ptex.map. These are for Kanji -only and are not like other map files. dvipdfmx reads pdftex.map for -the map entries for non\-Kanji fonts. -.IP -If no option is given, so the invocation is just "updmap\-user" or -"updmap\-sys", these output files are always recreated. -.IP -Otherwise, if an option such as \fB\-\-enable\fR or \fB\-\-disable\fR is given, the -output files are recreated if the list of enabled map files (from -updmap.cfg) has changed. The \fB\-\-force\fR option overrides this, -always recreating the output files. -.PP -Explanation of the map types: -.IP -The normal type is Map. -.IP -The only difference between Map and MixedMap is that MixedMap entries -are not added to psfonts_pk.map. The purpose is to help users with -devices that render Type 1 outline fonts worse than mode\-tuned Type 1 -bitmap fonts. So, MixedMap is used for fonts that are available as -both Type 1 and Metafont. -.IP +Explanation of the map types: the (only) difference between Map and +MixedMap is that MixedMap entries are not added to psfonts_pk.map. +The purpose is to help users with devices that render Type 1 outline +fonts worse than mode\-tuned Type 1 bitmap fonts. So, MixedMap is used +for fonts that are available as both Type 1 and Metafont. KanjiMap entries are added to psfonts_t1.map and kanjix.map. .PP Explanation of the OPTION names for \fB\-\-showoptions\fR, \fB\-\-showoption\fR, \fB\-\-setoption\fR: @@ -199,19 +143,10 @@ true,false (default false) .IP Whether maps for pxdvi (Japanese\-patched xdvi) are under updmap's control. .TP -jaEmbed +kanjiEmbed (any string) .TP -jaVariant -(any string) -.TP -scEmbed -(any string) -.TP -tcEmbed -(any string) -.TP -koEmbed +kanjiVariant (any string) .IP See below. @@ -242,24 +177,21 @@ file which the programs read, so they can be overridden by specifying command\-line options or configuration files to the programs, as explained at the beginning of updmap.cfg. .IP -The options jaEmbed and jaVariant (formerly kanjiEmbed and kanjiVariant) -specify special replacements in the map lines. If a map contains the -string @jaEmbed@, then this will be replaced by the value of that option; -similarly for jaVariant. In this way, users of Japanese TeX can select -different fonts to be included in the final output. The counterpart for -Simplified Chinese, Traditional Chinese and Korean fonts are -scEmbed, tcEmbed and koEmbed respectively. +The options kanjiEmbed and kanjiVariant specify special replacements +in the map lines. If a map contains the string @kanjiEmbed@, then +this will be replaced by the value of that option; similarly for +kanjiVariant. In this way, users of Japanese TeX can select different +fonts to be included in the final output. .SH ENVIRONMENT .PP Explanation of trees and files normally used: .IP -If \fB\-\-cnffile\fR is specified on the command line (can be given multiple -times), its value(s) is(are) used. Otherwise, updmap reads all the -updmap.cfg files found by running `kpsewhich \fB\-all\fR updmap.cfg', -in the order returned by kpsewhich (which is the order of trees -defined in texmf.cnf). +If \fB\-\-cnffile\fR is specified on the command line (possibly multiple +times), its value(s) are used. Otherwise, updmap reads all the +updmap.cfg files found by running `kpsewhich \fB\-all\fR updmap.cfg', in the +order returned by kpsewhich. .IP -In either case, if multiple updmap.cfg files are found, all the maps +In any case, if multiple updmap.cfg files are found, all the maps mentioned in all the updmap.cfg files are merged. .IP Thus, if updmap.cfg files are present in all trees, and the default @@ -273,7 +205,7 @@ TEXMFSYSVAR \fI\,$TEXLIVE/YYYY/texmf\-var/web2c/updmap.cfg\/\fP TEXMFLOCAL \fI\,$TEXLIVE/texmf\-local/web2c/updmap.cfg\/\fP TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/updmap.cfg\/\fP .IP -For updmap\-user: +For updmap: TEXMFCONFIG $HOME/.texliveYYYY/texmf\-config/web2c/updmap.cfg TEXMFVAR $HOME/.texliveYYYY/texmf\-var/web2c/updmap.cfg TEXMFHOME \fI\,$HOME/texmf/web2c/updmap.cfg\/\fP @@ -288,31 +220,25 @@ TEXMFDIST \fI\,$TEXLIVE/YYYY/texmf\-dist/web2c/updmap.cfg\/\fP According to the actions, updmap might write to one of the given files or create a new updmap.cfg, described further below. .PP -Where and which updmap.cfg changes are saved: -.IP -When no options are given, the updmap.cfg file(s) are only read, not -written. It's when an option \fB\-\-setoption\fR, \fB\-\-enable\fR or \fB\-\-disable\fR is -specified that an updmap.cfg needs to be updated. In this case: -.IP -1) If config files are given on the command line, then the first one -given is used to save any such changes. +Where changes are saved: .IP -2) If the config files are taken from kpsewhich output, then the -algorithm is more complex: +If config files are given on the command line, then the first one +given will be used to save any changes from \fB\-\-setoption\fR, \fB\-\-enable\fR +or \fB\-\-disable\fR. If the config files are taken from kpsewhich output, +then the algorithm is more complex: .IP -2a) If \fI\,$TEXMFCONFIG/web2c/updmap.cfg\/\fP or \fI\,$TEXMFHOME/web2c/updmap.cfg\/\fP +1) If \fI\,$TEXMFCONFIG/web2c/updmap.cfg\/\fP or \fI\,$TEXMFHOME/web2c/updmap.cfg\/\fP appears in the list of used files, then the one listed first by kpsewhich \fB\-\-all\fR (equivalently, the one returned by kpsewhich updmap.cfg), is used. .IP -2b) If neither of the above two are present and changes are made, a +2) If neither of the above two are present and changes are made, a new config file is created in \fI\,$TEXMFCONFIG/web2c/updmap.cfg\/\fP. .IP -In general, the idea is that if the user cannot write to a given -config file, a higher\-level one can be used. That way, the -distribution's settings can be overridden system\-wide using -TEXMFLOCAL, and system settings can be overridden again in a -particular user's TEXMFHOME. +In general, the idea is that if a given config file is not writable, a +higher\-level one can be used. That way, the distribution's settings +can be overridden for system\-wide using TEXMFLOCAL, and then system +settings can be overridden again for a particular using using TEXMFHOME. .PP Resolving multiple definitions of a font: .IP @@ -332,12 +258,8 @@ writing, e.g., or .IP #! MixedMap mapname.map -.TP -in the higher\-priority updmap.cfg file. -(The #! must be at the .IP -beginning of the line, with at least one space or tab afterward, and -whitespace between each word on the list.) +in the higher\-priority updmap.cfg file. .IP As an example, suppose you have a copy of MathTime Pro fonts and want to disable the Belleek version of the fonts; that is, @@ -350,26 +272,16 @@ Map mt\-yy.map .IP and call updmap. .PP -Listing of maps: -.IP -The two options \fB\-\-listmaps\fR and \fB\-\-listavailablemaps\fR list all maps -defined in any of the updmap.cfg files (for \fB\-\-listmaps\fR), and -only those actually found on the system (for \fB\-\-listavailablemaps\fR). -The output format is one line per font map, with the following -fields separated by tabs: map, type (Map, MixedMap, KanjiMap), -status (enabled, disabled), origin (the updmap.cfg file where -it is mentioned, or 'builtin' for the three basic maps). -.IP -In the case of \fB\-\-listmaps\fR there can be one additional fields -(again separated by tab) containing '(not available)' for those -map files that cannot be found. +updmap writes the map files for dvips (psfonts.map) and pdftex +(pdftex.map) to the TEXMFVAR/fonts/map/updmap/{dvips,pdftex}/ +directories. +.PP +The log file is written to TEXMFVAR/web2c/updmap.log. .PP -updmap\-user vs. updmap\-sys: -.IP When updmap\-sys is run, TEXMFSYSCONFIG and TEXMFSYSVAR are used -instead of TEXMFCONFIG and TEXMFVAR, respectively. This is the -primary difference between updmap\-sys and updmap\-user. -.IP +instead of TEXMFCONFIG and TEXMFVAR, respectively. This is the only +difference between updmap\-sys and updmap. +.PP Other locations may be used if you give them on the command line, or these trees don't exist, or you are not using the original TeX Live. .PP @@ -377,11 +289,9 @@ To see the precise locations of the various files that will be read and written, give the \fB\-n\fR option (or read the source). .SH EXAMPLES .PP -The log file is written to TEXMFVAR/web2c/updmap.log. -.PP For step\-by\-step instructions on making new fonts known to TeX, read http://tug.org/fonts/fontinstall.html. For even more terse -instructions, read the beginning of the main updmap.cfg file. +instructions, read the beginning of the main updmap.cfg. .SH FILES Configuration and input files: .IP "\fIupdmap\&.cfg\fP" @@ -459,6 +369,6 @@ of \fIpsfonts\&.map\fP\&. Loads \fIpsfonts_t1\&.map\fP instead of \fIpsfonts\&.map\fP\&. .SH "REPORTING BUGS" -Report bugs to: tex\-live@tug.org +Report bugs to: tex\-k@tug.org .br TeX Live home page: <http://tug.org/texlive/> diff --git a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf Binary files differindex 173f3dd774a..274d3af6e14 100644 --- a/Master/texmf-dist/doc/man/man1/updmap.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/updmap.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/vftovp.1 b/Master/texmf-dist/doc/man/man1/vftovp.1 index 0badeb15eed..15f07c21624 100644 --- a/Master/texmf-dist/doc/man/man1/vftovp.1 +++ b/Master/texmf-dist/doc/man/man1/vftovp.1 @@ -1,4 +1,4 @@ -.TH VFTOVP 1 "16 June 2015" "Web2C 2017" +.TH VFTOVP 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf b/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf Binary files differindex 0c2cd57f7d9..8df551b7b61 100644 --- a/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/vftovp.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/vlna.man1.pdf b/Master/texmf-dist/doc/man/man1/vlna.man1.pdf Binary files differindex 445e4f3572a..3a6aaf13b16 100644 --- a/Master/texmf-dist/doc/man/man1/vlna.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/vlna.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/vptovf.1 b/Master/texmf-dist/doc/man/man1/vptovf.1 index cde8db58832..9b073aa7170 100644 --- a/Master/texmf-dist/doc/man/man1/vptovf.1 +++ b/Master/texmf-dist/doc/man/man1/vptovf.1 @@ -1,4 +1,4 @@ -.TH VPTOVF 1 "16 June 2015" "Web2C 2017" +.TH VPTOVF 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if t .ds TX \fRT\\h'-0.1667m'\\v'0.20v'E\\v'-0.20v'\\h'-0.125m'X\fP .if n .ds TX TeX diff --git a/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf b/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf Binary files differindex d0e706b8dd7..e62eaaed68c 100644 --- a/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/vptovf.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/weave.1 b/Master/texmf-dist/doc/man/man1/weave.1 index 877826ec924..27e9483e7b9 100644 --- a/Master/texmf-dist/doc/man/man1/weave.1 +++ b/Master/texmf-dist/doc/man/man1/weave.1 @@ -1,4 +1,4 @@ -.TH WEAVE 1 "16 June 2015" "Web2C 2017" +.TH WEAVE 1 "16 June 2015" "Web2C 2018" .\"===================================================================== .if n .ds MF Metafont .if t .ds MF Metafont diff --git a/Master/texmf-dist/doc/man/man1/weave.man1.pdf b/Master/texmf-dist/doc/man/man1/weave.man1.pdf Binary files differindex 095dc094f35..602e5113203 100644 --- a/Master/texmf-dist/doc/man/man1/weave.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/weave.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/xdvi.1 b/Master/texmf-dist/doc/man/man1/xdvi.1 index d34cd361e25..32bab61d5a0 100644 --- a/Master/texmf-dist/doc/man/man1/xdvi.1 +++ b/Master/texmf-dist/doc/man/man1/xdvi.1 @@ -1,4 +1,4 @@ -.\" Copyright (c) 1990-2013 Paul Vojta and others +.\" Copyright 1990-2018 Paul Vojta and others .\" .\" This is Paul's license, included here only for reference, it does not apply .\" to all parts of the k version. @@ -106,7 +106,7 @@ xdvi \- DVI Previewer for the X Window System [\fB\-mfmode\fP \fImode-def\fP[\fB:\fP\fIdpi\fP]] [\fB\-mgs\fP[\fIn\fP] \fIsize\fP] [\fB\-mousemode\fP \fI0|1|2\fP] -[\fB\-nocolor\fP] +[\fB\-nocolor\fP] [\fB\-nofork\fP] [\fB\-noghostscript\fP] [\fB\-nogrey\fP] @@ -124,7 +124,7 @@ xdvi \- DVI Previewer for the X Window System [\fB\-pause\fP] [\fB\-pausespecial\fP \fIspecial-string\fP] [\fB\-postscript\fP \fIflag\fP] -[\fB\-rulecolor\fP \fIcolor\fP] +[\fB\-rulecolor\fP \fIcolor\fP] [\fB\-rv\fP] [\fB\-S\fP \fIdensity\fP] [\fB\-s\fP \fIshrink\fP] @@ -344,7 +344,7 @@ comma-separated list of strings. .br For the bitmask representation, multiple values can be specified by adding the numbers that represent the individual bits; -e.g. to debug all all file searching and opening commands, use 4032 +e.g. to debug all file searching and opening commands, use 4032 (= 2048 + 1024 + 512 + 256 + 128 + 64). Use -1 to turn on debugging of everything (this will produce huge output). .br @@ -442,7 +442,7 @@ to determine the editor command: .BR XEDITOR , .BR VISUAL , and -.B EDITOR +.B EDITOR (in this sequence). If the string is found as the value of the .SB VISUAL @@ -779,7 +779,7 @@ should not move to the home position when moving to a new page. See also the keystroke. This flag is honored by all page switching actions and by .B up-or-previous() / .BR down-or-next() , -although the latter only honor the horizontal postion, not the vertical one. +although the latter only honor the horizontal position, not the vertical one. This allows for a "continuous" scrolling back an forth through a document with a display window narrower than a page width. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" @@ -936,7 +936,7 @@ is no appropriate instance of already running. This argument makes it run in the foreground instead. This is useful for debugging, or if your client application cannot deal well with -a program self-backgrounding itself in this way -- e.g., the IPC functions +a program self-backgrounding itself in this way -- e.g. the IPC functions in .B emacs are known to have problems with this. @@ -1118,7 +1118,7 @@ As mentioned in the section .B DESCRIPTION above, xdvi will create a temporary copy of the DVI file so that it can be accessed without interruptions even while the file is being -rewritten by +rewritten by .BR TeX . Since this introduces the overhead of copying the file every time it has changed, the @@ -1320,7 +1320,7 @@ argument, and the PDF output file as second argument. .TP .BI \-rulecolor " color" .RB ( .ruleColor ) -Determines the color of the rules used for the the magnifier +Determines the color of the rules used for the magnifier (default: foreground color). .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" .TP @@ -1472,7 +1472,7 @@ should not be needed since the encoding is determined from the locale settings. .B \-thorough .RB ( .thorough ) .B Xdvi -will usually try to ensure that overstrike characters (e.g., +will usually try to ensure that overstrike characters (e.g.\& .BR \enotin ) are printed correctly. On monochrome displays, this is always possible with one logical operation, either @@ -1649,7 +1649,7 @@ next page if a number is given). Synonyms are and Line Feed. .TP .BR Backspace " key" -.RB [ back-pagee() ] +.RB [ back-page() ] Moves to the previous page (or back .I n pages). Synonyms are @@ -1923,7 +1923,7 @@ option. .sp If given a numeric argument that is not 0 or 1, greyscale anti-aliasing is turned on, and the gamma resource is set to the value divided by -100. E.g., +100. E.g.\& .RB ` 150G ' turns on greyscale and sets gamma to 1.5. .\""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""""" @@ -2049,7 +2049,7 @@ Return, and Line Feed. .TP .B Ctrl-o .RB [ select-dvi-file() ] -Read a new +Read a new .I dvi file. A file-selection widget is popped up for you to choose the DVI file from. If a prefix argument @@ -2394,7 +2394,7 @@ the mouse button is released. Moving the mouse cursor while holding the button d magnifier. .br Different mouse buttons produce different sized -windows, as indicated by the +windows, as indicated by the argument of the .I magnifier() action. Its argument is either a string of the form @@ -2463,7 +2463,7 @@ this is mostly for touchpads, trackpads, etc. .B text-selection() This action allows you to mark a rectangular region of text in the DVI file. The text is put into the X selection buffer and can be pasted into other -applictions (e.g. text editors). This works similar to the Plain text option +applications (e.g. text editors). This works similar to the Plain text option in the .B Save dialog; see the discussion there for more information on encoding issues. @@ -2586,7 +2586,7 @@ indicating that the action should toggle regardless of the current prefix argume .PP Mouse actions should refer only to .B ButtonPress -events (e.g., +events (e.g.\& .BR "<Btn1Down>:magnifier(*1)" ). The corresponding motion and release events will be handled internally. A key action may be bound to a mouse event, but not vice versa. @@ -2878,7 +2878,7 @@ scanned text. Such text will usually cause multi-page matching to fail. This emphasizes the fact that searching in the formatted text (the DVI output) works differently from searching in the source text: Searching in the DVI file makes it easier to -skip formatting instructions, and makes it possible to search for e.g. +skip formatting instructions, and makes it possible to search for e.g.\& hyphenation and equation numbers; but sometimes the formatting results can also get in the way, e.g. in the case of footnotes. In these cases it's better to search in the \*(Te\& source @@ -3085,7 +3085,7 @@ of the print dialog: .B dvipsPrinterString .TP .B dvipsOptionsString -These can be used to provide default entries for the +These can be used to provide default entries for the .B Printer and the .B Dvips options @@ -3094,7 +3094,7 @@ text fields, respectively. If no paper size is specified in the DVI file the input field is initialized with the current value of the command line option/X resource .BR paper . -E.g., the option +E.g. the option .I -paper a4r is translated into the dvips options .IR "-t a4 -t landscape" . @@ -3138,7 +3138,7 @@ to convert the PostScript file to PDF). Plain text in ISO-8859-1 or UTF-8 encoding. The latter will preserve more of the special LaTeX characters e.g. from mathematical mode. Note however that e.g. only few of LaTeX's mathematical symbols can be rendered correctly -as text; so this funcionality works best for plain text documents. +as text; so this functionality works best for plain text documents. If a character cannot be displayed in the selected charset, it is replaced by `\e' followed by the hexadecimal character code. If a character is not recognized at all, it is replaced by `?'. @@ -3325,7 +3325,7 @@ This means that each icon should be a square, and that the entire pixmap should have width \fIn\fR x \fIh\fR if \fIh\fR is the height of the pixmap. .PP -The resource +The resource .B toolbarTranslations can be used to map icons/buttons to specific actions. The resource should contain a string separated by newline characters, @@ -3613,7 +3613,7 @@ each page must be in one of the first two forms, since defaults are not inherited across pages. .sp You will need a \*(Te\& implementation that provides an appropriate -switch (e.g. +switch (e.g.\& .IR -src ) or a macro package (such as @@ -3689,12 +3689,12 @@ or If an asterisk .RB ( * ) appears just before the width, then the measurements refer to the document -dimensions (e.g., +dimensions (e.g.\& .B pt as opposed to .BR truept ). This allows a macro package to vary the page size according to elements -of the document; e.g., +of the document; e.g.\& .RS 5 .ft 3 .nf @@ -3933,14 +3933,14 @@ $HOME/.mailcap:/etc/mailcap:/usr/etc/mailcap:\e .fi .RE .br -For security reasons, some special characters (i.e.: ( ) ` \e ;) +For security reasons, some special characters (i.e. ( ) ` \e ;) are escaped in the argument before passing it to .BR system() . .RE .TP .SB BROWSER -Determines the web browser used to open external links (i.e., all URLs that don't -start with the +Determines the web browser used to open external links (i.e. all URLs +that don't start with the .RI ` file: ' scheme and are not relative links in the local DVI file), and to open links for which no viewer has been specified in the @@ -4159,4 +4159,3 @@ Please report all bugs to the SourceForge bug tracker: .nf .B http://sourceforge.net/tracker/?func=add&group_id=23164&atid=377580 .PP - diff --git a/Master/texmf-dist/doc/man/man1/xdvi.man1.pdf b/Master/texmf-dist/doc/man/man1/xdvi.man1.pdf Binary files differindex b75cb5e2eae..f907778a513 100644 --- a/Master/texmf-dist/doc/man/man1/xdvi.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/xdvi.man1.pdf diff --git a/Master/texmf-dist/doc/man/man1/xdvipdfmx.man1.pdf b/Master/texmf-dist/doc/man/man1/xdvipdfmx.man1.pdf Binary files differindex 687b84447ea..e5a048d2429 100644 --- a/Master/texmf-dist/doc/man/man1/xdvipdfmx.man1.pdf +++ b/Master/texmf-dist/doc/man/man1/xdvipdfmx.man1.pdf diff --git a/Master/texmf-dist/doc/man/man5/fmtutil.cnf.man5.pdf b/Master/texmf-dist/doc/man/man5/fmtutil.cnf.man5.pdf Binary files differindex f744a79c027..24ecbeb3120 100644 --- a/Master/texmf-dist/doc/man/man5/fmtutil.cnf.man5.pdf +++ b/Master/texmf-dist/doc/man/man5/fmtutil.cnf.man5.pdf diff --git a/Master/texmf-dist/doc/man/man5/synctex.5 b/Master/texmf-dist/doc/man/man5/synctex.5 index 0ada3af96b4..4ec12f39ef3 100644 --- a/Master/texmf-dist/doc/man/man5/synctex.5 +++ b/Master/texmf-dist/doc/man/man5/synctex.5 @@ -1,6 +1,6 @@ -.Dd Apr 22, 2017 +.Dd Jan 17, 2018 .Dt SYNCTEX 5 -.Os "Independant" +.Os "Independent" .\" .\" .Sh NAME @@ -316,7 +316,7 @@ It allows to append some transformation (shift and magnify). Typically, one applies a dvi to pdf filter with offset options and magnification, then he appends the same options to the synctex file, for example .Bd -literal -offset indent - synctex update -o foo.pdf -m 0.486 -x 9472573sp -y 13.3dd source.dvi +synctex update -o foo.pdf -m 0.486 -x 9472573sp -y 13.3dd source.dvi .Ed .Bl -item -offset indent .\" @@ -366,9 +366,9 @@ with useful suggestions by some well known actors of the TeX world. This document has been updated on Sat Apr 22 09:57:20 UTC 2017 to include \\pdfxform support. .\" nroff -man synctex.5 | less .\"groff -man -Tascii synctex.5 | less -.\"To convert a man page to plain pre-formatted text (e.g for spell checking) use: +.\"To convert a man page to plain pre-formatted text (e.g. for spell checking) use: .\"nroff -man synctex.5 | col -b > synctex.5.txt -.\"To convert it to Postscript (for printing or further conversion to pdf) use: +.\"To convert it to PostScript (for printing or further conversion to pdf) use: .\"groff -man -Tps synctex.5 > synctex.5.ps .\"To convert the man page to html use: .\"man2html synctex.5 diff --git a/Master/texmf-dist/doc/man/man5/synctex.man5.pdf b/Master/texmf-dist/doc/man/man5/synctex.man5.pdf Binary files differindex bf2ec2aceb4..bff1e22249a 100644 --- a/Master/texmf-dist/doc/man/man5/synctex.man5.pdf +++ b/Master/texmf-dist/doc/man/man5/synctex.man5.pdf diff --git a/Master/texmf-dist/doc/man/man5/updmap.cfg.man5.pdf b/Master/texmf-dist/doc/man/man5/updmap.cfg.man5.pdf Binary files differindex d1df6cd9716..c94d6434873 100644 --- a/Master/texmf-dist/doc/man/man5/updmap.cfg.man5.pdf +++ b/Master/texmf-dist/doc/man/man5/updmap.cfg.man5.pdf diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html index a190b650f10..235be54d030 100644 --- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html +++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.html @@ -2,7 +2,7 @@ <html> <!-- This file documents the TeX Live build system and more. -Copyright (C) 2016-2017 Karl Berry. +Copyright (C) 2016-2018 Karl Berry. Copyright (C) 2013-2015 Karl Berry & Peter Breitenlohner. @@ -20,16 +20,16 @@ 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 approved by the TeX Users Group. --> -<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> -<title>Building TeX Live (2017)</title> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> +<title>Building TeX Live (2018)</title> -<meta name="description" content="Building TeX Live (2017)"> -<meta name="keywords" content="Building TeX Live (2017)"> +<meta name="description" content="Building TeX Live (2018)"> +<meta name="keywords" content="Building TeX Live (2018)"> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> @@ -66,7 +66,7 @@ ul.no-bullet {list-style: none} </head> <body lang="en"> -<h1 class="settitle" align="center">Building TeX Live (2017)</h1> +<h1 class="settitle" align="center">Building TeX Live (2018)</h1> @@ -90,6 +90,7 @@ ul.no-bullet {list-style: none} <li><a name="stoc-Configure-options-1" href="#toc-Configure-options-1">7 Configure options</a></li> <li><a name="stoc-Cross-compilation-1" href="#toc-Cross-compilation-1">8 Cross compilation</a></li> <li><a name="stoc-Coding-conventions-1" href="#toc-Coding-conventions-1">9 Coding conventions</a></li> +<li><a name="stoc-Continuous-integration-1" href="#toc-Continuous-integration-1">10 Continuous integration</a></li> <li><a name="stoc-install_002dtl-1" href="#toc-install_002dtl-1">Appendix A install-tl</a></li> <li><a name="stoc-tlmgr-1" href="#toc-tlmgr-1">Appendix B tlmgr</a></li> <li><a name="stoc-Index-1" href="#toc-Index-1">Index</a></li> @@ -146,7 +147,7 @@ ul.no-bullet {list-style: none} <li><a name="toc-The-xdvik-package-in-texk_002fxdvik" href="#xdvik-package">6.5.3 The <code>xdvik</code> package in <samp>texk/xdvik</samp></a></li> <li><a name="toc-The-subdirectory-utils_002fasymptote" href="#asymptote">6.5.4 The subdirectory <samp>utils/asymptote</samp></a></li> </ul></li> - <li><a name="toc-Extending-TeX-Live-1" href="#Extending-TeX-Live">6.6 Extending TeX Live</a> + <li><a name="toc-Extending-TeX-Live-1" href="#Extending-TeX-Live">6.6 Extending TeX Live</a> <ul class="no-bullet"> <li><a name="toc-Adding-a-new-program-module-1" href="#Adding-a-new-program-module">6.6.1 Adding a new program module</a></li> <li><a name="toc-Adding-a-new-generic-library-module-1" href="#Adding-a-new-generic-library-module">6.6.2 Adding a new generic library module</a></li> @@ -199,6 +200,7 @@ ul.no-bullet {list-style: none} <li><a name="toc-Declarations-and-definitions-1" href="#Declarations-and-definitions">9.1 Declarations and definitions</a></li> <li><a name="toc-Const-1" href="#Const">9.2 Const</a></li> </ul></li> + <li><a name="toc-Continuous-integration-1" href="#Continuous-integration">10 Continuous integration</a></li> <li><a name="toc-install_002dtl-1" href="#install_002dtl">Appendix A install-tl</a> <ul class="no-bullet"> <li><a name="toc-NAME" href="#install_002dtl-NAME">A.1 NAME</a></li> @@ -293,17 +295,17 @@ ul.no-bullet {list-style: none} <p> Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a href="http://tug.org/texinfohtml" accesskey="u" rel="up">(dir)</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> -<a name="Building-TeX-Live-_00282017_0029"></a> -<h1 class="top">Building TeX Live (2017)</h1> +<a name="Building-TeX-Live-_00282018_0029"></a> +<h1 class="top">Building TeX Live (2018)</h1> <p>For an overview of this manual, see <a href="#Introduction">Introduction</a>. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a>:</td><td> </td><td align="left" valign="top">About this manual. </td></tr> -<tr><td align="left" valign="top">• <a href="#Overview-of-build-system" accesskey="2">Overview of build system</a>:</td><td> </td><td align="left" valign="top">The TeX Live build system. +<tr><td align="left" valign="top">• <a href="#Overview-of-build-system" accesskey="2">Overview of build system</a>:</td><td> </td><td align="left" valign="top">The TeX Live build system. </td></tr> -<tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="3">Prerequisites</a>:</td><td> </td><td align="left" valign="top">Requirements for building TeX Live. +<tr><td align="left" valign="top">• <a href="#Prerequisites" accesskey="3">Prerequisites</a>:</td><td> </td><td align="left" valign="top">Requirements for building TeX Live. </td></tr> <tr><td align="left" valign="top">• <a href="#Building" accesskey="4">Building</a>:</td><td> </td><td align="left" valign="top">The overall build process. </td></tr> @@ -317,9 +319,11 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a </td></tr> <tr><td align="left" valign="top">• <a href="#Coding-conventions" accesskey="9">Coding conventions</a>:</td><td> </td><td align="left" valign="top">Conventions to follow. </td></tr> -<tr><td align="left" valign="top">• <a href="#install_002dtl">install-tl</a>:</td><td> </td><td align="left" valign="top">The TeX Live installer. +<tr><td align="left" valign="top">• <a href="#Continuous-integration">Continuous integration</a>:</td><td> </td><td align="left" valign="top">Automated build testing. +</td></tr> +<tr><td align="left" valign="top">• <a href="#install_002dtl">install-tl</a>:</td><td> </td><td align="left" valign="top">The TeX Live installer. </td></tr> -<tr><td align="left" valign="top">• <a href="#tlmgr">tlmgr</a>:</td><td> </td><td align="left" valign="top">The native TeX Live package manager. +<tr><td align="left" valign="top">• <a href="#tlmgr">tlmgr</a>:</td><td> </td><td align="left" valign="top">The native TeX Live package manager. </td></tr> <tr><td align="left" valign="top">• <a href="#Index">Index</a>:</td><td> </td><td align="left" valign="top">General index. </td></tr> @@ -337,11 +341,11 @@ Next: <a href="#Overview-of-build-system" accesskey="n" rel="next">Overview of b <a name="index-introduction"></a> -<p>This manual (dated April 2017) corresponds to the TeX Live -2017 release. +<p>This manual (dated February 2018) corresponds to the TeX Live +2018 release. </p> <p>This manual is aimed at system installers and programmers, and focuses -on how to configure, build, and develop the TeX Live (TL) sources. It is +on how to configure, build, and develop the TeX Live (TL) sources. It is also available as plain text files in the source tree: <samp>source/README.*</samp>. </p> @@ -353,16 +357,16 @@ information for different systems, along with <p>For information on acquiring the TL sources, see <a href="http://tug.org/texlive/svn">http://tug.org/texlive/svn</a>. </p> -<p>This manual does not duplicate the (primarily user-level) information -found in other TL documentation resources, such as: +<p>This manual does not duplicate the information found in other TL +documentation resources, such as: </p> <ul> -<li> The TeX Live web pages: <a href="http://tug.org/texlive">http://tug.org/texlive</a>. +<li> The TeX Live web pages: <a href="http://tug.org/texlive">http://tug.org/texlive</a>. -</li><li> The web page with an overview of how to build the binaries which -are distributed with TeX Live: <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a>. +</li><li> The web page describing how to build the binaries which +are distributed with TeX Live: <a href="http://tug.org/texlive/build.html">http://tug.org/texlive/build.html</a>. -</li><li> The TeX Live user manual: <a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>, or +</li><li> The TeX Live user manual: <a href="http://tug.org/texlive/doc.html">http://tug.org/texlive/doc.html</a>, or run <code>texdoc texlive</code>. </li><li> Other TeX-related Texinfo manuals (see <cite><a href="http://tug.org/texinfohtml/web2c.html#Top">Web2c</a></cite>, @@ -399,7 +403,7 @@ Next: <a href="#Prerequisites" accesskey="n" rel="next">Prerequisites</a>, Previ <a name="index-Automake"></a> <a name="index-Libtool"></a> <a name="index-tests_002c-running"></a> -<p>The TeX Live build system was redesigned in 2009, consistently using +<p>The TeX Live build system was redesigned in 2009, consistently using Autoconf, Automake, and Libtool. Thus<br> <code>configure && make && make check && make install</code><br>or the basically-equivalent top-level <code>Build</code> script suffice to build and install the TL @@ -466,7 +470,7 @@ Next: <a href="#Building" accesskey="n" rel="next">Building</a>, Previous: <a hr <a name="index-requirements-for-building"></a> <a name="index-compilers_002c-C-and-C_002b_002b"></a> -<p>Overall, building the TeX Live programs, when using all libraries from +<p>Overall, building the TeX Live programs, when using all libraries from the TL source tree, requires only C and C++ compilers and GNU <code>make</code>. (If <code>make</code> from your <code>PATH</code> is not GNU make, you can set <code>MAKE</code> in the environment to whatever is necessary.) @@ -568,7 +572,7 @@ Next: <a href="#Installing" accesskey="n" rel="next">Installing</a>, Previous: < <a name="index-Build-script"></a> <p>The top-level <samp>Build</samp> script is intended to simplify building the -binaries distributed with TeX Live itself—we call this the “native” +binaries distributed with TeX Live itself—we call this the “native” TL build. It configures and makes everything in a subdirectory of the main build tree (default <samp>Work/</samp>), installs everything in another subdirectory (default <samp>inst/</samp>), and finally runs <code>make @@ -729,7 +733,7 @@ library and causes to first build any required libraries. </p> <p>This “build-on-demand” procedure is used, e.g., in the upstream LuaTeX repository to build LuaTeX, essentially from a subset of -the complete TeX Live tree. Similarly, when, e.g., building the original +the complete TeX Live tree. Similarly, when, e.g., building the original e-TeX has been disabled (as it is by default), one can run <code>make etex</code> (or <code>make etex.exe</code>) in <samp>texk/web2c/</samp> to build e-TeX (although there is no comparably simple way to install @@ -827,8 +831,8 @@ make a usable TeX installation. Beyond the compiled binaries, </p> <p>These support files are maintained completely independently and are not present in the source tree. The best basis for dealing with them -is the TeX Live (plain text) database in -<samp>Master/tlpkg/texlive.tlpdb</samp>, and/or the TeX Live installer, +is the TeX Live (plain text) database in +<samp>Master/tlpkg/texlive.tlpdb</samp>, and/or the TeX Live installer, <code>install-tl</code>. More information is under <samp>Master/tlpkg</samp> and at <a href="http://tug.org/texlive/distro.html">http://tug.org/texlive/distro.html</a>. </p> @@ -1050,7 +1054,7 @@ Next: <a href="#Configure-options" accesskey="n" rel="next">Configure options</a <a name="index-layout-of-sources"></a> <a name="index-source-tree"></a> -<p>The TeX Live source tree is the subtree rooted at <samp>Build/source</samp> of +<p>The TeX Live source tree is the subtree rooted at <samp>Build/source</samp> of the complete TL distribution and contains the sources for all executables distributed by TL, as well as <code>configure</code> scripts and <code>make</code> rules to build and install them together with some of their support @@ -1067,7 +1071,7 @@ files. </td></tr> <tr><td align="left" valign="top">• <a href="#Program-modules" accesskey="5">Program modules</a>:</td><td> </td><td align="left" valign="top">Handling programs, with examples. </td></tr> -<tr><td align="left" valign="top">• <a href="#Extending-TeX-Live" accesskey="6">Extending TeX Live</a>:</td><td> </td><td align="left" valign="top">Adding a new module. +<tr><td align="left" valign="top">• <a href="#Extending-TeX-Live" accesskey="6">Extending TeX Live</a>:</td><td> </td><td align="left" valign="top">Adding a new module. </td></tr> </table> @@ -1086,7 +1090,7 @@ Next: <a href="#Top_002dlevel-directories" accesskey="n" rel="next">Top-level di <a name="index-infrastructure_002c-tools-needed-for"></a> <p>As mentioned above (see <a href="#Prerequisites">Prerequisites</a>), a normal build requires -very little. On the other hand, if you want to modify the TeX Live +very little. On the other hand, if you want to modify the TeX Live infrastructure sources, such as <samp>configure.ac</samp> or <samp>Makefile.am</samp> files, you will need to have several additional tools installed. @@ -1103,12 +1107,12 @@ may be. </p> <div class="display"> <pre class="display">autoconf (GNU Autoconf) 2.69 -automake (GNU automake) 1.15 +automake (GNU automake) 1.15.1 bison (GNU Bison) 3.0.4 flex 2.6.0 ltmain.sh (GNU libtool) 2.4.6 m4 (GNU M4) 1.4.18 -makeinfo (GNU texinfo) 6.1 +makeinfo (GNU texinfo) 6.5 </pre></div> <a name="index-reautoconf"></a> @@ -1151,7 +1155,7 @@ Next: <a href="#Autoconf-macros" accesskey="n" rel="next">Autoconf macros</a>, P <a name="index-directories_002c-top_002dlevel"></a> <a name="index-top_002dlevel-directories"></a> -<p>Here is a brief description of the top-level directories in the TeX Live +<p>Here is a brief description of the top-level directories in the TeX Live source tree. </p> <p>As mentioned at the beginning of see <a href="#Overview-of-build-system">Overview of build system</a>, the main source directories are <samp>texk/</samp> @@ -1403,7 +1407,7 @@ that provides make variables for that library. E.g., for <dt><a name="index-KPSE_005fLIBPNG_005fFLAGS"></a>Macro: <strong>KPSE_LIBPNG_FLAGS</strong></dt> <dd><p>Provide the configure option <code>--with-system-libpng</code>. Set and <code>AC_SUBST</code> <code>make</code> variables for modules using this library (either -an installed version or from the TeX Live tree): <code>LIBPNG_INCLUDES</code> for use +an installed version or from the TeX Live tree): <code>LIBPNG_INCLUDES</code> for use in <code>CPPFLAGS</code>, <code>LIBPNG_LIBS</code> for use in <code>LDADD</code>, <code>LIBPNG_DEPEND</code> for use as dependency, and <code>LIBPNG_RULE</code> defining <code>make</code> rules to rebuild the library. @@ -1562,7 +1566,7 @@ Next: <a href="#zlib-library" accesskey="n" rel="next"><code>zlib</code> library <p>specifying the module name, and indicating the dependency on <code>zlib</code>. A third literal argument <code>tree</code> would specify that -the library from the TeX Live tree cannot be replaced by a system +the library from the TeX Live tree cannot be replaced by a system version. That not being the case here, a second fragment <samp>ac/libpng.ac</samp> contains </p> @@ -1666,7 +1670,7 @@ Previous: <a href="#freetype-library" accesskey="p" rel="prev"><code>freetype</c <a name="index-kpathsea-library"></a> <p>This is one of the TeX-specific libraries that are maintained as -part of TeX Live (see <cite><a href="http://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>). Despite being a core +part of TeX Live (see <cite><a href="http://tug.org/texinfohtml/kpathsea.html#Top">Kpathsea</a></cite>). Despite being a core part of the TeX system, it is not a terribly special case in the infrastructure. The TeX libraries are Libtool libraries (static and/or shared) and are installed by <code>make install</code> together with @@ -1697,7 +1701,7 @@ however, the command line options <code>-mktex=tfm</code> or <a name="Program-modules"></a> <div class="header"> <p> -Next: <a href="#Extending-TeX-Live" accesskey="n" rel="next">Extending TeX Live</a>, Previous: <a href="#Library-modules" accesskey="p" rel="prev">Library modules</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Extending-TeX-Live" accesskey="n" rel="next">Extending TeX Live</a>, Previous: <a href="#Library-modules" accesskey="p" rel="prev">Library modules</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Program-modules-1"></a> <h3 class="section">6.5 Program modules</h3> @@ -1789,7 +1793,7 @@ Next: <a href="#asymptote" accesskey="n" rel="next"><code>asymptote</code></a>, <a name="index-xdvik"></a> -<p>This package is maintained as part of the TeX Live tree with sources in +<p>This package is maintained as part of the TeX Live tree with sources in its top level directory and the subdirectory <samp>gui</samp>. The fragment <code>ac/withenable.ac</code> contains </p> @@ -1842,7 +1846,7 @@ their support files. Previous: <a href="#Program-modules" accesskey="p" rel="prev">Program modules</a>, Up: <a href="#Layout-and-infrastructure" accesskey="u" rel="up">Layout and infrastructure</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Extending-TeX-Live-1"></a> -<h3 class="section">6.6 Extending TeX Live</h3> +<h3 class="section">6.6 Extending TeX Live</h3> <a name="index-extending-TeX-Live"></a> <a name="index-adding-to-TeX-Live"></a> @@ -1872,7 +1876,7 @@ addition, <samp>foo/</samp> will need the usual Automake build-related files <a name="Adding-a-new-program-module"></a> <div class="header"> <p> -Next: <a href="#Adding-a-new-generic-library-module" accesskey="n" rel="next">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Adding-a-new-generic-library-module" accesskey="n" rel="next">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Adding-a-new-program-module-1"></a> <h4 class="subsection">6.6.1 Adding a new program module</h4> @@ -1894,10 +1898,9 @@ its name <samp><var>prog</var></samp> to the M4 list <code>kpse_utils_pkgs</code </p> <a name="index-withenable_002eac_002c-for-new-modules"></a> <a name="index-KPSE_005fENABLE_005fPROG"></a> -<p>In either case, apart from the program sources and build system -(<samp>configure.ac</samp> and <samp>Makefile.am</samp>), the subdirectory -<samp>texk/<var>prog</var></samp> or <samp>utils/<var>prog</var></samp> must provide a -fragment <samp>ac/withenable.ac</samp> that contains the M4 macro +<p>In either case, the subdirectory <samp>texk/<var>prog</var></samp> or +<samp>utils/<var>prog</var></samp> must provide a fragment +<samp>ac/withenable.ac</samp> that contains the M4 macro <code>KPSE_ENABLE_PROG</code> defined in <samp>m4/kpse-setup.m4</samp> with <code><var>prog</var></code> as the mandatory first argument and three optional arguments: @@ -1910,21 +1913,76 @@ built without the configure option <code>--enable-<var>prog</var></code>, <code>native</code> if cross compilation is not possible, <code>x</code> if the program requires X11 libraries); -</li><li> and a comment added to the help text for the <code>configure</code> +</li><li> a comment added to the help text for the <code>configure</code> option <code>--enable-<var>prog</var></code> or <code>--disable-<var>prog</var></code>. </li></ol> <p>If the module requires specific configure options to be seen at the -top-level, they should be defined in an additional fragment +top level, they should be defined in an additional fragment <samp>ac/<var>prog</var>.ac</samp> included from <samp>ac/withenable.ac</samp> and <samp>configure.ac</samp>. </p> +<p>Usually, the new program is maintained somewhere outside of TeX Live. In +that case, we put the upstream sources into a subdirectory +<samp><var>prog</var>-src</samp> (e.g., <samp>utils/newprog/newprog-src</samp>). We do +not run <code>configure</code> in this original <code>...-src</code> directory, +only in our own directory, but we do compile using the source files in +<code>...-src</code>. +</p> +<p>So, these are the files that we must generally create: +</p> +<dl compact="compact"> +<dt><samp>ac/withenable.ac</samp></dt> +<dd><p>The <code>KPSE_ENABLE_PROG</code> call just explained. +</p> +</dd> +<dt><samp>configure.ac</samp></dt> +<dt><samp>Makefile.am</samp></dt> +<dd><p>By merging the contents of the original <samp>configure.ac</samp> (if +provided) and a comparable program already in TL. There is no magic +recipe, it’s necessary to think about needs to be done in the original +vs. in TeX Live. +</p> +</dd> +<dt><samp>TLpatches/TL-Changes</samp></dt> +<dd><p>Actions taken after getting the original source tree; typically +removal of derived or unused common files. +</p> +</dd> +<dt><samp>TLpatches/patch-...</samp></dt> +<dd><p>If any changes are needed to the original sources, record the patches +here so they can be applied next time. And send them upstream so that +perhaps they won’t have to be. +</p> +</dd> +<dt><samp>ChangeLog</samp></dt> +<dd><p>Record all TL-specific changes, now and in the future. +</p> +</dd> +</dl> + +<p>Then, run GNU <code>autoreconf</code> in the new directory (see <a href="#Build-system-tools">Build system tools</a>). After that works, <code>svn add</code> the necessary files, +notably <samp>Makefile.in aclocal.m4 configure</samp>, and <code>svn:ignore</code> +the Automake cache <samp>autom4te.cache</samp>. (This is so people checking +out the TL source tree do not have to run any autotools, but can +simply run <code>configure</code>.) +</p> +<p>Then, run the TL tool <code>reautoconf</code> in the top-level TL +<code>source/</code> directory, to incorporate the new program into the +build tree. +</p> +<p>Then, run (and rerun) a build until the program compiles and tests +successfully, probably involving rerunning autoreconf in the source +directory, <code>make</code> in the build directory, etc. +</p> +<p>After final success, don’t forget to commit. +</p> <hr> <a name="Adding-a-new-generic-library-module"></a> <div class="header"> <p> -Next: <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="n" rel="next">Adding a new TeX-specific library module</a>, Previous: <a href="#Adding-a-new-program-module" accesskey="p" rel="prev">Adding a new program module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="n" rel="next">Adding a new TeX-specific library module</a>, Previous: <a href="#Adding-a-new-program-module" accesskey="p" rel="prev">Adding a new program module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Adding-a-new-generic-library-module-1"></a> <h4 class="subsection">6.6.2 Adding a new generic library module</h4> @@ -1938,7 +1996,7 @@ Next: <a href="#Adding-a-new-TeX_002dspecific-library-module" accesskey="n" rel= not depend on TeX-specific libraries, by definition. It is included by adding its name <samp><var>lib</var></samp> to the M4 list <code>kpse_libs_pkgs</code> in <samp>m4/kpse-pkgs.m4</samp>—before any other -libraries from the TeX Live tree on which it depends. +libraries from the TeX Live tree on which it depends. </p> <a name="index-KPSE_005fWITH_005fLIB"></a> <p>As with program modules, the subdirectory <samp>libs/<var>lib</var></samp> must @@ -1985,7 +2043,7 @@ definition of the M4 macro <code>KPSE_ALL_SYSTEM_FLAGS</code> in <a name="Adding-a-new-TeX_002dspecific-library-module"></a> <div class="header"> <p> -Previous: <a href="#Adding-a-new-generic-library-module" accesskey="p" rel="prev">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Previous: <a href="#Adding-a-new-generic-library-module" accesskey="p" rel="prev">Adding a new generic library module</a>, Up: <a href="#Extending-TeX-Live" accesskey="u" rel="up">Extending TeX Live</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Adding-a-new-TeX_002dspecific-library-module-1"></a> <h4 class="subsection">6.6.3 Adding a new TeX-specific library module</h4> @@ -2031,10 +2089,10 @@ top-level. </p> <a name="index-environment-variables_002c-for-configure"></a> <p>The help text also mentions several influential environment variables, -but for TeX Live it is better to specify them as assigments on the +but for TeX Live it is better to specify them as assigments on the command line. </p> -<p>The <samp>./Build</samp> script used to make the binaries shipped with TeX Live +<p>The <samp>./Build</samp> script used to make the binaries shipped with TeX Live invokes the top-level <code>configure</code> with a few additional options (see <a href="#Building">Building</a>). The defaults discussed below are those for the actual <code>configure</code> script; invoking <code>configure</code> via @@ -2487,7 +2545,7 @@ support for Metafont (EPSF output, <code>mftalk</code>, old terminals, …) <a name="index-synctex"></a> <p><code>--enable-tex-synctex</code>, <code>--disable-etex-synctex</code>, …<br>Build the TeX engines with or without <code>SyncTeX</code> -support; ignored for a native TeX Live build, defaults are again defined +support; ignored for a native TeX Live build, defaults are again defined in <samp>texk/web2c/ac/web2c.ac</samp>. </p> <a name="index-_002d_002ddisable_002dsynctex"></a> @@ -2755,7 +2813,7 @@ Previous: <a href="#Configure-options-for-kpathsea" accesskey="p" rel="prev">Con <p>Building LuaTeX (or LuaJITTeX) and XeTeX requires <code>poppler</code>, either from the TL tree or system headers and library. Building pdfTeX requires either <code>xpdf</code> from -the TeX Live tree or system <code>poppler</code> headers and library. +the TeX Live tree or system <code>poppler</code> headers and library. </p> <a name="index-_002d_002dwith_002dsystem_002dpoppler"></a> <p><code>--with-system-poppler</code><br>Use a system version (0.18 or @@ -3036,7 +3094,7 @@ binary, thus cross compilation is not possible. <a name="Coding-conventions"></a> <div class="header"> <p> -Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Cross-compilation" accesskey="p" rel="prev">Cross compilation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#Continuous-integration" accesskey="n" rel="next">Continuous integration</a>, Previous: <a href="#Cross-compilation" accesskey="p" rel="prev">Cross compilation</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="Coding-conventions-1"></a> <h2 class="chapter">9 Coding conventions</h2> @@ -3044,12 +3102,12 @@ Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previou <a name="index-coding-conventions"></a> <a name="index-conventions_002c-coding"></a> -<p>Ideally, building all of TeX Live with <code>--enable-compiler-warnings=max</code> +<p>Ideally, building all of TeX Live with <code>--enable-compiler-warnings=max</code> should produce no (GCC) compiler warnings at all. In spite of considerable efforts into that direction we are still far from that goal and there are reasons that we may never fully reach it. Below are some rules about declarations of functions or variables and the use of <code>const</code>. -These rules should be applied to most of the TeX Live tree, the exception +These rules should be applied to most of the TeX Live tree, the exception being code that is maintained independently and whose maintainers don’t want to accept patches. </p> @@ -3079,7 +3137,7 @@ Next: <a href="#Const" accesskey="n" rel="next">Const</a>, Up: <a href="#Coding- <a name="C-standards"></a> <h4 class="subsubheading">C standards</h4> -<p>The TeX Live build system no longer supports pre-ANSI C compilers. Thus +<p>The TeX Live build system no longer supports pre-ANSI C compilers. Thus all function prototypes and definitions must conform to the ANSI C standard (including <code>void</code> in the declaration of C functions with no parameters). On the other hand, TL is built for a wide variety of @@ -3194,11 +3252,107 @@ them. Therefore such casts should be avoided whenever possible and otherwise must be carefully analyzed to make sure that they cannot cause the modification of quantities supposed to be constant. </p> + +<hr> +<a name="Continuous-integration"></a> +<div class="header"> +<p> +Next: <a href="#install_002dtl" accesskey="n" rel="next">install-tl</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +</div> +<a name="Continuous-integration-1"></a> +<h2 class="chapter">10 Continuous integration</h2> + +<a name="index-ci"></a> +<a name="index-continuous-integration"></a> +<a name="index-Travis_002dCI"></a> + +<p>Overview: the sources of TeX Live are subjected to continuous integration +testing on Travis-CI +(<a href="https://travis-ci.org/TeX-Live/texlive-source">https://travis-ci.org/TeX-Live/texlive-source</a>) via a git-svn +mirror of the sources that is pushed to Github +(<a href="https://github.com/TeX-Live/texlive-source">https://github.com/TeX-Live/texlive-source</a>). The git-svn mirror +is updated (currently) at 30 minute intervals, and only the last +commit pushed is tested on Travis-CI. +</p> +<a name="Transfer-from-Subversion-to-Github"></a> +<h4 class="subheading">Transfer from Subversion to Github</h4> + +<p>git-svn (<a href="https://git-scm.com/docs/git-svn">https://git-scm.com/docs/git-svn</a>) is used to check out +the subtree <code>Build/source</code> of the Subversion repository. The +author index file used is not maintained in either Git or Subversion +but can be provided on request. +</p> + +<p>The initial checkout was done by invoking +</p><div class="example"> +<pre class="example">git svn --authors-file usermap clone svn://USER@tug.org/texlive/trunk/Build/source +</pre></div> + +<p>where the <code>usermap</code> file maps Subversion user names to +name and emails of the authors. If no user account at <a href="tug.org">tug.org</a> is +available, anonymous checkout is possible, too: +</p><div class="example"> +<pre class="example">git svn --authors-file usermap clone svn://tug.org/texlive/trunk/Build/source +</pre></div> + +<p>In the following, we will use <em>admin</em> to refer to a user who has +read/write access to the TeX Live subversion repository, and is also an +administrator of the <code>TeX-Live</code> Team on Github. The above initial +checkout has been carried out by <em>admin</em> on the server +<code>texlive.info</code>. +</p> +<p>On Github (<a href="https://github.com">https://github.com</a>), a new git repository named +<code>texlive-source</code> was created by <em>admin</em> within the +<code>TeX-Live</code> “organization” (<a href="https://github.com/TeX-Live">https://github.com/TeX-Live</a>). +The remote was added to the checkout with <code>git remote add origin +git@github.com:TeX-Live/texlive-source.git</code>. +</p> +<p>To automate the update on Github, a new ssh key was generated and added +to the <code>texlive-source</code> repository on Github as deployment +key. This way pushes using this key can only go to the +<code>texlive-source</code> repository and not anywhere else. +</p> +<p>The usage of <code>git-svn</code> requires a strict discipline to keep a +linear history in the master branch. Since we are aiming at a pure +mirror facility, we have decided to further restrict the <code>master</code> +branch of the <code>texlive-source</code> repository on Github to changes by +<em>admin</em>. +</p> +<p>This setup allows other developers to branch off <code>master</code> and +push their branches to the Github repository, but all updates need to +come from the local <code>master</code> (not the one on Github) to +Subversion, back to <code>master</code> on <code>texlive.info</code>, and from +there to Github. +</p> +<a name="Automatic-update-of-the-Git-mirror"></a> +<h4 class="subheading">Automatic update of the Git mirror</h4> + +<p><em>admin</em> has installed a cron job on <code>texlive.info</code> running +every 30 minute which essentially runs <code>git svn rebase</code> and +<code>git push</code> in the <code>master</code> branch of the checkout. The first +command fetches the changes from the Subversion repository and updates +the <code>master</code> branch with them, the second one pushes changes (if +available) to Github. +</p> +<a name="CI-testing-on-Travis_002dCI"></a> +<h4 class="subheading">CI testing on Travis-CI</h4> + +<a name="index-_002etravis_002eyml"></a> +<p>The <code>source</code> tree of TeX Live contains a top-level file +<code>.travis.yml</code> which controls the automatic testing on +Travis-CI. <em>admin</em> has registered to Travis-CI and allowed access +to the Github’s <code>TeX-Live</code> organization’s <code>texlive-source</code> +repository. The default settings are to build the last commit of each +push. No further action is necessary on Travis-CI. +</p> +<p>If changes have been pushed via the cron job above, Travis-CI will +automatically checkout the last pushed commit and try building it. +</p> <hr> <a name="install_002dtl"></a> <div class="header"> <p> -Next: <a href="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#Coding-conventions" accesskey="p" rel="prev">Coding conventions</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> +Next: <a href="#tlmgr" accesskey="n" rel="next">tlmgr</a>, Previous: <a href="#Continuous-integration" accesskey="p" rel="prev">Continuous integration</a>, Up: <a href="#Top" accesskey="u" rel="up">Top</a> [<a href="#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="#Index" title="Index" rel="index">Index</a>]</p> </div> <a name="install_002dtl-1"></a> <h2 class="appendix">Appendix A install-tl</h2> @@ -6101,6 +6255,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a> +<a class="summary-letter" href="#Index_cp_symbol-2"><b>.</b></a> + <br> <a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a> @@ -6217,12 +6373,15 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-_002dC-configure-option"><code>-C configure <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr> <tr><td></td><td valign="top"><a href="#index-_002dj-make-option"><code>-j make <span class="roman">option</span></code></a>:</td><td> </td><td valign="top"><a href="#Build-in-parallel">Build in parallel</a></td></tr> <tr><td colspan="4"> <hr></td></tr> +<tr><th><a name="Index_cp_symbol-2">.</a></th><td></td><td></td></tr> +<tr><td></td><td valign="top"><a href="#index-_002etravis_002eyml"><code>.travis.yml</code></a>:</td><td> </td><td valign="top"><a href="#Continuous-integration">Continuous integration</a></td></tr> +<tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_letter-A">A</a></th><td></td><td></td></tr> -<tr><td></td><td valign="top"><a href="#index-adapting-TeX-Live-for-distros">adapting TeX Live for distros</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-adapting-TeX-Live-for-distros">adapting TeX Live for distros</a>:</td><td> </td><td valign="top"><a href="#Distro-builds">Distro builds</a></td></tr> <tr><td></td><td valign="top"><a href="#index-adding-a-new-generic-library">adding a new generic library</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-generic-library-module">Adding a new generic library module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-adding-a-new-program">adding a new program</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-program-module">Adding a new program module</a></td></tr> <tr><td></td><td valign="top"><a href="#index-adding-a-new-TeX_002dspecific-library">adding a new TeX-specific library</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-TeX_002dspecific-library-module">Adding a new TeX-specific library module</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-adding-to-TeX-Live">adding to TeX Live</a>:</td><td> </td><td valign="top"><a href="#Extending-TeX-Live">Extending TeX Live</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-adding-to-TeX-Live">adding to TeX Live</a>:</td><td> </td><td valign="top"><a href="#Extending-TeX-Live">Extending TeX Live</a></td></tr> <tr><td></td><td valign="top"><a href="#index-am_002f-top_002dlevel-directory"><samp>am/</samp> top-level directory</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ANSI-C">ANSI C</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-ApplicationServices-Mac-framework_002c-required-by-xetex"><code>ApplicationServices</code> Mac framework, required by <code>xetex</code></a>:</td><td> </td><td valign="top"><a href="#Prerequisites">Prerequisites</a></td></tr> @@ -6262,6 +6421,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-CC_003dc_002dcompiler"><code>CC=<var>c-compiler</var></code></a>:</td><td> </td><td valign="top"><a href="#Build-one-package">Build one package</a></td></tr> <tr><td></td><td valign="top"><a href="#index-CC_005fBUILD"><code>CC_BUILD</code></a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-chktex"><code>chktex</code></a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-ci">ci</a>:</td><td> </td><td valign="top"><a href="#Continuous-integration">Continuous integration</a></td></tr> <tr><td></td><td valign="top"><a href="#index-clisp"><code>clisp</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-CLISP-1"><code>CLISP</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-CLISP">CLISP</a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-utils_002fxindy">Configure options for <samp>utils/xindy</samp></a></td></tr> @@ -6286,6 +6446,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-configure-variables"><code>configure</code> variables</a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-configuring_002c-for-cross-compilation">configuring, for cross compilation</a>:</td><td> </td><td valign="top"><a href="#Cross-configuring">Cross configuring</a></td></tr> <tr><td></td><td valign="top"><a href="#index-const"><code>const</code></a>:</td><td> </td><td valign="top"><a href="#Const">Const</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-continuous-integration">continuous integration</a>:</td><td> </td><td valign="top"><a href="#Continuous-integration">Continuous integration</a></td></tr> <tr><td></td><td valign="top"><a href="#index-conventions_002c-coding">conventions, coding</a>:</td><td> </td><td valign="top"><a href="#Coding-conventions">Coding conventions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-CPPFLAGS"><code>CPPFLAGS</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-cross-compilation">cross compilation</a>:</td><td> </td><td valign="top"><a href="#Cross-compilation">Cross compilation</a></td></tr> @@ -6314,7 +6475,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><th><a name="Index_cp_letter-E">E</a></th><td></td><td></td></tr> <tr><td></td><td valign="top"><a href="#index-environment-variables_002c-for-configure">environment variables, for <code>configure</code></a>:</td><td> </td><td valign="top"><a href="#Configure-options">Configure options</a></td></tr> <tr><td></td><td valign="top"><a href="#index-exec_005fprefix"><code>exec_prefix</code></a>:</td><td> </td><td valign="top"><a href="#g_t_002d_002denable_002dmultiplatform"><code>--enable-multiplatform</code></a></td></tr> -<tr><td></td><td valign="top"><a href="#index-extending-TeX-Live">extending TeX Live</a>:</td><td> </td><td valign="top"><a href="#Extending-TeX-Live">Extending TeX Live</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-extending-TeX-Live">extending TeX Live</a>:</td><td> </td><td valign="top"><a href="#Extending-TeX-Live">Extending TeX Live</a></td></tr> <tr><td></td><td valign="top"><a href="#index-extern-functions"><code>extern</code> functions</a>:</td><td> </td><td valign="top"><a href="#Declarations-and-definitions">Declarations and definitions</a></td></tr> <tr><td></td><td valign="top"><a href="#index-extra_002f-top_002dlevel-directory"><samp>extra/</samp> top-level directory</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr> <tr><td colspan="4"> <hr></td></tr> @@ -6347,7 +6508,7 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-ICU_005fCONFIG"><code>ICU_CONFIG</code></a>:</td><td> </td><td valign="top"><a href="#Variables-for-configure">Variables for configure</a></td></tr> <tr><td></td><td valign="top"><a href="#index-infrastructure_002c-tools-needed-for">infrastructure, tools needed for</a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr> <tr><td></td><td valign="top"><a href="#index-inst_002f-top_002dlevel-directory"><samp>inst/</samp> top-level directory</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-install_002dtl_002c-TeX-Live-installer"><code>install-tl<span class="roman">, TeX Live installer</span></code></a>:</td><td> </td><td valign="top"><a href="#Installing">Installing</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-install_002dtl_002c-TeX-Live-installer"><code>install-tl<span class="roman">, TeX Live installer</span></code></a>:</td><td> </td><td valign="top"><a href="#Installing">Installing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-installation-directories">installation directories</a>:</td><td> </td><td valign="top"><a href="#Installation-directories">Installation directories</a></td></tr> <tr><td></td><td valign="top"><a href="#index-installing">installing</a>:</td><td> </td><td valign="top"><a href="#Installing">Installing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-interprocess-communication">interprocess communication</a>:</td><td> </td><td valign="top"><a href="#Configure-options-for-texk_002fweb2c">Configure options for <samp>texk/web2c</samp></a></td></tr> @@ -6505,12 +6666,13 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top <tr><td></td><td valign="top"><a href="#index-tangle"><code>tangle</code></a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tests_002c-running">tests, running</a>:</td><td> </td><td valign="top"><a href="#Overview-of-build-system">Overview of build system</a></td></tr> <tr><td></td><td valign="top"><a href="#index-TeX_002dspecific-library-module_002c-adding">TeX-specific library module, adding</a>:</td><td> </td><td valign="top"><a href="#Adding-a-new-TeX_002dspecific-library-module">Adding a new TeX-specific library module</a></td></tr> -<tr><td></td><td valign="top"><a href="#index-texlive_002etlpdb_002c-TeX-Live-database"><code>texlive.tlpdb<span class="roman">, TeX Live database</span></code></a>:</td><td> </td><td valign="top"><a href="#Installing">Installing</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-texlive_002etlpdb_002c-TeX-Live-database"><code>texlive.tlpdb<span class="roman">, TeX Live database</span></code></a>:</td><td> </td><td valign="top"><a href="#Installing">Installing</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tie"><code>tie</code></a>:</td><td> </td><td valign="top"><a href="#Cross-problems">Cross problems</a></td></tr> <tr><td></td><td valign="top"><a href="#index-timestamps_002c-in-repository">timestamps, in repository</a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr> <tr><td></td><td valign="top"><a href="#index-tools_002c-for-building">tools, for building</a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr> <tr><td></td><td valign="top"><a href="#index-top_002dlevel-directories">top-level directories</a>:</td><td> </td><td valign="top"><a href="#Top_002dlevel-directories">Top-level directories</a></td></tr> <tr><td></td><td valign="top"><a href="#index-touching-files-to-avoid-rerunning">touching files to avoid rerunning</a>:</td><td> </td><td valign="top"><a href="#Build-system-tools">Build system tools</a></td></tr> +<tr><td></td><td valign="top"><a href="#index-Travis_002dCI">Travis-CI</a>:</td><td> </td><td valign="top"><a href="#Continuous-integration">Continuous integration</a></td></tr> <tr><td></td><td valign="top"><a href="#index-type-cast_002c-avoiding">type cast, avoiding</a>:</td><td> </td><td valign="top"><a href="#Const">Const</a></td></tr> <tr><td colspan="4"> <hr></td></tr> <tr><th><a name="Index_cp_letter-U">U</a></th><td></td><td></td></tr> @@ -6558,6 +6720,8 @@ Previous: <a href="#tlmgr" accesskey="p" rel="prev">tlmgr</a>, Up: <a href="#Top </table> <table><tr><th valign="top">Jump to: </th><td><a class="summary-letter" href="#Index_cp_symbol-1"><b>-</b></a> +<a class="summary-letter" href="#Index_cp_symbol-2"><b>.</b></a> + <br> <a class="summary-letter" href="#Index_cp_letter-A"><b>A</b></a> diff --git a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf Binary files differindex deb65132568..30645fa70b5 100644 --- a/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf +++ b/Master/texmf-dist/doc/texlive/tlbuild/tlbuild.pdf diff --git a/Master/texmf-dist/doc/web2c/web2c.html b/Master/texmf-dist/doc/web2c/web2c.html index 92ae15eedf9..3149ec75a91 100644 --- a/Master/texmf-dist/doc/web2c/web2c.html +++ b/Master/texmf-dist/doc/web2c/web2c.html @@ -19,8 +19,9 @@ 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 --> -<!-- Created by GNU Texinfo 6.3, http://www.gnu.org/software/texinfo/ --> +<!-- Created by GNU Texinfo 6.5, http://www.gnu.org/software/texinfo/ --> <head> +<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <title>Web2c: A TeX implementation</title> <meta name="description" content="Web2c: A TeX implementation"> @@ -28,7 +29,6 @@ except that this permission notice may be stated in a translation --> <meta name="resource-type" content="document"> <meta name="distribution" content="global"> <meta name="Generator" content="makeinfo"> -<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> <link href="#Top" rel="start" title="Top"> <link href="#Index" rel="index" title="Index"> <link href="#SEC_Contents" rel="contents" title="Table of Contents"> @@ -192,8 +192,8 @@ Next: <a href="#Introduction" accesskey="n" rel="next">Introduction</a>, Up: <a <p>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 2017, released in -April 2017. +corresponds to Web2c version 2018, released in +February 2018. </p> <table class="menu" border="0" cellspacing="0"> <tr><td align="left" valign="top">• <a href="#Introduction" accesskey="1">Introduction</a>:</td><td> </td><td align="left" valign="top">A brief introduction. @@ -236,8 +236,8 @@ Next: <a href="#Installation" accesskey="n" rel="next">Installation</a>, Previou <a name="index-introduction"></a> -<p>This manual corresponds to version 2017 of Web2c, released in -April 2017. +<p>This manual corresponds to version 2018 of Web2c, released in +February 2018. </p> <a name="index-Knuth_002c-Donald-E_002e"></a> <a name="index-TeX_002c-Web2c-implementation-of"></a> @@ -3454,10 +3454,15 @@ entry <var>e</var> via their <code>crossref</code> field, include <var>e</var> i <tt>.bbl</tt> file, even if it was not explicitly referenced in the <tt>.aux</tt> file. For example, <var>e</var> might be a conference proceedings as a whole, with the cross-referencing entries being individual articles published -in the proceedings. In some circumstances, you may want to avoid these -automatic inclusions altogether; to do this, make <var>n</var> a sufficiently -large number. -</p></dd> +in the proceedings. +</p> +<p>If you want to avoid these automatic inclusions altogether, make +<var>n</var> a sufficiently large number, and be sure to remove any +previous <tt>.aux</tt> and <tt>.bbl</tt> files. Otherwise the option may +appear to have no effect, since BibTeX will have added the citation +for <var>e</var> to the <tt>.aux</tt>, and nothing will remove it. +</p> +</dd> </dl> <p>See also: diff --git a/Master/texmf-dist/doc/web2c/web2c.pdf b/Master/texmf-dist/doc/web2c/web2c.pdf Binary files differindex 794518ff8b6..44bcec0f34e 100644 --- a/Master/texmf-dist/doc/web2c/web2c.pdf +++ b/Master/texmf-dist/doc/web2c/web2c.pdf |