diff options
author | Karl Berry <karl@freefriends.org> | 2010-04-15 18:15:35 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-04-15 18:15:35 +0000 |
commit | baa0fe4cefaf104803fb55e441d20cab2f4d1fbe (patch) | |
tree | 92c399cf845c6b65867930d309a3e79f81879821 /Build/source/texk/kpathsea/doc | |
parent | d5879f23bbdd249c0e8ebfba28f1b58d24b00e4b (diff) |
support one-word abbreviations of format names where useful
git-svn-id: svn://tug.org/texlive/trunk@17881 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/kpathsea/doc')
-rw-r--r-- | Build/source/texk/kpathsea/doc/kpathsea.info | 241 | ||||
-rw-r--r-- | Build/source/texk/kpathsea/doc/kpathsea.texi | 50 |
2 files changed, 156 insertions, 135 deletions
diff --git a/Build/source/texk/kpathsea/doc/kpathsea.info b/Build/source/texk/kpathsea/doc/kpathsea.info index de65f5a3bb0..6c2a9885016 100644 --- a/Build/source/texk/kpathsea/doc/kpathsea.info +++ b/Build/source/texk/kpathsea/doc/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 Karl Berry & Olaf Weber. +2005, 2007, 2008, 2009, 2010 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 5.1.0, released in -June 2009. +filename lookup. It corresponds to version 6.0.0, released in +April 2010. * Menu: @@ -60,8 +60,8 @@ File: kpathsea.info, Node: Introduction, Next: Installation, Prev: Top, Up: 1 Introduction ************** -This manual corresponds to version 5.1.0 of the Kpathsea library, -released in June 2009. +This manual corresponds to version 6.0.0 of the Kpathsea library, +released in April 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 @@ -2613,6 +2613,7 @@ in administrative scripts. It is used heavily in the distributed `mktex...' scripts. Synopsis: + kpsewhich OPTION... FILENAME... The options and filename(s) to look up can be intermixed. Options @@ -2678,9 +2679,14 @@ filename, and returns the first file found. suffixes. *Note Supported file formats::, for more information on each of these. + The strings in parentheses are abbreviations recognized only by + `kpsewhich' (not the underlying library calls). They are provided + when it would otherwise require an argument containing a space to + specify the format, to simplify quoting of calls from shells. + gf: gf pk: pk - bitmap font: + bitmap font (bitmapfont): tfm: .tfm afm: .afm base: .base @@ -2696,42 +2702,45 @@ filename, and returns the first file found. mft: .mft mp: .mp mppool: .pool - MetaPost support: + MetaPost support (mpsupport): ocp: .ocp ofm: .ofm .tfm - opl: .opl + opl: .opl .pl otp: .otp - ovf: .ovf - ovp: .ovp + ovf: .ovf .vf + ovp: .ovp .vpl graphic/figure: .eps .epsi tex: .tex .sty .cls .fd .aux .bbl .def .clo .ldf - TeX system documentation: + TeX system documentation (doc): texpool: .pool - TeX system sources: .dtx .ins + TeX system sources (source): .dtx .ins PostScript header: .pro - Troff fonts: + Troff fonts (trofffont): type1 fonts: .pfa .pfb vf: .vf - dvips config: + dvips config (dvipsconfig): ist: .ist truetype fonts: .ttf .ttc .TTF .TTC type42 fonts: .t42 .T42 - web2c files: - other text files: - other binary files: - misc fonts: + web2c files (web2c): + other text files (othertext): + other binary files (otherbin): + misc fonts (miscfont): web: .web .ch cweb: .w .web .ch enc files: .enc - cmap files: + cmap files (cmap): subfont definition files: .sfd opentype fonts: .otf - pdftex config: + pdftex config (pdftexconfig): lig files: .lig texmfscripts: lua: .luc .luctex .texluc .lua .luatex .texlua font feature files: .fea cid maps: .cid .cidmap + mlbib: .mlbib .bib + mlbst: .mlbst .bst + clua: .dll .so This option and `--path' are mutually exclusive. @@ -2946,9 +2955,11 @@ File: kpathsea.info, Node: Standard options, Prev: Auxiliary tasks, Up: Invok Kpsewhich accepts the standard GNU options: - * `--help' prints a help message on standard output and exits. + * `--help' prints a help message on standard output and exits + successfully. - * `--version' prints the Kpathsea version number and exits. + * `--version' prints the Kpathsea version number and exits + successfully. File: kpathsea.info, Node: TeX support, Next: Programming, Prev: Path searching, Up: Top @@ -3729,30 +3740,30 @@ Index (line 38) * --help: Standard options. (line 8) * --interactive: Path searching options. - (line 110) + (line 118) * --mktex=FILETYPE: Path searching options. - (line 115) + (line 123) * --mode=STRING: Path searching options. - (line 121) + (line 129) * --must-exist: Path searching options. - (line 126) + (line 134) * --no-mktex=FILETYPE: Path searching options. - (line 115) + (line 123) * --path=STRING: Path searching options. - (line 131) + (line 139) * --progname=NAME: Path searching options. - (line 140) + (line 148) * --safe-in-name=NAME: Path searching options. - (line 146) + (line 154) * --safe-out-name=NAME: Path searching options. - (line 146) + (line 154) * --show-path=NAME: Auxiliary tasks. (line 41) * --srcdir, for building multiple architectures: configure scenarios. (line 18) * --subdir=STRING: Path searching options. - (line 152) + (line 160) * --var-value=VARIABLE: Auxiliary tasks. (line 12) -* --version: Standard options. (line 10) +* --version: Standard options. (line 11) * --with options: configure options. (line 16) * --with-mktextex-default: mktex configuration. (line 12) * --without-mktexfmt-default: mktex configuration. (line 12) @@ -4243,7 +4254,7 @@ Index * installation, simple: Simple installation. (line 6) * installing files: Installing files. (line 6) * interactive query: Path searching options. - (line 110) + (line 118) * interface, not frozen: Introduction. (line 27) * introduction: Introduction. (line 6) * kdebug:: Debugging. (line 105) @@ -4845,86 +4856,86 @@ Index Tag Table: -Node: Top1609 -Node: Introduction2252 -Node: History4074 -Node: Installation8166 -Node: Simple installation8956 -Node: Custom installation12539 -Node: Disk space13713 -Node: Kpathsea application distributions14597 -Node: Changing search paths15712 -Node: Default path features16894 -Node: Default path generation18977 -Node: Running configure20420 -Node: configure shells21471 -Node: configure options22523 -Node: configure environment24030 -Node: configure scenarios25832 -Node: Shared library27418 -Node: Running make28432 -Node: Installing files30479 -Node: Cleaning up32426 -Node: Filename database generation33474 -Node: mktex scripts34041 -Node: mktex configuration35318 -Node: mktex script names41137 -Node: mktex script arguments42528 -Node: Installation testing43418 -Node: Security43782 -Node: TeX directory structure46349 -Node: unixtex.ftp50771 -Node: Electronic distribution52781 -Node: CD-ROM distribution55546 -Node: Other TeX packages56361 -Node: Reporting bugs57657 -Node: Bug checklist58392 -Node: Mailing lists62089 -Node: Debugging63298 -Node: Logging68376 -Node: Common problems70246 -Node: Unable to find files71077 -Node: Slow path searching73488 -Node: Unable to generate fonts74865 -Node: TeX or Metafont failing77374 -Node: Empty Makefiles79253 -Node: XtStrings80483 -Node: dlopen81319 -Node: ShellWidgetClass82137 -Node: Pointer combination warnings83769 -Node: Path searching84158 -Node: Searching overview84805 -Node: Path sources88201 -Node: Config files89272 -Node: Path expansion92917 -Node: Default expansion93866 -Node: Variable expansion95936 -Node: Tilde expansion97339 -Node: Brace expansion98319 -Node: KPSE_DOT expansion99424 -Node: Subdirectory expansion99937 -Node: Filename database102288 -Node: ls-R103342 -Node: Filename aliases106236 -Node: Database format107414 -Node: Invoking kpsewhich108427 -Node: Path searching options109372 -Node: Specially-recognized files117033 -Node: Auxiliary tasks118389 -Node: Standard options120214 -Node: TeX support120534 -Node: Supported file formats121825 -Node: File lookup129341 -Node: Glyph lookup131073 -Node: Basic glyph lookup132197 -Node: Fontmap133076 -Node: Fallback font135693 -Node: Suppressing warnings136606 -Node: Programming137711 -Node: Programming overview138224 -Node: Calling sequence140918 -Node: Program-specific files147441 -Node: Programming with config files148483 -Node: Index149795 +Node: Top1615 +Node: Introduction2259 +Node: History4082 +Node: Installation8174 +Node: Simple installation8964 +Node: Custom installation12547 +Node: Disk space13721 +Node: Kpathsea application distributions14605 +Node: Changing search paths15720 +Node: Default path features16902 +Node: Default path generation18985 +Node: Running configure20428 +Node: configure shells21479 +Node: configure options22531 +Node: configure environment24038 +Node: configure scenarios25840 +Node: Shared library27426 +Node: Running make28440 +Node: Installing files30487 +Node: Cleaning up32434 +Node: Filename database generation33482 +Node: mktex scripts34049 +Node: mktex configuration35326 +Node: mktex script names41145 +Node: mktex script arguments42536 +Node: Installation testing43426 +Node: Security43790 +Node: TeX directory structure46357 +Node: unixtex.ftp50779 +Node: Electronic distribution52789 +Node: CD-ROM distribution55554 +Node: Other TeX packages56369 +Node: Reporting bugs57665 +Node: Bug checklist58400 +Node: Mailing lists62097 +Node: Debugging63306 +Node: Logging68384 +Node: Common problems70254 +Node: Unable to find files71085 +Node: Slow path searching73496 +Node: Unable to generate fonts74873 +Node: TeX or Metafont failing77382 +Node: Empty Makefiles79261 +Node: XtStrings80491 +Node: dlopen81327 +Node: ShellWidgetClass82145 +Node: Pointer combination warnings83777 +Node: Path searching84166 +Node: Searching overview84813 +Node: Path sources88209 +Node: Config files89280 +Node: Path expansion92925 +Node: Default expansion93874 +Node: Variable expansion95944 +Node: Tilde expansion97347 +Node: Brace expansion98327 +Node: KPSE_DOT expansion99432 +Node: Subdirectory expansion99945 +Node: Filename database102296 +Node: ls-R103350 +Node: Filename aliases106244 +Node: Database format107422 +Node: Invoking kpsewhich108435 +Node: Path searching options109381 +Node: Specially-recognized files117550 +Node: Auxiliary tasks118906 +Node: Standard options120731 +Node: TeX support121087 +Node: Supported file formats122378 +Node: File lookup129894 +Node: Glyph lookup131626 +Node: Basic glyph lookup132750 +Node: Fontmap133629 +Node: Fallback font136246 +Node: Suppressing warnings137159 +Node: Programming138264 +Node: Programming overview138777 +Node: Calling sequence141471 +Node: Program-specific files147994 +Node: Programming with config files149036 +Node: Index150348 End Tag Table diff --git a/Build/source/texk/kpathsea/doc/kpathsea.texi b/Build/source/texk/kpathsea/doc/kpathsea.texi index a76efe8aa4c..f19ca9ffcff 100644 --- a/Build/source/texk/kpathsea/doc/kpathsea.texi +++ b/Build/source/texk/kpathsea/doc/kpathsea.texi @@ -2,14 +2,14 @@ @setfilename kpathsea.info @settitle Kpathsea: A library for path searching -@set version 5.1.0 -@set month-year June 2009 +@set version 6.0.0 +@set month-year April 2010 @copying This file documents the Kpathsea library for path searching. Copyright @copyright{} 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2007, 2008, 2009 Karl Berry & Olaf Weber. +2004, 2005, 2007, 2008, 2009, 2010 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 @@ -1038,6 +1038,7 @@ perhaps in administrative scripts. It is used heavily in the distributed @samp{mktex@dots{}} scripts. Synopsis: + @example kpsewhich @var{option}@dots{} @var{filename}@dots{} @end example @@ -1113,10 +1114,15 @@ sake of the shell.) Here's the current list of recognized names and the associated suffixes. @xref{Supported file formats}, for more information on each of these. +The strings in parentheses are abbreviations recognized only by +@code{kpsewhich} (not the underlying library calls). They are +provided when it would otherwise require an argument containing a +space to specify the format, to simplify quoting of calls from shells. + @example gf: gf pk: pk -bitmap font: +bitmap font (bitmapfont): tfm: .tfm afm: .afm base: .base @@ -1132,42 +1138,45 @@ mfpool: .pool mft: .mft mp: .mp mppool: .pool -MetaPost support: +MetaPost support (mpsupport): ocp: .ocp ofm: .ofm .tfm -opl: .opl +opl: .opl .pl otp: .otp -ovf: .ovf -ovp: .ovp +ovf: .ovf .vf +ovp: .ovp .vpl graphic/figure: .eps .epsi tex: .tex .sty .cls .fd .aux .bbl .def .clo .ldf -TeX system documentation: +TeX system documentation (doc): texpool: .pool -TeX system sources: .dtx .ins +TeX system sources (source): .dtx .ins PostScript header: .pro -Troff fonts: +Troff fonts (trofffont): type1 fonts: .pfa .pfb vf: .vf -dvips config: +dvips config (dvipsconfig): ist: .ist truetype fonts: .ttf .ttc .TTF .TTC type42 fonts: .t42 .T42 -web2c files: -other text files: -other binary files: -misc fonts: +web2c files (web2c): +other text files (othertext): +other binary files (otherbin): +misc fonts (miscfont): web: .web .ch cweb: .w .web .ch enc files: .enc -cmap files: +cmap files (cmap): subfont definition files: .sfd opentype fonts: .otf -pdftex config: +pdftex config (pdftexconfig): lig files: .lig texmfscripts: lua: .luc .luctex .texluc .lua .luatex .texlua font feature files: .fea cid maps: .cid .cidmap +mlbib: .mlbib .bib +mlbst: .mlbst .bst +clua: .dll .so @end example This option and @samp{--path} are mutually exclusive. @@ -1447,11 +1456,12 @@ Kpsewhich accepts the standard GNU options: @itemize @bullet @item @opindex --help -@samp{--help} prints a help message on standard output and exits. +@samp{--help} prints a help message on standard output and exits +successfully. @item @opindex --version -@samp{--version} prints the Kpathsea version number and exits. +@samp{--version} prints the Kpathsea version number and exits successfully. @end itemize |