summaryrefslogtreecommitdiff
path: root/Build/source/doc/tlbuild.texi
diff options
context:
space:
mode:
Diffstat (limited to 'Build/source/doc/tlbuild.texi')
-rw-r--r--Build/source/doc/tlbuild.texi28
1 files changed, 17 insertions, 11 deletions
diff --git a/Build/source/doc/tlbuild.texi b/Build/source/doc/tlbuild.texi
index a889b42b4a6..43fb68f3dcf 100644
--- a/Build/source/doc/tlbuild.texi
+++ b/Build/source/doc/tlbuild.texi
@@ -349,7 +349,7 @@ Building in the source directory itself is not supported (sorry).
@menu
* Build iteration:: What @code{configure} and @code{make} do in TL.
* Build in parallel:: Simultaneous @code{make} processes.
-* Build distribution:: Making a distribution tarball.
+* Build distribution:: (Not) making a distribution tarball.
* Build one package:: Example of working on just one program.
* Build one engine:: Example of building just one @TeX{} engine.
* Cross compilation:: Building on host X for target Y.
@@ -420,16 +420,21 @@ configure cache file, i.e., specifying the @code{configure} option
@cindex distribution tarball, making
@cindex @code{dist} and @code{distcheck} targets for @code{make}
-Running @code{make dist} at the top level creates a tarball
+Running @code{make dist} or related targets at the top level outputs an
+error message and fails. We no longer try to keep @code{make dist}
+working, although it could be restored if there is some use for it.
+
+The @code{dist} target used to create a tarball
@file{tex-live-@var{yyyy}-@var{mm}-@var{dd}.tar.xz} from the TL source
-tree. Running @code{make distcheck} also verifies that this tarball
-suffices to build and install all of TL.
+tree, and @code{distcheck} also verifies that this tarball suffices to
+build and install all of TL.
+
+However, the result was not a complete or even usable @TeX{} system,
+since all the support files are lacking. We do not actually
+distribute any such tarball, and have no plans to do so.
-This is useful for checking consistency of the source tree and
-Makefiles, but the result is not a complete or even usable @TeX{}
-system, since all the support files are lacking; @pxref{Installing}.
-We do not actually distribute any such tarball, and have no plans to
-do so.
+@xref{Installing}, for more information on what to do with the results
+of a build.
@node Build one package
@section Build one package
@@ -811,8 +816,9 @@ not present in the TL source tree. The best basis for dealing with them
is the @TL{} (plain text) database in
@file{Master/tlpkg/texlive.tlpdb}, and/or the @TL{} installer,
@code{install-tl}. More information is under @file{Master/tlpkg} and
-at @url{https://tug.org/texlive/distro.html}.
-
+at @url{https://tug.org/texlive/distro.html} and
+ @url{https://tug.org/texlive/build.html#deploy}.
+
@menu
* Installation directories:: The prefix, @code{bindir}, etc., directories.
* Linked scripts:: Scripts not maintained in the sources.