summaryrefslogtreecommitdiff
path: root/Build
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2007-12-17 01:08:16 +0000
committerKarl Berry <karl@freefriends.org>2007-12-17 01:08:16 +0000
commite1f9144fb7e6ebb3b062abab531c12f917ed41c4 (patch)
tree8ff42d4d940f9f322e2c87e140f8b3e4d32d3d3d /Build
parente4aaf9695d44639498ff71147d27c9c0d6cd8c64 (diff)
clarify --expand-path
git-svn-id: svn://tug.org/texlive/trunk@5796 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build')
-rw-r--r--Build/source/texk/kpathsea/ChangeLog4
-rw-r--r--Build/source/texk/kpathsea/kpathsea.texi13
2 files changed, 13 insertions, 4 deletions
diff --git a/Build/source/texk/kpathsea/ChangeLog b/Build/source/texk/kpathsea/ChangeLog
index 42c447cf043..fb501c37468 100644
--- a/Build/source/texk/kpathsea/ChangeLog
+++ b/Build/source/texk/kpathsea/ChangeLog
@@ -1,3 +1,7 @@
+2007-12-17 Karl Berry <karl@tug.org>
+
+ * kpathsea.texi (Path searching options): clarify --expand-path doc.
+
2007-12-15 Karl Berry <karl@tug.org>
* kpsewhich.c (read_command_line, USAGE): improve --version and
diff --git a/Build/source/texk/kpathsea/kpathsea.texi b/Build/source/texk/kpathsea/kpathsea.texi
index 876c8f4c840..efdcb8357e0 100644
--- a/Build/source/texk/kpathsea/kpathsea.texi
+++ b/Build/source/texk/kpathsea/kpathsea.texi
@@ -1191,7 +1191,7 @@ of guessing the search path from the filename. @samp{//} and all the
usual expansions are supported (@pxref{Path expansion}). This option
and @samp{--format} are mutually exclusive. To output the complete
directory expansion of a path, instead of doing a one-shot lookup, see
-@samp{--expand-path} in the following section.
+@samp{--expand-path} and @samp{--show-path} in the following section.
@item --progname=@var{name}
@opindex --progname=@var{name}
@@ -1234,9 +1234,13 @@ hierarchy. @xref{Path expansion}.
@item
@opindex --expand-path=@var{string}
@samp{--expand-path=@var{string}} outputs the complete expansion of
-@var{string} as a colon-separated path. This is useful to construct a
-search path for a program that doesn't accept recursive subdirectory
-specifications. Nonexistent directories are culled from the output:
+@var{string}, with each element separated by the usual path separator
+on the current system (@samp{;} on Windows, @samp{:} otherwise).
+This may be useful to construct a custom search path for a format not
+otherwise supported. To retrieve the search path for a format that is
+already supported, see @samp{--show-path}, next.
+
+Nonexistent directories are culled from the output:
@example
$ kpsewhich --expand-path '/tmp'
@@ -1254,6 +1258,7 @@ For one-shot uses of an arbitrary (not built in to Kpathsea) path, see
lookups of file type @var{name}. Either a filename extension
(@samp{pk}, @samp{.vf}, etc.) or an integer can be used, just as with
@samp{--format}, described in the previous section.
+
@end itemize