summaryrefslogtreecommitdiff
path: root/Build/source/doc/tlbuild.texi
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2021-09-28 21:45:20 +0000
committerKarl Berry <karl@freefriends.org>2021-09-28 21:45:20 +0000
commit45194e1f2a32e93e5d01fe694ff7b37563c4c45e (patch)
tree9b39a7c2d9c57f2ef56caffe582666bc718a115f /Build/source/doc/tlbuild.texi
parent6053124b74560b39d832852a190f83897d227075 (diff)
hishrink yacc/lex build (attempted) fixes
git-svn-id: svn://tug.org/texlive/trunk@60644 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/doc/tlbuild.texi')
-rw-r--r--Build/source/doc/tlbuild.texi13
1 files changed, 11 insertions, 2 deletions
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index 6084aa2af5c..5afbd68b925 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -2,7 +2,7 @@
@setfilename tlbuild.info
@set version 2021
-@set month-year July 2021
+@set month-year September 2021
@set mytitle Building @TeX{} Live (@value{version})
@settitle @value{mytitle}
@@ -1762,7 +1762,8 @@ Adding a new @TeX{} engine is not completely different from adding a
program, but it's not all that similar, either. In this case, the main
work is done by creating a new subdirectory of @file{texk/web2c/} for
the engine. The subdirectory is conventionally named ending in
-@file{dir}, like @file{pdftexdir} and @file{xetexdir}.
+@file{dir}, like @file{pdftexdir} and @file{xetexdir}, to avoid
+clashes with executable names.
The source files for the new engine should be put in this
@file{@var{newengine}dir} subdirectory. Also, a file
@@ -1784,6 +1785,14 @@ simpler than Lua@TeX{}. Of course, every engine will have its own
unique features and requirements, so existing examples will only take
you so far.
+Web2c is built as one ``package'', with each subdirectory's @file{.am}
+fragment inserted with an Automake @code{include}. This means that,
+for instance, @code{$(srcdir)} is @file{.../web2c}, not
+@file{.../webdir/enginedir}. It is a difficult setup to come to terms
+with, but the alternative is to recurse into each engine subdirectory,
+and that would be far worse (@pxref{Directories,,, automake, GNU
+Automake}).
+
@node Adding a new generic library module
@subsection Adding a new generic library module