diff options
author | Karl Berry <karl@freefriends.org> | 2018-12-18 01:40:49 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-12-18 01:40:49 +0000 |
commit | d9b2d2530b4ac09813cfba6d98bce38bde3b51dd (patch) | |
tree | 3bc9012f1281edc4a9c2c18d30ce922ef04a06e3 /Build/source/texk/kpathsea/doc | |
parent | b1b4f4baba35f24c5312ba7b478db9a66614765b (diff) |
restore -var-value behavior; new option -var-brace-value
git-svn-id: svn://tug.org/texlive/trunk@49446 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/kpathsea/doc')
-rw-r--r-- | Build/source/texk/kpathsea/doc/kpathsea.info | 92 | ||||
-rw-r--r-- | Build/source/texk/kpathsea/doc/kpathsea.texi | 31 |
2 files changed, 84 insertions, 39 deletions
diff --git a/Build/source/texk/kpathsea/doc/kpathsea.info b/Build/source/texk/kpathsea/doc/kpathsea.info index ee5c11d3030..b6438df80ad 100644 --- a/Build/source/texk/kpathsea/doc/kpathsea.info +++ b/Build/source/texk/kpathsea/doc/kpathsea.info @@ -1469,12 +1469,33 @@ Kpsewhich provides some features in addition to path lookup as such: integer can be used, just as with '--format', described in the previous section. +'--var-brace-value=VARIABLE' + Like '--var-value' (next), but also expands '{...}' constructs. + (*note Brace expansion::). Thus, the value is assumed to possibly + be several path elements, and '~' is expanded at the beginning of + each. The path separator is changed to that of the current system + in the expansion. + + Example: 'FOO='.;~' kpsewhich --var-brace-value=FOO' outputs (on a + Unix-ish system) '.:/home/karl', supposing the latter is the + current user's home directory. Note that the ';' in the source + value, as commonly used in 'texmf.cnf', has changed to a ':', as + the normal path separator on the current system. (On a Windows-ish + system, the ';' would remain.) + '--var-value=VARIABLE' - Outputs the value of VARIABLE (a simple identifier like 'TEXMF', - with no '$' or other constructs), expanding '{...}' (*note Brace - expansion::), '$' (*note Variable expansion::) and '~' (*note Tilde - expansion::) constructs, considered as strings, but not looking on - the filesystem. + Outputs the value of VARIABLE (a simple identifier like + 'TEXMFDIST', with no '$' or other constructs), expanding '$' (*note + Variable expansion::) and '~' (*note Tilde expansion::) constructs + in the value. '~' expansion happens at the beginning of the + overall value and at the beginning of a variable expansion, but not + arbitrarily within the string. Braces are not expanded. + + Example: '--var-value=texmf_casefold_search' outputs (if the + default is not changed) '1'. + + Example to contrast with '--var-brace-value': 'FOO='.;~' kpsewhich + --var-value=FOO' outputs '.;~', i.e., the same as the input value. File: kpathsea.info, Node: Standard options, Prev: Auxiliary tasks, Up: Invoking kpsewhich @@ -2975,7 +2996,8 @@ Index * --show-path=NAME: Auxiliary tasks. (line 51) * --subdir=STRING: Path searching options. (line 164) -* --var-value=VARIABLE: Auxiliary tasks. (line 57) +* --var-brace-value=VARIABLE: Auxiliary tasks. (line 57) +* --var-value=VARIABLE: Auxiliary tasks. (line 71) * --version: Standard options. (line 11) * --with-mktextex-default: mktex configuration. (line 12) * --without-mktexfmt-default: mktex configuration. (line 12) @@ -3871,34 +3893,34 @@ Node: Invoking kpsewhich48985 Node: Path searching options49940 Node: Specially-recognized files58459 Node: Auxiliary tasks59814 -Node: Standard options62282 -Node: TeX support62638 -Node: Supported file formats63992 -Node: File lookup71657 -Node: Glyph lookup73406 -Node: Basic glyph lookup74530 -Node: Fontmap75410 -Node: Fallback font77939 -Node: Suppressing warnings78851 -Node: mktex scripts79978 -Node: mktex configuration81193 -Node: mktex script names86996 -Node: mktex script arguments88382 -Node: Programming89261 -Node: Programming overview89834 -Node: Calling sequence92695 -Node: Program-specific files99227 -Node: Programming with config files100250 -Node: Reporting bugs101562 -Node: Bug checklist102240 -Node: Mailing lists105712 -Node: Debugging106387 -Node: Logging111464 -Node: Common problems113331 -Node: Unable to find files113808 -Node: Slow path searching116218 -Node: Unable to generate fonts117593 -Node: TeX or Metafont failing120064 -Node: Index121266 +Node: Standard options63353 +Node: TeX support63709 +Node: Supported file formats65063 +Node: File lookup72728 +Node: Glyph lookup74477 +Node: Basic glyph lookup75601 +Node: Fontmap76481 +Node: Fallback font79010 +Node: Suppressing warnings79922 +Node: mktex scripts81049 +Node: mktex configuration82264 +Node: mktex script names88067 +Node: mktex script arguments89453 +Node: Programming90332 +Node: Programming overview90905 +Node: Calling sequence93766 +Node: Program-specific files100298 +Node: Programming with config files101321 +Node: Reporting bugs102633 +Node: Bug checklist103311 +Node: Mailing lists106783 +Node: Debugging107458 +Node: Logging112535 +Node: Common problems114402 +Node: Unable to find files114879 +Node: Slow path searching117289 +Node: Unable to generate fonts118664 +Node: TeX or Metafont failing121135 +Node: Index122337 End Tag Table diff --git a/Build/source/texk/kpathsea/doc/kpathsea.texi b/Build/source/texk/kpathsea/doc/kpathsea.texi index 8bdf46be39f..449bd0e7489 100644 --- a/Build/source/texk/kpathsea/doc/kpathsea.texi +++ b/Build/source/texk/kpathsea/doc/kpathsea.texi @@ -1822,13 +1822,36 @@ Show the path that would be used for file lookups of file type or an integer can be used, just as with @samp{--format}, described in the previous section. +@item --var-brace-value=@var{variable} +@opindex --var-brace-value=@var{variable} +Like @samp{--var-value} (next), but also expands @samp{@{...@}} +constructs. (@pxref{Brace expansion}). Thus, the value is assumed to +possibly be several path elements, and @samp{~} is expanded at the +beginning of each. The path separator is changed to that of the +current system in the expansion. + +Example: @samp{FOO='.;~' kpsewhich --var-brace-value=FOO} outputs (on +a Unix-ish system) @samp{.:/home/karl}, supposing the latter is the +current user's home directory. Note that the @samp{;} in the source +value, as commonly used in @file{texmf.cnf}, has changed to a +@samp{:}, as the normal path separator on the current system. (On a +Windows-ish system, the @samp{;} would remain.) + @item --var-value=@var{variable} @opindex --var-value=@var{variable} Outputs the value of @var{variable} (a simple identifier like -@samp{TEXMF}, with no @samp{$} or other constructs), expanding -@samp{@{...@}} (@pxref{Brace expansion}), @samp{$} (@pxref{Variable -expansion}) and @samp{~} (@pxref{Tilde expansion}) constructs, -considered as strings, but not looking on the filesystem. +@samp{TEXMFDIST}, with no @samp{$} or other constructs), expanding +@samp{$} (@pxref{Variable expansion}) and @samp{~} (@pxref{Tilde +expansion}) constructs in the value. @samp{~} expansion happens at the +beginning of the overall value and at the beginning of a variable +expansion, but not arbitrarily within the string. Braces are not expanded. + +Example: @samp{--var-value=texmf_casefold_search} outputs (if the +default is not changed) @samp{1}. + +Example to contrast with @samp{--var-brace-value}: @samp{FOO='.;~' +kpsewhich --var-value=FOO} outputs @samp{.;~}, i.e., the same as the +input value. @end table |