tlbuild.texi: @include install-tl and tlmgr, autogenerated from the pod

git-svn-id: svn://tug.org/texlive/trunk@34143 c570f23f-e606-0410-a88d-b1316a301751

1 files changed, 60 insertions, 11 deletions

diff --git a/Build/source/doc/Makefile.in b/Build/source/doc/Makefile.in
index 417567be498..60e055e8f02 100644
--- a/Build/source/doc/Makefile.in
+++ b/Build/source/doc/Makefile.in
@@ -79,7 +79,8 @@ build_triplet = @build@
 host_triplet = @host@
 subdir = doc
 DIST_COMMON = $(srcdir)/Makefile.in $(srcdir)/Makefile.am \
-	$(top_srcdir)/build-aux/texinfo.tex ChangeLog
+	$(tlbuild_TEXINFOS) $(top_srcdir)/build-aux/texinfo.tex \
+	ChangeLog
 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
 am__aclocal_m4_deps = $(top_srcdir)/m4/kpse-cairo-flags.m4 \
 	$(top_srcdir)/m4/kpse-common.m4 \
@@ -429,8 +430,41 @@ top_build_prefix = @top_build_prefix@
 top_builddir = @top_builddir@
 top_srcdir = @top_srcdir@
 info_TEXINFOS = tlbuild.texi
-texlive_TEXINFOS = build-tools.txt
+tlbuild_TEXINFOS = build-tools.txt \
+  tlbuild-incl/install-tl.texi tlbuild-incl/install-tl.texi
+
 EXTRA_DIST = build-tools.txt splitinfo.gawk
+
+# no reasonable way to avoid it with the pod doc.
+MAKEINFOFLAGS = --set INFO_SPECIAL_CHARS_WARNING=0
+
+#  autogenerate texinfo from install-tl and tlmgr pod.
+# none of this is intended to be executed except manually.
+mydoc = tlbuild
+
+# until the next texinfo release, need development texinfo
+# for --appendix-sections.
+texinfo_dir = $(HOME)/gnu/src/texinfo
+pod2texi = perl $(texinfo_dir)/Pod-Simple-Texinfo/pod2texi.pl
+pod2texi_args = \
+  --appendix-sections \
+  --base-level=section \
+  --no-fill-section-gaps \
+  --preamble=''
+
+
+# We use a complicated L<> section reference in the tlmgr pod,
+# schematically like this:
+#   L<whatever|/mysec I<myital>>
+# Unfortunately, the Pod module does not pass the necessary information
+# in the callbacks to allow pod2texi to preserve the I<>.  It seems
+# better to kludge in some substitutions here than reimplement a whole
+# pod parser.  Sigh.
+#
+update_node_bad = ref{tlmgr update [option]... [pkg]...
+update_node_good = ref{tlmgr update [\@emph{option}]... [\@emph{pkg}]...
+install_node_bad = ref{tlmgr install [option]... pkg...
+install_node_good = ref{tlmgr install [\@emph{option}]... \@emph{pkg}...
 all: all-am
 
 .SUFFIXES:
@@ -515,10 +549,10 @@ clean-libtool:
 	else \
 	  rm -rf $(@:.html=.htp); exit 1; \
 	fi
-$(srcdir)/tlbuild.info: tlbuild.texi 
-tlbuild.dvi: tlbuild.texi 
-tlbuild.pdf: tlbuild.texi 
-tlbuild.html: tlbuild.texi 
+$(srcdir)/tlbuild.info: tlbuild.texi $(tlbuild_TEXINFOS)
+tlbuild.dvi: tlbuild.texi $(tlbuild_TEXINFOS)
+tlbuild.pdf: tlbuild.texi $(tlbuild_TEXINFOS)
+tlbuild.html: tlbuild.texi $(tlbuild_TEXINFOS)
 .dvi.ps:
 	$(AM_V_DVIPS)TEXINPUTS="$(am__TEXINFO_TEX_DIR)$(PATH_SEPARATOR)$$TEXINPUTS" \
 	$(DVIPS) $(AM_V_texinfo) -o $@ $<
@@ -867,16 +901,31 @@ uninstall-am: uninstall-dvi-am uninstall-html-am uninstall-info-am \
 	uninstall-pdf-am uninstall-ps-am
 
 
-# just for development of the doc.
-readme-files: tlbuild.texi
+#  autogenerate the top-level README files.
+readme-files: tlbuild.info
 	rm -f README.*
-	makeinfo --no-split -o /tmp/i $< # for error checking
-	makeinfo --plaintext -o - $< \
+	$(MAKEINFO) $(MAKEINFOFLAGS) --plaintext -o - $(srcdir)/tlbuild.texi \
 	| tee /tmp/a \
 	| gawk -f $(srcdir)/splitinfo.gawk
 	ls -l README.*
 #	head -8 README.*
-.PHONY: readme-files
+readme-install: readme-files
+	cp -p README.* $(top_srcdir)/
+	svn diff $(top_srcdir)/README.* >/tmp/sd
+	svn status $(top_srcdir)/README.*
+#
+.PHONY: readme-files readme-install
+
+# we don't actually use the (autogenerated) -incl.texi file,
+# but it makes for a convenient target.
+$(mydoc)-incl.texi: install-tl tlmgr.pl 
+	$(pod2texi) -o $@ --subdir=$(mydoc)-incl $(pod2texi_args) $^
+	perl -pi \
+          -e 's/\Q$(update_node_bad)\E/$(update_node_good)/' \
+          -e ';' \
+          -e 's/\Q$(install_node_bad)\E/$(install_node_good)/' \
+	  $(mydoc)-incl/tlmgr.texi
+.PHONY: $(mydoc)-incl.texi
 
 # 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.