diff options
Diffstat (limited to 'Build/source/doc/tlbuild.texi')
| -rw-r--r-- | Build/source/doc/tlbuild.texi | 13 |
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 |