summaryrefslogtreecommitdiff
path: root/Build/source
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2008-01-21 19:38:34 +0000
committerKarl Berry <karl@freefriends.org>2008-01-21 19:38:34 +0000
commit43b0199c5955b61b52d5928a220a6076e68d601f (patch)
tree9406785027213f60d2032c45cd8a777447ceccdd /Build/source
parentfa56cd678b457714e4dab4dbdeae466aa3de4f41 (diff)
regen
git-svn-id: svn://tug.org/texlive/trunk@6360 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source')
-rw-r--r--Build/source/texk/kpathsea/kpathsea.info145
1 files changed, 108 insertions, 37 deletions
diff --git a/Build/source/texk/kpathsea/kpathsea.info b/Build/source/texk/kpathsea/kpathsea.info
index e85d2ae2abb..4f2afae7828 100644
--- a/Build/source/texk/kpathsea/kpathsea.info
+++ b/Build/source/texk/kpathsea/kpathsea.info
@@ -2618,13 +2618,15 @@ File: kpathsea.info, Node: Path searching options, Next: Auxiliary tasks, Up:
----------------------------
Kpsewhich looks up each non-option argument on the command line as a
-filename, and returns the first file found. There is no option to
-return all the files with a particular name (you can run the Unix
-`find' utility for that, *note Invoking find: (findutils)Invoking
-find.).
+filename, and returns the first file found.
Various options alter the path searching behavior:
+`--all'
+ Report all matches found, one per line. By default, if there is
+ more than one match, just one will be reported (chosen effectively
+ at random).
+
`--dpi=NUM'
Set the resolution to NUM; this only affects `gf' and `pk'
lookups. `-D' is a synonym, for compatibility with Dvips.
@@ -2744,6 +2746,69 @@ find.).
affect the search paths via the `.PROGNAM' feature in
configuration files (*note Config files::).
+`--subdir=STRING'
+ Report only those matches whose directory part _ends_ with STRING
+ (compared literally, except case is ignored on a case-insensitive
+ operating system). For example, suppose there are two matches for
+ a given name:
+
+ kpsewhich foo.sty
+ => /some/where/foo.sty
+ /another/place/foo.sty
+
+ Then we can narrow the result to what we are interested in with
+ `--subdir':
+
+ kpsewhich --subdir=where foo.sty
+ => /some/where/foo.sty
+
+ kpsewhich --subdir=place foo.sty
+ => /another/place/foo.sty
+
+ The string to match must be at the end of the directory part of the
+ match, and it is taken literally, with no pattern matching:
+
+ kpsewhich --subdir=another foo.sty
+ =>
+
+ The string to match may cross directory components:
+
+ kpsewhich --subdir=some/where foo.sty
+ => /some/where/foo.sty
+
+ `--subdir' implies `--all'; if there is more than one match, they
+ will all be reported (in our example, both `where' and `place' end
+ in `e'):
+
+ kpsewhich --subdir=e
+ => /some/where/foo.sty
+ /another/place/foo.sty
+
+ Because of the above rules, the presence of a leading `/' is
+ important, since it "anchors" the match to a full component name:
+
+ kpsewhich --subdir=/lace foo.sty
+ =>
+
+ However, a trailing `/' is immaterial (and ignored), since the
+ match always takes place at the end of the directory part:
+
+ kpsewhich --subdir=lace/ foo.sty
+ => /another/place/foo.sty
+
+ The purpose of these rules is to make it convenient to find results
+ only within a particular area of the tree. For instance, a given
+ script named `foo.lua' might exist within both
+ `texmf-dist/scripts/pkg1/' and `texmf-dist/scripts/pkg2/'. By
+ specifying, say, `--subdir=/pkg1', you can be sure of getting the
+ one you are interested in.
+
+ We only match at the end because a site might happen to install TeX
+ in `/some/coincidental/pkg1/path/', and we wouldn't want
+ `texmf-dist/scripts/pkg2/' to match that when searching for
+ `/pkg1'.
+
+

File: kpathsea.info, Node: Auxiliary tasks, Next: Standard options, Prev: Path searching options, Up: Invoking kpsewhich
@@ -3499,36 +3564,40 @@ Index
* !! in path specifications: ls-R. (line 52)
* $ expansion: Variable expansion. (line 6)
+* --all: Path searching options.
+ (line 12)
* --color=tty: ls-R. (line 21)
* --debug=NUM: Auxiliary tasks. (line 9)
* --disable-static: configure options. (line 31)
* --dpi=NUM: Path searching options.
- (line 15)
+ (line 17)
* --enable options: configure options. (line 16)
* --enable-maintainer-mode: configure options. (line 34)
* --enable-shared <1>: Shared library. (line 6)
* --enable-shared: configure options. (line 27)
* --engine=NAME: Path searching options.
- (line 20)
+ (line 22)
* --expand-braces=STRING: Auxiliary tasks. (line 16)
* --expand-path=STRING: Auxiliary tasks. (line 24)
* --expand-var=STRING: Auxiliary tasks. (line 19)
* --format=NAME: Path searching options.
- (line 25)
+ (line 27)
* --help: Standard options. (line 8)
* --interactive: Path searching options.
- (line 99)
+ (line 101)
* --mode=STRING: Path searching options.
- (line 110)
+ (line 112)
* --must-exist: Path searching options.
- (line 115)
+ (line 117)
* --path=STRING: Path searching options.
- (line 120)
+ (line 122)
* --progname=NAME: Path searching options.
- (line 129)
+ (line 131)
* --show-path=NAME: Auxiliary tasks. (line 41)
* --srcdir, for building multiple architectures: configure scenarios.
(line 18)
+* --subdir=STRING: Path searching options.
+ (line 136)
* --var-value=VARIABLE: Auxiliary tasks. (line 12)
* --version: Standard options. (line 10)
* --with options: configure options. (line 16)
@@ -3541,14 +3610,14 @@ Index
* -Bdynamic: ShellWidgetClass. (line 45)
* -Bstatic: ShellWidgetClass. (line 45)
* -D NUM: Path searching options.
- (line 15)
+ (line 17)
* -dynamic: ShellWidgetClass. (line 43)
* -g, compiling without: configure scenarios. (line 32)
* -L option to ls: ls-R. (line 38)
* -mktex=FILETYPE: Path searching options.
- (line 104)
+ (line 106)
* -no-mktex=FILETYPE: Path searching options.
- (line 104)
+ (line 106)
* -O, compiling with: configure scenarios. (line 32)
* -static: ShellWidgetClass. (line 43)
* . directories, ignored: ls-R. (line 33)
@@ -3661,6 +3730,8 @@ Index
* aliases, for filenames: Filename aliases. (line 6)
* all: Suppressing warnings.
(line 13)
+* all matches, finding: Path searching options.
+ (line 12)
* alphabetical order, not: Subdirectory expansion.
(line 6)
* Amiga support: Custom installation. (line 19)
@@ -3766,7 +3837,7 @@ Index
(line 25)
* config.log: Bug checklist. (line 28)
* config.ps: Path searching options.
- (line 35)
+ (line 37)
* config.ps, search path for: Supported file formats.
(line 47)
* config.status: Bug checklist. (line 31)
@@ -3873,7 +3944,7 @@ Index
* ENCFONTS: Supported file formats.
(line 51)
* engine name: Path searching options.
- (line 20)
+ (line 22)
* environment variable, source for path: Path sources. (line 9)
* environment variables for TeX: Supported file formats.
(line 6)
@@ -3999,7 +4070,7 @@ Index
* installation, simple: Simple installation. (line 6)
* installing files: Installing files. (line 6)
* interactive query: Path searching options.
- (line 99)
+ (line 101)
* interface, not frozen: Introduction. (line 27)
* introduction: Introduction. (line 6)
* kdebug:: Debugging. (line 105)
@@ -4247,11 +4318,11 @@ Index
* PDF generation: Kpathsea application distributions.
(line 16)
* pdftex.cfg: Path searching options.
- (line 35)
+ (line 37)
* PDFTEXCONFIG: Supported file formats.
(line 136)
* pdftexconfig.tex: Path searching options.
- (line 35)
+ (line 37)
* permission denied: Searching overview. (line 56)
* permissions, directory: Security. (line 51)
* permissions, file: Security. (line 47)
@@ -4304,7 +4375,7 @@ Index
* reporting bugs: Reporting bugs. (line 6)
* resident.c: Calling sequence. (line 45)
* resolution, setting: Path searching options.
- (line 15)
+ (line 17)
* resolutions, last-resort: Fallback font. (line 6)
* retrieving TeX: unixtex.ftp. (line 6)
* right-hand side of variable assignments: Config files. (line 44)
@@ -4642,21 +4713,21 @@ Node: Filename aliases105735
Node: Database format106913
Node: Invoking kpsewhich107926
Node: Path searching options108803
-Node: Auxiliary tasks113270
-Node: Standard options115080
-Node: TeX support115400
-Node: Supported file formats116691
-Node: File lookup123839
-Node: Glyph lookup125130
-Node: Basic glyph lookup126257
-Node: Fontmap127136
-Node: Fallback font129753
-Node: Suppressing warnings130718
-Node: Programming131823
-Node: Programming overview132336
-Node: Calling sequence134612
-Node: Program-specific files139641
-Node: Programming with config files140679
-Node: Index141979
+Node: Auxiliary tasks115452
+Node: Standard options117262
+Node: TeX support117582
+Node: Supported file formats118873
+Node: File lookup126021
+Node: Glyph lookup127312
+Node: Basic glyph lookup128439
+Node: Fontmap129318
+Node: Fallback font131935
+Node: Suppressing warnings132900
+Node: Programming134005
+Node: Programming overview134518
+Node: Calling sequence136794
+Node: Program-specific files141823
+Node: Programming with config files142861
+Node: Index144161

End Tag Table