diff options
Diffstat (limited to 'Build/source/texk/kpathsea/doc/kpathsea.info')
| -rw-r--r-- | Build/source/texk/kpathsea/doc/kpathsea.info | 220 |
1 files changed, 108 insertions, 112 deletions
diff --git a/Build/source/texk/kpathsea/doc/kpathsea.info b/Build/source/texk/kpathsea/doc/kpathsea.info index 17f236f6646..db52773a1da 100644 --- a/Build/source/texk/kpathsea/doc/kpathsea.info +++ b/Build/source/texk/kpathsea/doc/kpathsea.info @@ -1,9 +1,9 @@ -This is kpathsea.info, produced by makeinfo version 6.7 from +This is kpathsea.info, produced by makeinfo version 5.1 from kpathsea.texi. This file documents the Kpathsea library for path searching. - Copyright (C) 1996-2019 Karl Berry & Olaf Weber. + Copyright (C) 1996-2020 Karl Berry & Olaf Weber. Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are @@ -37,7 +37,7 @@ Kpathsea library **************** This manual documents the Kpathsea library for path searching. It -corresponds to version 6.3.2, released in December 2019. +corresponds to version 6.3.2, released in January 2020. * Menu: @@ -62,7 +62,7 @@ File: kpathsea.info, Node: Introduction, Next: unixtex.ftp, Prev: Top, Up: T ************** This manual corresponds to version 6.3.2 of the Kpathsea library, -released in December 2019. +released in January 2020. 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,7 +80,7 @@ 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>), which includes several more Kpathsea-using +(<https://tug.org/texlive>), which includes several more Kpathsea-using programs. For information on configuration, building, installing, and more, *note (tlbuild)::. @@ -95,7 +95,7 @@ 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>. +<https://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 @@ -291,8 +291,8 @@ This section describes the default installation hierarchy of the 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 <http://www.gnu.org/prep/standards>. The TDS document is available -from <http://www.mirror.ctan.org/tds> (*note unixtex.ftp::). +from <https://gnu.org/prep/standards>. The TDS document is available +from <http://mirror.ctan.org/tds> (*note unixtex.ftp::). In short, here is a skeleton of the default directory structure, extracted from the TDS document: @@ -970,7 +970,7 @@ steps: 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>. +you can get GNU Find from <https://gnu.org/software/findutils>. The casefolding search is implemented in the source file 'kpathsea/pathsearch.c'. Two implementation points: @@ -1651,14 +1651,14 @@ Auxiliary tasks::). 'bltxml' (BibLaTeXML bibliography files for Biber, - <http://ctan.org/pkg/biber>) 'BLTXMLINPUTS' suffix '.bltxml'. + <https://ctan.org/pkg/biber>) 'BLTXMLINPUTS' suffix '.bltxml'. 'bst' (BibTeX style, *note Basic BibTeX style files: (web2c)Basic BibTeX style files.) 'BSTINPUTS'; suffix '.bst'. 'clua' - (dynamic libraries for Lua, <http://ctan.org/pkg/luatex>) + (dynamic libraries for Lua, <https://ctan.org/pkg/luatex>) 'CLUAINPUTS' suffixes '.dll' and '.so'. 'cmap' @@ -1790,7 +1790,7 @@ Auxiliary tasks::). 'ris' (RIS bibliography files, primarily for Biber, - <http://ctan.org/pkg/biber>) 'RISINPUTS' suffix '.ris'. + <https://ctan.org/pkg/biber>) 'RISINPUTS' suffix '.ris'. 'subfont definition files' (subfont definition files) 'SFDFONTS' suffix '.sfd'. @@ -2523,7 +2523,7 @@ library.) different systems. You will almost certainly want to use Autoconf and probably Automake for configuring and building your software if you use Kpathsea; I strongly recommend using Autoconf and Automake regardless. -They are available from <http://www.gnu.org/software>. +They are available from <https://gnu.org/software>. File: kpathsea.info, Node: Program-specific files, Next: Programming with config files, Prev: Calling sequence, Up: Programming @@ -2663,7 +2663,7 @@ investigation, your report should include the following: * If the bug involved is an actual crash (i.e., core dump), it is easy and useful to include a stack trace from a debugger (I - recommend the GNU debugger GDB (<http://www.gnu.org/software/gdb>). + recommend the GNU debugger GDB (<https://gnu.org/software/gdb>). If the cause is apparent (a 'NULL' value being dereferenced, for example), please send the details along. If the program involved is TeX or Metafont, and the crash is happening at apparently-sound @@ -2682,7 +2682,7 @@ File: kpathsea.info, Node: Mailing lists, Next: Debugging, Prev: Bug checklis Web2c and Kpathsea in general are discussed on the mailing list <tex-k@tug.org>. You can subscribe and peruse the archives on the web -<http://lists.tug.org/tex-k>. +<https://lists.tug.org/tex-k>. You do not need to join to submit a report, nor will it affect whether you get a response. Be aware that large data files are @@ -2691,7 +2691,7 @@ join the list. If you are looking for general TeX help, such as how to install a full TeX system or how to use LaTeX, please see -<http://tug.org/begin.html>. +<https://tug.org/begin.html>. File: kpathsea.info, Node: Debugging, Next: Logging, Prev: Mailing lists, Up: Reporting bugs @@ -2978,7 +2978,7 @@ configuration file: the wrong device, most likely 'mktexpk''s built-in guess for the mode is wrong, and you should override it as above. - See <http://ctan.org/pkg/modes> for a list of resolutions and mode + See <https://ctan.org/pkg/modes> for a list of resolutions and mode names for most devices (additional submissions are welcome). If Metafont runs but generates fonts at a resolution of 2602dpi (and @@ -3037,7 +3037,7 @@ Index * !! and casefolding: Casefolding examples. (line 57) * !! in path specifications: ls-R. (line 57) -* !! in TEXMFDBS: ls-R. (line 11) +* !! in 'TEXMFDBS': ls-R. (line 11) * $ expansion: Variable expansion. (line 6) * --all: Path searching options. (line 12) @@ -3045,7 +3045,7 @@ Index (line 19) * --cnf-line: Path searching options. (line 28) -* --cnf-line, source for path: Path sources. (line 9) +* '--cnf-line', source for path: Path sources. (line 9) * --color=tty: ls-R. (line 25) * --debug=NUM: Auxiliary tasks. (line 9) * --dpi=NUM: Path searching options. @@ -3091,12 +3091,12 @@ Index * --without-mktexpk-default: mktex configuration. (line 12) * --without-mktextfm-default: mktex configuration. (line 12) * -1 debugging value: Debugging. (line 23) -* -A option to ls: ls-R. (line 39) +* -A option to 'ls': ls-R. (line 39) * -D NUM: Path searching options. (line 49) * -iname, find predicate: Casefolding examples. (line 78) -* -L option to ls: ls-R. (line 44) +* -L option to 'ls': ls-R. (line 44) * . directories, ignored: ls-R. (line 39) * . files: ls-R. (line 39) * .2602gf: Unable to generate fonts. @@ -3173,7 +3173,7 @@ Index (line 195) * .pro: Supported file formats. (line 169) -* .PROGNAME qualifier in texmf.cnf: Config files. (line 50) +* .PROGNAME qualifier in 'texmf.cnf': Config files. (line 50) * .rhosts, writable by TeX: Security. (line 10) * .ris: Supported file formats. (line 173) @@ -3183,7 +3183,7 @@ Index (line 42) * .tex: Supported file formats. (line 180) -* .tex file, included in ls-R: ls-R. (line 39) +* .tex file, included in 'ls-R': ls-R. (line 39) * .tfm: Supported file formats. (line 199) * .ttc: Supported file formats. @@ -3211,9 +3211,9 @@ Index * 8.3 filenames, using: mktex configuration. (line 68) * : 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) -* \, line continuation in texmf.cnf: Config files. (line 37) +* ; translated to ':' in 'texmf.cnf': Config files. (line 66) +* = omitted in 'texmf.cnf' and misparsing: Config files. (line 93) +* \, line continuation in 'texmf.cnf': Config files. (line 37) * \openin: Searching overview. (line 31) * \special, suppressing warnings about: Suppressing warnings. (line 31) @@ -3236,15 +3236,15 @@ Index * announcement mailing list: Mailing lists. (line 6) * API, re-entrant: Programming overview. (line 16) -* append-only directories and mktexpk: Security. (line 36) +* 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. +* arguments to 'mktex': mktex script arguments. (line 6) * argv[0]: Calling sequence. (line 14) * autoconf, recommended: Calling sequence. (line 117) -* automounter, and ls-R: ls-R. (line 46) +* automounter, and 'ls-R': ls-R. (line 46) * auxiliary tasks: Auxiliary tasks. (line 6) * Bach, Johann Sebastian: Default expansion. (line 41) * backslash-newline: Config files. (line 37) @@ -3254,7 +3254,7 @@ Index (line 30) * BIBINPUTS <1>: Supported file formats. (line 121) -* blank lines, in texmf.cnf: Config files. (line 35) +* blank lines, in 'texmf.cnf': Config files. (line 35) * BLTXMLINPUTS: Supported file formats. (line 34) * brace expansion: Brace expansion. (line 6) @@ -3282,7 +3282,7 @@ Index * checksum: Suppressing warnings. (line 16) * circle fonts: Fontmap. (line 19) -* client_path in kpse->format_info: Calling sequence. (line 47) +* client_path in 'kpse->format_info': Calling sequence. (line 47) * CLUAINPUTS: Supported file formats. (line 42) * CMAPFONTS: Supported file formats. @@ -3293,7 +3293,7 @@ Index * cnf.h: Programming with config files. (line 27) * comments, in fontmap files: Fontmap. (line 27) -* comments, in texmf.cnf: Config files. (line 27) +* comments, in 'texmf.cnf': Config files. (line 27) * comments, making: Introduction. (line 29) * common features in glyph lookup: Basic glyph lookup. (line 6) * common problems: Common problems. (line 6) @@ -3319,8 +3319,9 @@ Index * 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) +* configuration of 'mktex' scripts: mktex configuration. (line 6) +* 'configure' options for 'mktex' scripts: mktex configuration. + (line 12) * context diff: Bug checklist. (line 52) * continuation character: Config files. (line 37) * core dumps, reporting: Bug checklist. (line 58) @@ -3344,7 +3345,7 @@ Index * directory permissions: Security. (line 51) * directory structure, for TeX files: TeX directory structure. (line 6) -* disabling mktex scripts: mktex configuration. (line 6) +* disabling 'mktex' scripts: mktex configuration. (line 6) * disk search: Searching overview. (line 22) * disk searching, avoiding: ls-R. (line 57) * disk usage, reducing: Logging. (line 6) @@ -3371,7 +3372,7 @@ Index (line 41) * elt-dirs.c <1>: Subdirectory expansion. (line 48) -* enabling mktex scripts: mktex configuration. (line 6) +* enabling 'mktex' scripts: mktex configuration. (line 6) * ENCFONTS: Supported file formats. (line 61) * engine name: Path searching options. @@ -3400,7 +3401,7 @@ Index * extensions, filename: File lookup. (line 24) * externally-built filename database: Filename database. (line 6) * extra colons: Default expansion. (line 6) -* failed mktex... script invocation: mktex script names. (line 35) +* failed 'mktex...' script invocation: mktex script names. (line 35) * fallback font: Fallback font. (line 6) * fallback resolutions: Fallback font. (line 6) * FAQ, Kpathsea: Common problems. (line 6) @@ -3486,7 +3487,7 @@ Index (line 151) * interface, not frozen: Introduction. (line 29) * introduction: Introduction. (line 6) -* kdebug:: Debugging. (line 105) +* '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 19) @@ -3589,9 +3590,9 @@ Index (line 20) * mkocp: mktex script names. (line 18) * mkofm: mktex script names. (line 21) -* mktex script configuration: mktex configuration. (line 6) -* mktex script names: mktex script names. (line 6) -* mktex scripts: mktex scripts. (line 6) +* 'mktex' script configuration: mktex configuration. (line 6) +* 'mktex' script names: mktex script names. (line 6) +* 'mktex' scripts: mktex scripts. (line 6) * mktex.cnf: Specially-recognized files. (line 28) * mktex.cnf <1>: mktex configuration. (line 29) @@ -3601,7 +3602,7 @@ Index * mktexfmt: mktex script names. (line 10) * mktexmf: mktex script names. (line 15) * mktexpk: mktex script names. (line 24) -* mktexpk can't guess mode: Unable to generate fonts. +* 'mktexpk' can't guess mode: Unable to generate fonts. (line 12) * mktextex: mktex script names. (line 27) * mktextfm: mktex script names. (line 30) @@ -3622,9 +3623,9 @@ Index * MT_FEATURES: mktex configuration. (line 39) * multiple TeX hierarchies: Brace expansion. (line 20) * must exist: Searching overview. (line 31) -* names for mktex scripts: mktex script names. (line 6) +* names for 'mktex' scripts: mktex script names. (line 6) * Neumann, Gustaf: History. (line 56) -* NFS and ls-R: ls-R. (line 46) +* NFS and 'ls-R': ls-R. (line 46) * nomfdrivers: mktex configuration. (line 92) * nomode: mktex configuration. (line 97) * none: Suppressing warnings. @@ -3737,7 +3738,7 @@ Index * shell variables: Variable expansion. (line 17) * shell_escape, example for code: Programming with config files. (line 10) -* site overrides for mktex...: mktex configuration. (line 29) +* site overrides for 'mktex...': mktex configuration. (line 29) * skeleton TeX directory: TeX directory structure. (line 6) * slow startup time: Slow path searching. (line 6) @@ -3772,7 +3773,7 @@ Index (line 6) * symbolic links not found: Unable to find files. (line 21) -* symbolic links, and ls-R: ls-R. (line 44) +* symbolic links, and 'ls-R': ls-R. (line 44) * symlinks, resolving: Calling sequence. (line 31) * system C compiler bugs: TeX or Metafont failing. (line 16) @@ -3838,7 +3839,7 @@ Index (line 6) * texmf.cnf: Specially-recognized files. (line 38) -* texmf.cnf missing, warning about: Config files. (line 18) +* 'texmf.cnf' missing, warning about: Config files. (line 18) * texmf.cnf, and variable expansion: Variable expansion. (line 6) * texmf.cnf, definition for: Config files. (line 6) * texmf.cnf, source for path: Path sources. (line 20) @@ -3883,7 +3884,7 @@ Index * tilde.c: Tilde expansion. (line 25) * time system call: Logging. (line 15) * tolerance for glyph lookup: Basic glyph lookup. (line 15) -* trailing / in home directory: Tilde expansion. (line 19) +* trailing '/' in home directory: Tilde expansion. (line 19) * trailing colons: Default expansion. (line 6) * translations, of path searching description: Path searching. (line 10) @@ -3909,7 +3910,7 @@ Index * unreadable file warnings: Suppressing warnings. (line 27) * unreadable files: Searching overview. (line 63) -* unusable ls-R warning: ls-R. (line 51) +* unusable 'ls-R' warning: ls-R. (line 51) * usage patterns, finding: Logging. (line 6) * USERPROFILE, as ~ expansion: Tilde expansion. (line 6) * USE_TEXMFVAR: mktex configuration. (line 128) @@ -3927,8 +3928,8 @@ Index (line 219) * Vojta, Paul: History. (line 30) * Walsh, Norman: History. (line 56) -* warning about unusable ls-R: ls-R. (line 51) -* warning, about missing texmf.cnf: Config files. (line 18) +* warning about unusable 'ls-R': ls-R. (line 51) +* warning, about missing 'texmf.cnf': Config files. (line 18) * warnings, file access: Searching overview. (line 63) * warnings, suppressing: Suppressing warnings. (line 6) @@ -3955,66 +3956,61 @@ Index Tag Table: Node: Top1480 -Node: Introduction2263 -Node: History4336 -Node: unixtex.ftp8932 -Node: Security10357 -Node: TeX directory structure12861 -Node: Path searching16909 -Node: Searching overview17867 -Node: Path sources21686 -Node: Config files22912 -Node: Path expansion28175 -Node: Default expansion29128 -Node: Variable expansion31198 -Node: Tilde expansion32599 -Node: Brace expansion33579 -Node: KPSE_DOT expansion34518 -Node: Subdirectory expansion35031 -Node: Casefolding search37379 -Node: Casefolding rationale38148 -Node: Casefolding examples39487 -Node: Filename database44537 -Node: ls-R45519 -Node: Filename aliases49195 -Node: Database format50373 -Node: Invoking kpsewhich51386 -Node: Path searching options52341 -Node: Specially-recognized files61939 -Node: Auxiliary tasks63294 -Node: Standard options67019 -Node: TeX support67375 -Node: Supported file formats68729 -Node: File lookup76394 -Node: Glyph lookup78143 -Node: Basic glyph lookup79267 -Node: Fontmap80147 -Node: Fallback font82676 -Node: Suppressing warnings83588 -Node: mktex scripts84715 -Node: mktex configuration85930 -Node: mktex script names91733 -Node: mktex script arguments93119 -Node: Programming93998 -Node: Programming overview94571 -Node: Calling sequence97432 -Node: Program-specific files103964 -Node: Programming with config files104987 -Node: Reporting bugs106574 -Node: Bug checklist107252 -Node: Mailing lists110724 -Node: Debugging111399 -Node: Logging116476 -Node: Common problems118343 -Node: Unable to find files118820 -Node: Slow path searching121230 -Node: Unable to generate fonts122605 -Node: TeX or Metafont failing125076 -Node: Index126278 +Node: Introduction2262 +Node: History4331 +Node: unixtex.ftp8927 +Node: Security10352 +Node: TeX directory structure12856 +Node: Path searching16897 +Node: Searching overview17855 +Node: Path sources21674 +Node: Config files22900 +Node: Path expansion28163 +Node: Default expansion29116 +Node: Variable expansion31186 +Node: Tilde expansion32587 +Node: Brace expansion33567 +Node: KPSE_DOT expansion34506 +Node: Subdirectory expansion35019 +Node: Casefolding search37367 +Node: Casefolding rationale38136 +Node: Casefolding examples39475 +Node: Filename database44521 +Node: ls-R45503 +Node: Filename aliases49179 +Node: Database format50357 +Node: Invoking kpsewhich51370 +Node: Path searching options52325 +Node: Specially-recognized files61923 +Node: Auxiliary tasks63278 +Node: Standard options67003 +Node: TeX support67359 +Node: Supported file formats68713 +Node: File lookup76381 +Node: Glyph lookup78130 +Node: Basic glyph lookup79254 +Node: Fontmap80134 +Node: Fallback font82663 +Node: Suppressing warnings83575 +Node: mktex scripts84702 +Node: mktex configuration85917 +Node: mktex script names91720 +Node: mktex script arguments93106 +Node: Programming93985 +Node: Programming overview94558 +Node: Calling sequence97419 +Node: Program-specific files103948 +Node: Programming with config files104971 +Node: Reporting bugs106558 +Node: Bug checklist107236 +Node: Mailing lists110705 +Node: Debugging111382 +Node: Logging116459 +Node: Common problems118326 +Node: Unable to find files118803 +Node: Slow path searching121213 +Node: Unable to generate fonts122588 +Node: TeX or Metafont failing125060 +Node: Index126262 End Tag Table - - -Local Variables: -coding: utf-8 -End: |