diff options
author | Karl Berry <karl@freefriends.org> | 2007-12-17 01:08:16 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2007-12-17 01:08:16 +0000 |
commit | e1f9144fb7e6ebb3b062abab531c12f917ed41c4 (patch) | |
tree | 8ff42d4d940f9f322e2c87e140f8b3e4d32d3d3d /Build/source/texk | |
parent | e4aaf9695d44639498ff71147d27c9c0d6cd8c64 (diff) |
clarify --expand-path
git-svn-id: svn://tug.org/texlive/trunk@5796 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk')
-rw-r--r-- | Build/source/texk/kpathsea/ChangeLog | 4 | ||||
-rw-r--r-- | Build/source/texk/kpathsea/kpathsea.texi | 13 |
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 |