texlive[59855] trunk: doc

commits+karl at tug.org commits+karl at tug.org
Tue Jul 6 19:52:36 CEST 2021


Revision: 59855
          http://tug.org/svn/texlive?view=revision&revision=59855
Author:   karl
Date:     2021-07-06 19:52:36 +0200 (Tue, 06 Jul 2021)
Log Message:
-----------
doc

Modified Paths:
--------------
    trunk/Build/source/Build
    trunk/Build/source/doc/ChangeLog
    trunk/Build/source/doc/tlbuild.info
    trunk/Build/source/doc/tlbuild.texi
    trunk/Master/tlpkg/doc/releng.txt

Modified: trunk/Build/source/Build
===================================================================
--- trunk/Build/source/Build	2021-07-06 17:14:52 UTC (rev 59854)
+++ trunk/Build/source/Build	2021-07-06 17:52:36 UTC (rev 59855)
@@ -53,6 +53,8 @@
 
 if test "x$1" = x--no-clean; then
   shift
+  echo "$0: --no-clean given, so keeping build and install dirs: " \
+       "$TL_WORKDIR $TL_INSTALL_DEST"
 else
   test -f Makefile && $MAKE clean 
   rm -rf $TL_WORKDIR $TL_INSTALL_DEST

Modified: trunk/Build/source/doc/ChangeLog
===================================================================
--- trunk/Build/source/doc/ChangeLog	2021-07-06 17:14:52 UTC (rev 59854)
+++ trunk/Build/source/doc/ChangeLog	2021-07-06 17:52:36 UTC (rev 59855)
@@ -1,3 +1,8 @@
+2021-07-06  Karl Berry  <karl at tug.org>
+
+	* tlbuild.texi (Build one package, Build one engine): more
+	needed to avoid C++11 dependencies.
+
 2021-06-30  Karl Berry  <karl at freefriends.org>
 
 	* build-tools.txt: autoconf 2.71 and other updates.

Modified: trunk/Build/source/doc/tlbuild.info
===================================================================
(Binary files differ)

Modified: trunk/Build/source/doc/tlbuild.texi
===================================================================
--- trunk/Build/source/doc/tlbuild.texi	2021-07-06 17:14:52 UTC (rev 59854)
+++ trunk/Build/source/doc/tlbuild.texi	2021-07-06 17:52:36 UTC (rev 59855)
@@ -2,7 +2,7 @@
 @setfilename tlbuild.info
 
 @set version 2021
- at set month-year February 2021
+ at set month-year July 2021
 
 @set mytitle Building @TeX{} Live (@value{version})
 @settitle @value{mytitle}
@@ -497,10 +497,12 @@
 tree.
 
 @cindex C++11, removing dependent sources
-Some libraries and programs require C++11.  If you want to build with
-an older compiler lacking such support, you need to (re)move those
-source directories; specifying @code{--disable} for them does not
-suffice, unfortunately.  Specifically, before running @code{configure}:
+Some libraries and programs require C++11; one such is XeTeX.  If you
+want to build with an older compiler lacking such support, you need to
+(re)move those source directories; unfortunately, specifying
+ at code{--disable} for them does not suffice.  It's also necessary to
+specify @code{--disable-xetex} explicitly. Specifically, before
+running @code{configure --disable-xetex ...}:
 
 @example
 rm -rf libs/icu libs/graphite2 texk/dvisvgm
@@ -508,12 +510,14 @@
 
 @vindex --enable-missing @r{to ignore dependencies}
 Also, even with @code{--disable-all-pkgs}, dependencies are (currently)
-checked.  For instance, if a (non-MacOSX) system does not have
+checked.  One notable case: if a (non-MacOSX) system does not have
 @code{fontconfig}, Xe at TeX{} cannot be built (@pxref{Prerequisites}),
 and @code{configure} will terminate even with @code{--disable-xetex}.
 To proceed without such dependencies, specify @code{--enable-missing}
-also.  (Patches to improve this would be most welcome.)
+also.
 
+Patches to improve all this would be most welcome.
+
 @vindex CC=@var{c-compiler}
 @vindex CXX=@var{c++-compiler}
 @vindex OBJCXX=@var{objc-compiler}
@@ -543,7 +547,8 @@
 @example
 cd Work        # top build directory
 ../configure --without-x --disable-shared --disable-all-pkgs \
-             --enable-tex --disable-synctex -C CFLAGS=-g CXXFLAGS=-g
+             --enable-tex --disable-synctex --disable-xetex \
+             --enable-missing -C CFLAGS=-g CXXFLAGS=-g
 make
 cd texk/web2c  # cd engine build directory
 make tex       # must specify target
@@ -551,9 +556,12 @@
 
 The first @code{make} run will configure everything, and even build
 the libraries, even though the packages are disabled.
+
 The source tree can be cut down to just what is needed for the given
 engine (the separate pdf at TeX{} and Lua at TeX{} source repositories do
-this, for example), but see caveats in previous section.
+this, for example), but see caveats in previous section.  When the
+ at code{--disable-xetex} and @code{--enable-missing} options are needed
+is also explained in the previous section.
 
 If you want to debug an X-related program or shared library setup, or
 other variants, change the @code{configure} options
@@ -1527,7 +1535,7 @@
 @file{xindy-src}.
 
 The @code{xindy} build requires a @file{make} that supports a
- at code{VPATH} build, can handle all targets, and do not refer to
+ at code{VPATH} build, can handle all targets, and does not refer to
 @code{$@{top_srcdir@}} or @code{$@{top_builddir@}}.  The fragment
 @code{xindy/ac/withenable.ac} contains
 

Modified: trunk/Master/tlpkg/doc/releng.txt
===================================================================
--- trunk/Master/tlpkg/doc/releng.txt	2021-07-06 17:14:52 UTC (rev 59854)
+++ trunk/Master/tlpkg/doc/releng.txt	2021-07-06 17:52:36 UTC (rev 59855)
@@ -484,11 +484,11 @@
   Do a test build, commit when successful.
   Ask for rebuilds,
   When (enough) rebuilds are done, commit to the branch and make another tag:
-  brev=nnnnn # branch commit revision, e.g., 51236
-  btag=yyyy.n # branch tag, e.g., 2019.3
-#svn copy -r $bcr -m'texlive-$bt tag based on r$bcr, with <whatever> fix' \
-#   svn://tug.org/texlive/branches/branch2019 \
-#   svn://tug.org/texlive/tags/texlive-$bt 
+  brev=nnnnn  # branch commit revision, e.g., 51236
+  btag=yyyy.n # next branch tag, e.g., 2021.3
+#svn copy -r $brev -m"texlive-$btag tag based on r$brev, with <whatever> fix" \
+#   svn://tug.org/texlive/branches/branch2021 \
+#   svn://tug.org/texlive/tags/texlive-$btag
   (Using urls makes for an immediate commit, which is what we want.)
 
 By the way, in the event of a mistaken delete, the material is best



More information about the tex-live-commits mailing list.