branch master updated: * doc/tp_api/Makefile.am: the documentation is referred to in customization_api Texinfo manual, so always distribute the texinfo source even when they cannot be rebuilt, and always setup documentation building target. Do not install the Info manual, however, as it is mostly useless.

[Patrice Dumas]

This is an automated email from the git hooks/post-receive script.

pertusus pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new e6c13063be * doc/tp_api/Makefile.am: the documentation is referred to 
in customization_api Texinfo manual, so always distribute the texinfo source 
even when they cannot be rebuilt, and always setup documentation building 
target.  Do not install the Info manual, however, as it is mostly useless.
e6c13063be is described below

commit e6c13063becc387813fac3a424d9a0c5a4b6f364
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Sun Feb 6 15:11:12 2022 +0100

    * doc/tp_api/Makefile.am: the documentation is referred to in
    customization_api Texinfo manual, so always distribute the texinfo
    source even when they cannot be rebuilt, and always setup
    documentation building target.  Do not install the Info manual,
    however, as it is mostly useless.
---
 ChangeLog              |  8 ++++++++
 doc/tp_api/Makefile.am | 35 +++++++++++++++++++++++++----------
 2 files changed, 33 insertions(+), 10 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index e402143611..3019207549 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2022-02-06  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/tp_api/Makefile.am: the documentation is referred to in
+       customization_api Texinfo manual, so always distribute the texinfo
+       source even when they cannot be rebuilt, and always setup
+       documentation building target.  Do not install the Info manual,
+       however, as it is mostly useless.
+
 2022-02-05  Patrice Dumas  <pertusus@free.fr>
 
        * NEWS, doc/texinfo.texi (HTML Splitting, HTML Xref Link Basics)
diff --git a/doc/tp_api/Makefile.am b/doc/tp_api/Makefile.am
index 70a2bfc3c7..67eb1a7479 100644
--- a/doc/tp_api/Makefile.am
+++ b/doc/tp_api/Makefile.am
@@ -10,6 +10,14 @@
 # WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
 # implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 
+# the info file is not correct because of all the :: and , in the node
+# names, therefore it is not really usefull to install it.  nodist_ is
+# not ok to achieve that, as the other Texinfo related build targets are also
+# removed with that prefix.
+
+# no-installinfo requires foreign
+AUTOMAKE_OPTIONS = no-installinfo foreign
+
 # Use the programs built in our distribution, taking account of possible
 # cross-compiling.
 MAKEINFO = $(PERL) -I $(top_srcdir)/tp/ $(top_srcdir)/tp/texi2any.pl
@@ -19,22 +27,31 @@ MAKEINFO = $(PERL) -I $(top_srcdir)/tp/ 
$(top_srcdir)/tp/texi2any.pl
 # of each module, so split at chapters.
 MAKEINFOHTML = $(MAKEINFO) --html --split=chapter
 
-#info_TEXINFOS = tp_api.texi
-if BUILD_PERL_API_TEXI
-
-dist_info_TEXINFOS = tp_api.texi
-# in 2022 an info_TEXINFOS variable is not allowed in a conditional
-#info_TEXINFOS = tp_api.texi
+# since the tp_api 'manual' is referred to extensively in the
+# customization_api, we setup the build targets.  More
+# relevant for the HTML output, as, as said above the Info manual
+# is useless.
+info_TEXINFOS = tp_api.texi
 
 # dependencies are in api_includes/ directory but we do not want to list
 # them explicitely
 #tp_api_TEXINFOS = 
 #dist_tp_api_TEXINFOS = 
+EXTRA_DIST = api_includes
 
-BUILT_SOURCES = tp_api.texi
+if BUILD_PERL_API_TEXI
+
+# dist_info_TEXINFOS does not seems to be used in the resulting Makefile.in
+#dist_info_TEXINFOS = tp_api.texi
+# in 2022 an info_TEXINFOS variable is not allowed in a conditional, and
+# in addition we want the build targets to be available even when the
+# texinfo sources cannot be rebuilt.
+#info_TEXINFOS = tp_api.texi
 
-#DISTCLEANFILES = tp_api.info
+BUILT_SOURCES = tp_api.texi
 
+# all the modules with some interesting public interfaces.
+# The order matters for the result.
 tp_api_dependencies = \
   $(top_srcdir)/tp/Texinfo/Common.pm \
   $(top_srcdir)/tp/Texinfo/Encoding.pm \
@@ -58,6 +75,4 @@ tp_api_dependencies = \
 tp_api.texi: $(tp_api_dependencies)
        $(PERL) -I $(top_srcdir)/Pod-Simple-Texinfo/lib/ -I $(top_srcdir)/tp/ 
-I $(top_srcdir)/tp/maintain/lib/Text-Unidecode/lib/ -I 
$(top_srcdir)/tp/maintain/lib/libintl-perl/lib/ -I 
$(top_srcdir)/tp/maintain/lib/Unicode-EastAsianWidth/lib/ 
$(top_srcdir)/Pod-Simple-Texinfo/pod2texi.pl --base-level=section --top 
'Texinfo modules documentation' --subdir=api_includes -o $@ 
$(tp_api_dependencies)
 
-EXTRA_DIST = api_includes tp_api.texi
-
 endif