diff options
Diffstat (limited to 'Master/texmf/doc/info/kpathsea.info')
-rw-r--r-- | Master/texmf/doc/info/kpathsea.info | 263 |
1 files changed, 134 insertions, 129 deletions
diff --git a/Master/texmf/doc/info/kpathsea.info b/Master/texmf/doc/info/kpathsea.info index def0252034c..26e2ed72832 100644 --- a/Master/texmf/doc/info/kpathsea.info +++ b/Master/texmf/doc/info/kpathsea.info @@ -4,7 +4,7 @@ makeinfo version 4.13 from ../../../../texk/kpathsea/doc/kpathsea.texi. This file documents the Kpathsea library for path searching. Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, -2005, 2007, 2008, 2009, 2010 Karl Berry & Olaf Weber. +2005, 2007, 2008, 2009, 2010, 2011 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 @@ -39,8 +39,8 @@ 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. +filename lookup. It corresponds to version 6.0.1, released in +April 2011. * Menu: @@ -60,8 +60,8 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up: 1 Introduction ************** -This manual corresponds to version 6.0.0 of the Kpathsea library, -released in July 2010. +This manual corresponds to version 6.0.1 of the Kpathsea library, +released in April 2011. The library's fundamental purpose is to return a filename from a list of directories specified by the user, similar to what shells do @@ -1063,8 +1063,8 @@ also be passed: Sets the Metafont mode to NAME. `--bdpi NUM' - Sets the the "base dpi" for the font. This must match the mode - being used. + Sets the "base dpi" for the font. This must match the mode being + used. `--mag STRING' A "magstep" string suitable for the Metafont `mag' variable. This @@ -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'. @@ -2231,13 +2237,11 @@ to `xA1y:xB1y:xA2y:xB2y'. This feature can be used to implement multiple TeX hierarchies, by assigning a brace list to `$TEXMF', as mentioned in `texmf.in'. - You can also use the path separator in stead of the comma. The last + You can also use the path separator instead of the comma. The last example could have been written `x{A:B}{1:2}y'. Brace expansion is implemented in the source file -`kpathsea/expand.c'. It is a modification of the Bash sources, and is -thus covered by the GNU General Public License, rather than the Library -General Public License that covers the rest of Kpathsea. +`kpathsea/expand.c'. File: kpathsea.info, Node: KPSE_DOT expansion, Next: Subdirectory expansion, Prev: Brace expansion, Up: Path expansion @@ -2582,7 +2586,7 @@ filename, and returns the first file found. vf: .vf dvips config (dvipsconfig): ist: .ist - truetype fonts: .ttf .ttc .TTF .TTC + truetype fonts: .ttf .ttc .TTF .TTC .dfont type42 fonts: .t42 .T42 web2c files (web2c): other text files (othertext): @@ -3048,7 +3052,8 @@ environment variables with an underscore, e.g., `TEXINPUTS_latex' invocation.) `TRFONTS'. `truetype fonts' - (TrueType outline fonts) `TTFONTS'; suffixes `.ttf', `.ttc'. + (TrueType outline fonts) `TTFONTS'; suffixes `.ttf' and `.TTF', + `.ttc' and `.TTC', `.dfont'. `type1 fonts' (Type 1 PostScript outline fonts, *note Glyph files: (dvips)Glyph @@ -3703,9 +3708,9 @@ Index * .ovp: Supported file formats. (line 147) * .pfa: Supported file formats. - (line 199) + (line 200) * .pfb: Supported file formats. - (line 199) + (line 200) * .pk: Supported file formats. (line 154) * .pool: Supported file formats. @@ -3725,7 +3730,7 @@ Index * .ttf: Supported file formats. (line 196) * .vf: Supported file formats. - (line 207) + (line 208) * .w: Supported file formats. (line 43) * .web: Supported file formats. @@ -3745,7 +3750,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 +3794,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 +3835,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 +3878,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 +3886,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) @@ -3948,9 +3953,9 @@ Index * dvipdfmx.cfg: Specially-recognized files. (line 19) * DVIPSFONTS: Supported file formats. - (line 242) + (line 243) * DVIPSHEADERS: Supported file formats. - (line 199) + (line 200) * DVIPSMAKEPK: mktex script names. (line 32) * DVIPSSIZES: Fallback font. (line 6) * dynamic creation of files: mktex scripts. (line 6) @@ -4032,7 +4037,7 @@ Index * fontnames, arbitrary length: Fontmap. (line 15) * fonts, being created: Simple installation. (line 79) * FOOINPUTS: Supported file formats. - (line 224) + (line 225) * fopen, redefined: Debugging. (line 54) * format of external database: Database format. (line 6) * FreeBSD configure error: Empty Makefiles. (line 6) @@ -4072,7 +4077,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 +4403,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 +4429,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) @@ -4478,11 +4483,11 @@ Index * system dependencies: Running configure. (line 6) * system V universe: Running make. (line 44) * T1FONTS: Supported file formats. - (line 199) + (line 200) * T1INPUTS: Supported file formats. - (line 199) + (line 200) * T42FONTS: Supported file formats. - (line 204) + (line 205) * tcfmgr.map: Specially-recognized files. (line 47) * TDS <1>: TeX directory structure. @@ -4628,7 +4633,7 @@ Index * version numbers, determining: Bug checklist. (line 15) * VF files, not found: Searching overview. (line 31) * VFFONTS: Supported file formats. - (line 207) + (line 208) * VMS support: Custom installation. (line 19) * Vojta, Paul: History. (line 30) * Walsh, Norman: History. (line 57) @@ -4641,13 +4646,13 @@ Index (line 6) * wcstombs: dlopen. (line 6) * WEB2C: Supported file formats. - (line 215) + (line 216) * Weber, Olaf: History. (line 74) * WEBINPUTS: Supported file formats. - (line 211) + (line 212) * 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) @@ -4659,7 +4664,7 @@ Index * XDvi: Specially-recognized files. (line 41) * XDVIFONTS: Supported file formats. - (line 242) + (line 243) * XDVIMAKEPK: mktex script names. (line 32) * XDVISIZES: Fallback font. (line 6) * XLDFLAGS: Running make. (line 29) @@ -4674,83 +4679,83 @@ 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: Top1621 +Node: Introduction2265 +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 testing43428 +Node: Security43792 +Node: TeX directory structure46359 +Node: unixtex.ftp50781 +Node: Reporting bugs52115 +Node: Bug checklist52850 +Node: Mailing lists56547 +Node: Debugging57756 +Node: Logging62834 +Node: Common problems64704 +Node: Unable to find files65535 +Node: Slow path searching67946 +Node: Unable to generate fonts69323 +Node: TeX or Metafont failing71832 +Node: Empty Makefiles73711 +Node: XtStrings74948 +Node: dlopen75784 +Node: ShellWidgetClass76602 +Node: Pointer combination warnings78234 +Node: Path searching78623 +Node: Searching overview79270 +Node: Path sources82666 +Node: Config files83737 +Node: Path expansion87664 +Node: Default expansion88613 +Node: Variable expansion90683 +Node: Tilde expansion92086 +Node: Brace expansion93066 +Node: KPSE_DOT expansion93991 +Node: Subdirectory expansion94504 +Node: Filename database96855 +Node: ls-R97909 +Node: Filename aliases100803 +Node: Database format101981 +Node: Invoking kpsewhich102994 +Node: Path searching options103940 +Node: Specially-recognized files112111 +Node: Auxiliary tasks113467 +Node: Standard options115292 +Node: TeX support115648 +Node: Supported file formats116939 +Node: File lookup124493 +Node: Glyph lookup126242 +Node: Basic glyph lookup127366 +Node: Fontmap128245 +Node: Fallback font130862 +Node: Suppressing warnings131775 +Node: Programming132880 +Node: Programming overview133393 +Node: Calling sequence136087 +Node: Program-specific files142610 +Node: Programming with config files143633 +Node: Index144945 End Tag Table |