summaryrefslogtreecommitdiff
path: root/Build/source/texk/web2c/tiedir
diff options
context:
space:
mode:
authorAndreas Scherer <andreas_tex@freenet.de>2020-06-21 14:03:27 +0000
committerAndreas Scherer <andreas_tex@freenet.de>2020-06-21 14:03:27 +0000
commit26f76f69761845030093e6b532270812367d2fdc (patch)
tree3016a58fb4bf35400c73cbcc61aa580a9f4f0ea2 /Build/source/texk/web2c/tiedir
parente2cffe6d96130e6c2d41d08c189b9f5ea6b37667 (diff)
[TIE] Add info about KPSE and WEBINPUTS.
git-svn-id: svn://tug.org/texlive/trunk@55618 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/tiedir')
-rw-r--r--Build/source/texk/web2c/tiedir/ChangeLog4
-rw-r--r--Build/source/texk/web2c/tiedir/tie-w2c.ch29
2 files changed, 33 insertions, 0 deletions
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 <https://ascherer.github.io>
+
+ * tie-w2c.ch: Mention WEBINPUTS environment variable in \S59.
+
2020-06-20 Andreas Scherer <https://ascherer.github.io>
* 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;