summaryrefslogtreecommitdiff
path: root/Master/texmf/doc/info/kpathsea.info
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf/doc/info/kpathsea.info')
-rw-r--r--Master/texmf/doc/info/kpathsea.info263
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