regen

git-svn-id: svn://tug.org/texlive/trunk@6360 c570f23f-e606-0410-a88d-b1316a301751

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