summaryrefslogtreecommitdiff
path: root/Build/source/texk/kpathsea/doc/kpathsea.info
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-12-18 01:40:49 +0000
committerKarl Berry <karl@freefriends.org>2018-12-18 01:40:49 +0000
commitd9b2d2530b4ac09813cfba6d98bce38bde3b51dd (patch)
tree3bc9012f1281edc4a9c2c18d30ce922ef04a06e3 /Build/source/texk/kpathsea/doc/kpathsea.info
parentb1b4f4baba35f24c5312ba7b478db9a66614765b (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/kpathsea.info')
-rw-r--r--Build/source/texk/kpathsea/doc/kpathsea.info92
1 files changed, 57 insertions, 35 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