texlive[71119] Build/source: explicit error on make dist, since we no

Mon Apr 29 19:11:37 CEST 2024

Revision: 71119
          https://tug.org/svn/texlive?view=revision&revision=71119
Author:   karl
Date:     2024-04-29 19:11:37 +0200 (Mon, 29 Apr 2024)
Log Message:
-----------
explicit error on make dist, since we no longer support it

Modified Paths:
--------------
    trunk/Build/source/ChangeLog
    trunk/Build/source/Makefile.am
    trunk/Build/source/Makefile.in
    trunk/Build/source/doc/tlbuild.info
    trunk/Build/source/doc/tlbuild.texi

Modified: trunk/Build/source/ChangeLog
===================================================================

--- trunk/Build/source/ChangeLog	2024-04-29 14:27:21 UTC (rev 71118)
+++ trunk/Build/source/ChangeLog	2024-04-29 17:11:37 UTC (rev 71119)
@@ -1,3 +1,9 @@
+2024-04-29  Karl Berry  <karl at freefriends.org>
+
+	* Makefile.am (distdir): override default dist generation,
+	since we don't try to keep make dist working any more.
+	https://tug.org/pipermail/tlbuild/2024q2/005547.html
+
 2023-12-31  Karl Berry  <karl at freefriends.org>
 
 	* reautoconf: add -f / --force option to pass to autoreconf.

Modified: trunk/Build/source/Makefile.am
===================================================================
--- trunk/Build/source/Makefile.am	2024-04-29 14:27:21 UTC (rev 71118)
+++ trunk/Build/source/Makefile.am	2024-04-29 17:11:37 UTC (rev 71119)
@@ -103,3 +103,16 @@
 .PHONY: triptrap
 triptrap:
 	cd texk && $(MAKE) $(AM_MAKEFLAGS) $@
+
+# We aren't trying to keep make dist working. Sorry.
+distdir:
+	@echo "Sorry, we don't try to keep make dist working in TeX Live."
+	@echo
+	@echo "You can retrieve the development and/or released sources"
+	@echo "  in various ways: https://tug.org/texlive/svn"
+	@echo
+	@echo "For info on how to integrate the built binaries into a runnable"
+	@echo "  system, see: https://tug.org/texlive/build.html#deploy"
+	@echo
+	@echo "The result of make install is not usable by itself."
+	@false

Modified: trunk/Build/source/Makefile.in
===================================================================
--- trunk/Build/source/Makefile.in	2024-04-29 14:27:21 UTC (rev 71118)
+++ trunk/Build/source/Makefile.in	2024-04-29 17:11:37 UTC (rev 71119)
@@ -669,8 +669,6 @@
 distclean-tags:
 	-rm -f TAGS ID GTAGS GRTAGS GSYMS GPATH tags
 	-rm -f cscope.out cscope.in.out cscope.po.out cscope.files
-distdir: $(BUILT_SOURCES)
-	$(MAKE) $(AM_MAKEFLAGS) distdir-am
 
 distdir-am: $(DISTFILES)
 	$(am__remove_distdir)
@@ -1084,6 +1082,19 @@
 triptrap:
 	cd texk && $(MAKE) $(AM_MAKEFLAGS) $@
 
+# We aren't trying to keep make dist working. Sorry.
+distdir:
+	@echo "Sorry, we don't try to keep make dist working in TeX Live."
+	@echo
+	@echo "You can retrieve the development and/or released sources"
+	@echo "  in various ways: https://tug.org/texlive/svn"
+	@echo
+	@echo "For info on how to integrate the built binaries into a runnable"
+	@echo "  system, see: https://tug.org/texlive/build.html#deploy"
+	@echo
+	@echo "The result of make install is not usable by itself."
+	@false
+
 # Tell versions [3.59,3.63) of GNU make to not export all variables.
 # Otherwise a system limit (for SysV at least) may be exceeded.
 .NOEXPORT:

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

Modified: trunk/Build/source/doc/tlbuild.texi
===================================================================
--- trunk/Build/source/doc/tlbuild.texi	2024-04-29 14:27:21 UTC (rev 71118)
+++ trunk/Build/source/doc/tlbuild.texi	2024-04-29 17:11:37 UTC (rev 71119)
@@ -349,7 +349,7 @@
 @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,17 +420,22 @@
 @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- at var{yyyy}- at var{mm}- at 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.
 
-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.
+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.
 
+ at 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 @@
 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.

