From 26f76f69761845030093e6b532270812367d2fdc Mon Sep 17 00:00:00 2001 From: Andreas Scherer Date: Sun, 21 Jun 2020 14:03:27 +0000 Subject: [TIE] Add info about KPSE and WEBINPUTS. git-svn-id: svn://tug.org/texlive/trunk@55618 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/web2c/tiedir/ChangeLog | 4 ++++ Build/source/texk/web2c/tiedir/tie-w2c.ch | 29 +++++++++++++++++++++++++++++ 2 files changed, 33 insertions(+) (limited to 'Build/source/texk/web2c/tiedir') diff --git a/Build/source/texk/web2c/tiedir/ChangeLog b/Build/source/texk/web2c/tiedir/ChangeLog index 455724cd5c9..0ceefd2dfb6 100644 --- a/Build/source/texk/web2c/tiedir/ChangeLog +++ b/Build/source/texk/web2c/tiedir/ChangeLog @@ -1,3 +1,7 @@ +2020-06-21 Andreas Scherer + + * tie-w2c.ch: Mention WEBINPUTS environment variable in \S59. + 2020-06-20 Andreas Scherer * tie-w2c.ch: Minor change in section 1 diff --git a/Build/source/texk/web2c/tiedir/tie-w2c.ch b/Build/source/texk/web2c/tiedir/tie-w2c.ch index 8d9066e9d80..04d0e9e4b70 100644 --- a/Build/source/texk/web2c/tiedir/tie-w2c.ch +++ b/Build/source/texk/web2c/tiedir/tie-w2c.ch @@ -396,6 +396,35 @@ change files. The names of the file parameters will be inserted into Section 59 +@x l.1233 +\noindent Here is where \.{TIE} starts, and where it ends. +@y +\noindent Here is where \.{TIE} starts, and where it ends. +\def\Kpathsea/{{\mc KPATHSEA\spacefactor1000}} + +This version of the \.{TIE} program uses the \Kpathsea/ library for searching +files. Firstly, we use the |kpse_web_format| when opening input files, which +triggers the inspection of the \.{WEBINPUTS} environment variable. Secondly, +we set |kpse_program_name| to `\.{tie}'. This means if the variable +\.{WEBINPUTS.tie} is present in \.{texmf.cnf} (or \.{WEBINPUTS\_tie} in the +environment) its value will be used as the search path for filenames. This +allows different flavors of \.{TIE} (or other \.{WEB} programs) to have +different search paths.@.WEBINPUTS@> In all, the directories to be searched for +come from at least two sources: +\smallskip +{\parindent1.5em +\item{(a)} a user-set environment variable \.{WEBINPUTS} + (overridden by \.{WEBINPUTS\_tie}); +\item{(b)} a line in \Kpathsea/ configuration file \.{texmf.cnf},\hfil\break + e.g., \.{WEBINPUTS=\$TEXMFDOTDIR:\$TEXMF/texmf/web//}\hfil\break + or \.{WEBINPUTS.tie=\$TEXMFDOTDIR:\$TEXMF/texmf/web//}.\par} +\smallskip +Note that, although \.{WEBINPUTS} might suggest otherwise, \.{TIE} is more or +less language-agnostic and that it is perfectly capable of handling \.{CWEB} +files as input as well, as long as the ``change files'' adhere to the general +\.{@@x}, \.{@@y}, \.{@@z} convention. +@z + @x l.1236 main(argc,argv) int argc; string *argv; -- cgit v1.2.3