diff options
Diffstat (limited to 'Build/source/texk/kpathsea/doc/kpathsea.info')
| -rw-r--r-- | Build/source/texk/kpathsea/doc/kpathsea.info | 214 |
1 files changed, 110 insertions, 104 deletions
diff --git a/Build/source/texk/kpathsea/doc/kpathsea.info b/Build/source/texk/kpathsea/doc/kpathsea.info index def0252034c..2d4571353de 100644 --- a/Build/source/texk/kpathsea/doc/kpathsea.info +++ b/Build/source/texk/kpathsea/doc/kpathsea.info @@ -40,7 +40,7 @@ Kpathsea library This manual documents how to install and use the Kpathsea library for filename lookup. It corresponds to version 6.0.0, released in -July 2010. +November 2010. * Menu: @@ -61,7 +61,7 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up: ************** This manual corresponds to version 6.0.0 of the Kpathsea library, -released in July 2010. +released in November 2010. The library's fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do @@ -1242,10 +1242,10 @@ Also available as `http://www.tug.org/unixtex.ftp'. Email <tex-k@tug.org> with comments or questions. The principal free TeX distribution for Unix-like systems is TeX -Live, `http://tug.org/texlive'. Its web pages describe many ways to -acquire 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. +Live, on the web at `http://tug.org/texlive'. The pages there describe +many ways to acquire 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 separate packages. Their sources are now maintained as part of TeX @@ -2018,7 +2018,13 @@ single 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 `%' and continue to the end of the line. + * Comments start with `%', either at the beginning of a line or + preceded by whitespace, and continue to the end of the line. That + is, as with most shells, a `%' 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". * Blank lines are ignored. @@ -2037,8 +2043,9 @@ mentions most features. The format of `texmf.cnf' files follows: * If `.PROGNAME' is present, the definition only applies if the program that is running is named (i.e., the last component of - `argv[0]' is) PROGNAME or `PROGNAME.exe'. This allows different - flavors of TeX to have different search paths, for example. + `argv[0]' is) PROGNAME or `PROGNAME.{exe,bat,cmd,...}'. Most + notably, this allows different flavors of TeX to have different + search paths. * VALUE may contain any characters except `%' and `@'. (These restrictions are only necessary because of the processing done on @@ -2047,7 +2054,7 @@ mentions most features. The format of `texmf.cnf' files follows: not available on the right-hand side; instead, you must use an additional variable (see below for example). A `;' in VALUE is translated to `:' if running under Unix; this is useful to write a - single `texmf.cnf' which can be used under both Unix and NT. + single `texmf.cnf' which can be used under both Unix and Windows. * All definitions are read before anything is expanded, so you can use variables before they are defined (like Make, unlike most other @@ -2063,13 +2070,12 @@ Here is a configuration file fragment illustrating most of these points: TEXINPUTS.latex2e = $latex2e_inputs TEXINPUTS.latex = $latex2e_inputs - Although this format has obvious similarities 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. But there seemed little advantage to doing 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. + This format has obvious similarities 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 implementation of all this is in `kpathsea/cnf.c'. @@ -3745,7 +3751,7 @@ Index * : may not be :: Searching overview. (line 13) * :: expansion: Default expansion. (line 6) * @VAR@ substitutions: Running configure. (line 6) -* \, line continuation in texmf.cnf: Config files. (line 31) +* \, line continuation in texmf.cnf: Config files. (line 37) * \openin: Searching overview. (line 31) * \special, suppressing warnings about: Suppressing warnings. (line 31) @@ -3789,13 +3795,13 @@ Index * Babel: Kpathsea application distributions. (line 28) * Bach, Johann Sebastian: Default expansion. (line 41) -* backslash-newline: Config files. (line 31) +* backslash-newline: Config files. (line 37) * bash, recommended for running configure: configure shells. (line 6) * basic glyph lookup: Basic glyph lookup. (line 6) * Berry, Karl: History. (line 12) * BIBINPUTS: Supported file formats. (line 28) -* blank lines, in texmf.cnf: Config files. (line 29) +* blank lines, in texmf.cnf: Config files. (line 35) * brace expansion: Brace expansion. (line 6) * BSD universe: Running make. (line 44) * bsh, ok with configure: configure shells. (line 14) @@ -3830,7 +3836,7 @@ Index (line 36) * cmr10, as fallback font: Fallback font. (line 15) * cmr10.vf: Searching overview. (line 31) -* cnf.c: Config files. (line 80) +* cnf.c: Config files. (line 86) * cnf.h: Programming with config files. (line 23) * code sharing: Shared library. (line 9) @@ -3873,7 +3879,7 @@ Index * configuration compiler options: configure environment. (line 23) * configuration file, source for path: Path sources. (line 17) -* configuration files as shell scripts.: Config files. (line 72) +* configuration files as shell scripts.: Config files. (line 79) * configuration of mktex scripts: mktex configuration. (line 6) * configuration of optional features: configure options. (line 16) * configure error from sed: Empty Makefiles. (line 6) @@ -3881,7 +3887,7 @@ Index * configure options for mktex scripts: mktex configuration. (line 12) * configure, running: Running configure. (line 6) * context diff: Bug checklist. (line 55) -* continuation character: Config files. (line 31) +* continuation character: Config files. (line 37) * core dumps, reporting: Bug checklist. (line 61) * CPPFLAGS: configure environment. (line 22) @@ -4072,7 +4078,7 @@ Index * HOME, as ~ expansion: Tilde expansion. (line 6) * HP-UX, compiling on: TeX or Metafont failing. (line 30) -* identifiers, characters valid in: Config files. (line 41) +* identifiers, characters valid in: Config files. (line 47) * illegal pointer combination warnings: Pointer combination warnings. (line 6) * include fontmap directive: Fontmap. (line 33) @@ -4398,7 +4404,7 @@ Index (line 17) * resolutions, last-resort: Fallback font. (line 6) * retrieving TeX: unixtex.ftp. (line 6) -* right-hand side of variable assignments: Config files. (line 49) +* right-hand side of variable assignments: Config files. (line 56) * Rokicki, Tom: History. (line 12) * root user: Tilde expansion. (line 19) * runtime configuration files: Config files. (line 6) @@ -4424,7 +4430,7 @@ Index (line 164) * sh5, ok with configure: configure shells. (line 25) * shared library, making: Shared library. (line 6) -* shell scripts as configuration files: Config files. (line 72) +* shell scripts as configuration files: Config files. (line 79) * shell variables: Variable expansion. (line 17) * shell_escape, example for code: Programming with config files. (line 10) @@ -4647,7 +4653,7 @@ Index (line 211) * whitespace, in fontmap files: Fontmap. (line 28) * whitespace, not ignored on continuation lines: Config files. - (line 31) + (line 37) * www.tug.org: unixtex.ftp. (line 6) * X11 previewer: Kpathsea application distributions. (line 25) @@ -4675,82 +4681,82 @@ Index Tag Table: Node: Top1615 -Node: Introduction2258 -Node: History4080 -Node: Installation8172 -Node: Simple installation8962 -Node: Custom installation12545 -Node: Disk space13719 -Node: Kpathsea application distributions14603 -Node: Changing search paths15718 -Node: Default path features16900 -Node: Default path generation18983 -Node: Running configure20426 -Node: configure shells21477 -Node: configure options22529 -Node: configure environment24036 -Node: configure scenarios25838 -Node: Shared library27424 -Node: Running make28438 -Node: Installing files30485 -Node: Cleaning up32432 -Node: Filename database generation33480 -Node: mktex scripts34047 -Node: mktex configuration35324 -Node: mktex script names41143 -Node: mktex script arguments42534 -Node: Installation testing43424 -Node: Security43788 -Node: TeX directory structure46355 -Node: unixtex.ftp50777 -Node: Reporting bugs52095 -Node: Bug checklist52830 -Node: Mailing lists56527 -Node: Debugging57736 -Node: Logging62814 -Node: Common problems64684 -Node: Unable to find files65515 -Node: Slow path searching67926 -Node: Unable to generate fonts69303 -Node: TeX or Metafont failing71812 -Node: Empty Makefiles73691 -Node: XtStrings74928 -Node: dlopen75764 -Node: ShellWidgetClass76582 -Node: Pointer combination warnings78214 -Node: Path searching78603 -Node: Searching overview79250 -Node: Path sources82646 -Node: Config files83717 -Node: Path expansion87362 -Node: Default expansion88311 -Node: Variable expansion90381 -Node: Tilde expansion91784 -Node: Brace expansion92764 -Node: KPSE_DOT expansion93869 -Node: Subdirectory expansion94382 -Node: Filename database96733 -Node: ls-R97787 -Node: Filename aliases100681 -Node: Database format101859 -Node: Invoking kpsewhich102872 -Node: Path searching options103818 -Node: Specially-recognized files111982 -Node: Auxiliary tasks113338 -Node: Standard options115163 -Node: TeX support115519 -Node: Supported file formats116810 -Node: File lookup124327 -Node: Glyph lookup126076 -Node: Basic glyph lookup127200 -Node: Fontmap128079 -Node: Fallback font130696 -Node: Suppressing warnings131609 -Node: Programming132714 -Node: Programming overview133227 -Node: Calling sequence135921 -Node: Program-specific files142444 -Node: Programming with config files143467 -Node: Index144779 +Node: Introduction2262 +Node: History4088 +Node: Installation8180 +Node: Simple installation8970 +Node: Custom installation12553 +Node: Disk space13727 +Node: Kpathsea application distributions14611 +Node: Changing search paths15726 +Node: Default path features16908 +Node: Default path generation18991 +Node: Running configure20434 +Node: configure shells21485 +Node: configure options22537 +Node: configure environment24044 +Node: configure scenarios25846 +Node: Shared library27432 +Node: Running make28446 +Node: Installing files30493 +Node: Cleaning up32440 +Node: Filename database generation33488 +Node: mktex scripts34055 +Node: mktex configuration35332 +Node: mktex script names41151 +Node: mktex script arguments42542 +Node: Installation testing43432 +Node: Security43796 +Node: TeX directory structure46363 +Node: unixtex.ftp50785 +Node: Reporting bugs52119 +Node: Bug checklist52854 +Node: Mailing lists56551 +Node: Debugging57760 +Node: Logging62838 +Node: Common problems64708 +Node: Unable to find files65539 +Node: Slow path searching67950 +Node: Unable to generate fonts69327 +Node: TeX or Metafont failing71836 +Node: Empty Makefiles73715 +Node: XtStrings74952 +Node: dlopen75788 +Node: ShellWidgetClass76606 +Node: Pointer combination warnings78238 +Node: Path searching78627 +Node: Searching overview79274 +Node: Path sources82670 +Node: Config files83741 +Node: Path expansion87668 +Node: Default expansion88617 +Node: Variable expansion90687 +Node: Tilde expansion92090 +Node: Brace expansion93070 +Node: KPSE_DOT expansion94175 +Node: Subdirectory expansion94688 +Node: Filename database97039 +Node: ls-R98093 +Node: Filename aliases100987 +Node: Database format102165 +Node: Invoking kpsewhich103178 +Node: Path searching options104124 +Node: Specially-recognized files112288 +Node: Auxiliary tasks113644 +Node: Standard options115469 +Node: TeX support115825 +Node: Supported file formats117116 +Node: File lookup124633 +Node: Glyph lookup126382 +Node: Basic glyph lookup127506 +Node: Fontmap128385 +Node: Fallback font131002 +Node: Suppressing warnings131915 +Node: Programming133020 +Node: Programming overview133533 +Node: Calling sequence136227 +Node: Program-specific files142750 +Node: Programming with config files143773 +Node: Index145085 End Tag Table |