diff options
Diffstat (limited to 'Master/texmf-dist/doc/info/kpathsea.info')
-rw-r--r-- | Master/texmf-dist/doc/info/kpathsea.info | 145 |
1 files changed, 68 insertions, 77 deletions
diff --git a/Master/texmf-dist/doc/info/kpathsea.info b/Master/texmf-dist/doc/info/kpathsea.info index 66b0a4e2f90..a9c122cad0c 100644 --- a/Master/texmf-dist/doc/info/kpathsea.info +++ b/Master/texmf-dist/doc/info/kpathsea.info @@ -3,7 +3,7 @@ kpathsea.texi. This file documents the Kpathsea library for path searching. - Copyright (C) 1996-2021 Karl Berry & Olaf Weber. + Copyright (C) 1996-2022 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -37,7 +37,7 @@ Kpathsea library **************** This manual documents the Kpathsea library for path searching. It -corresponds to version 6.3.3, released in February 2021. +corresponds to version 6.3.4, released in January 2022. * 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.3.3 of the Kpathsea library, -released in February 2021. +This manual corresponds to version 6.3.4 of the Kpathsea library, +released in January 2022. 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 @@ -293,7 +293,7 @@ distribution. It conforms to both the GNU coding standards and the TeX directory structure (TDS) standard. For rationale and further explanation, please see those documents. The GNU document is available from <https://gnu.org/prep/standards>. The TDS document is available -from <http://mirror.ctan.org/tds> (*note unixtex.ftp::). +from <https://ctan.org/pkg/tds> (*note unixtex.ftp::). In short, here is a skeleton of the default directory structure, extracted from the TDS document: @@ -526,10 +526,10 @@ character '0' (zero, not oh). helpful to look at the distributed 'texmf.cnf', which uses or at least mentions most features. The format of 'texmf.cnf' files follows: - * Comments start with '%', either at the beginning of a line or - preceded by whitespace, and continue to the end of the line. That - is, similar to most shells, a '%' in the "middle" of a value does - not start a comment. Examples: + * Comments start with '%' or '#', either at the beginning of a line + or preceded by whitespace, and continue to the end of the line. + That is, similar to most shells, a comment character in the + "middle" of a value does not start a comment. Examples: % this is a comment var = a%b % but the value of var will be "a%b" @@ -585,13 +585,6 @@ Here is a configuration file fragment illustrating most of these points: TEXINPUTS.latex2e = $latex2e_inputs TEXINPUTS.latex = $latex2e_inputs - This format has some similarity to Bourne shell scripts--change the -comment character to '#', disallow spaces around the '=', and get rid of -the '.NAME' convention, and it could be run through the shell. However, -there seemed little advantage in this, since all the information would -have to passed back to Kpathsea and parsed there anyway, since the 'sh' -process couldn't affect its parent's environment. - The combination of spaces being ignored before the '.' of a program name qualifer and the optional '=' for the assignment has an unexpected consequence: if the value begins with a literal '.' and the '=' is @@ -1996,7 +1989,7 @@ found are read; earlier definitions override later ones. equivalent, so that it no longer matters what the name of the installed file is; TeX documents will find their favorite name. - The format of fontmap files is straightforward: + The format of fontmap files: * Comments start with the last '%' on a line and continue to the end of the line. (This provides for names that include a %, @@ -3213,7 +3206,7 @@ Index * : may not be :: Searching overview. (line 13) * :: expansion: Default expansion. (line 6) * ; translated to ':' in 'texmf.cnf': Config files. (line 66) -* = omitted in 'texmf.cnf' and misparsing: Config files. (line 93) +* = omitted in 'texmf.cnf' and misparsing: Config files. (line 86) * \, line continuation in 'texmf.cnf': Config files. (line 37) * \openin: Searching overview. (line 31) * \special, suppressing warnings about: Suppressing warnings. @@ -3290,7 +3283,7 @@ Index (line 46) * cmr10, as fallback font: Fallback font. (line 15) * cmr10.vf: Searching overview. (line 31) -* cnf.c: Config files. (line 112) +* cnf.c: Config files. (line 105) * cnf.h: Programming with config files. (line 27) * comments, in fontmap files: Fontmap. (line 27) @@ -3319,7 +3312,6 @@ Index * config.status: Bug checklist. (line 27) * configuration bugs: Bug checklist. (line 27) * configuration file, source for path: Path sources. (line 20) -* configuration files as shell scripts.: Config files. (line 86) * configuration of 'mktex' scripts: mktex configuration. (line 6) * 'configure' options for 'mktex' scripts: mktex configuration. (line 12) @@ -3735,7 +3727,6 @@ Index * setgid scripts: Security. (line 40) * SFDFONTS: Supported file formats. (line 177) -* shell scripts as configuration files: Config files. (line 86) * shell variables: Variable expansion. (line 17) * shell_escape, example for code: Programming with config files. (line 10) @@ -3957,61 +3948,61 @@ Index Tag Table: Node: Top1480 -Node: Introduction2263 -Node: History4333 -Node: unixtex.ftp8929 -Node: Security10399 -Node: TeX directory structure12903 -Node: Path searching16944 -Node: Searching overview17902 -Node: Path sources21721 -Node: Config files22947 -Node: Path expansion28210 -Node: Default expansion29163 -Node: Variable expansion31233 -Node: Tilde expansion32634 -Node: Brace expansion33614 -Node: KPSE_DOT expansion34553 -Node: Subdirectory expansion35066 -Node: Casefolding search37414 -Node: Casefolding rationale38183 -Node: Casefolding examples39529 -Node: Filename database44575 -Node: ls-R45557 -Node: Filename aliases49233 -Node: Database format50411 -Node: Invoking kpsewhich51424 -Node: Path searching options52379 -Node: Specially-recognized files61977 -Node: Auxiliary tasks63332 -Node: Standard options67057 -Node: TeX support67413 -Node: Supported file formats68767 -Node: File lookup76435 -Node: Glyph lookup78184 -Node: Basic glyph lookup79308 -Node: Fontmap80188 -Node: Fallback font82717 -Node: Suppressing warnings83629 -Node: mktex scripts84756 -Node: mktex configuration85971 -Node: mktex script names91774 -Node: mktex script arguments93160 -Node: Programming94039 -Node: Programming overview94612 -Node: Calling sequence97473 -Node: Program-specific files104002 -Node: Programming with config files105025 -Node: Reporting bugs106612 -Node: Bug checklist107290 -Node: Mailing lists110759 -Node: Debugging111436 -Node: Logging116513 -Node: Common problems118380 -Node: Unable to find files118857 -Node: Slow path searching121267 -Node: Unable to generate fonts122642 -Node: TeX or Metafont failing125114 -Node: Index126316 +Node: Introduction2262 +Node: History4331 +Node: unixtex.ftp8927 +Node: Security10397 +Node: TeX directory structure12901 +Node: Path searching16940 +Node: Searching overview17898 +Node: Path sources21717 +Node: Config files22943 +Node: Path expansion27815 +Node: Default expansion28768 +Node: Variable expansion30838 +Node: Tilde expansion32239 +Node: Brace expansion33219 +Node: KPSE_DOT expansion34158 +Node: Subdirectory expansion34671 +Node: Casefolding search37019 +Node: Casefolding rationale37788 +Node: Casefolding examples39134 +Node: Filename database44180 +Node: ls-R45162 +Node: Filename aliases48838 +Node: Database format50016 +Node: Invoking kpsewhich51029 +Node: Path searching options51984 +Node: Specially-recognized files61582 +Node: Auxiliary tasks62937 +Node: Standard options66662 +Node: TeX support67018 +Node: Supported file formats68372 +Node: File lookup76040 +Node: Glyph lookup77789 +Node: Basic glyph lookup78913 +Node: Fontmap79793 +Node: Fallback font82303 +Node: Suppressing warnings83215 +Node: mktex scripts84342 +Node: mktex configuration85557 +Node: mktex script names91360 +Node: mktex script arguments92746 +Node: Programming93625 +Node: Programming overview94198 +Node: Calling sequence97059 +Node: Program-specific files103588 +Node: Programming with config files104611 +Node: Reporting bugs106198 +Node: Bug checklist106876 +Node: Mailing lists110345 +Node: Debugging111022 +Node: Logging116099 +Node: Common problems117966 +Node: Unable to find files118443 +Node: Slow path searching120853 +Node: Unable to generate fonts122228 +Node: TeX or Metafont failing124700 +Node: Index125902 End Tag Table |