From 4391e438a4c947f2f4d89ac65c19722a3dd94195 Mon Sep 17 00:00:00 2001 From: Bernhard Voelker Date: Wed, 16 Nov 2022 00:54:05 +0100 Subject: [PATCH 3/3] doc: generate manuals with `makeinfo --no-split` * doc/Makefile.am (AM_MAKEINFOFLAGS): Add for --no-split option. (find_mono.html): Remove --no-split from makeinfo invocation. * NEWS (Documentation Changes): Document the change. * doc/.gitignore (/find.info-1,/find.info-2): Remove entries. Suggested by Antonio Diaz Diaz in https://lists.gnu.org/r/bug-findutils/2022-11/msg00001.html --- NEWS | 5 +++++ doc/.gitignore | 2 -- doc/Makefile.am | 6 +++++- 3 files changed, 10 insertions(+), 3 deletions(-) diff --git a/NEWS b/NEWS index dffca5aa..1fff34f8 100644 --- a/NEWS +++ b/NEWS @@ -13,6 +13,11 @@ GNU findutils NEWS - User visible changes. -*- outline -*- (allout) findutils now builds again on systems with musl-libc. This requires gettext-0.19.8. +** Documentation Changes + + When generating the Texinfo manual, `makeinfo` is invoked with the --no-split + option for all output formats now; this avoids files like find.info-[12]. + * Noteworthy changes in release 4.9.0 (2022-02-22) [stable] diff --git a/doc/.gitignore b/doc/.gitignore index 5894fa1f..a5451b14 100644 --- a/doc/.gitignore +++ b/doc/.gitignore @@ -9,8 +9,6 @@ /find.fns /find.html/ /find.info -/find.info-1 -/find.info-2 /find.ky /find.log /find.pdf diff --git a/doc/Makefile.am b/doc/Makefile.am index d16ebfa4..47c2f2b2 100644 --- a/doc/Makefile.am +++ b/doc/Makefile.am @@ -26,6 +26,10 @@ CLEANFILES = find.txt find_mono.html findutils.texi_html_node.tar.gz dblocation. find.txt tmp-doc-install find_mono.html.gz MAKEINFOTXT = $(MAKEINFO) --plaintext +# Tell makeinfo to put everything in a single info file: .info. +# Otherwise, it would also generate files with names like .info-[12]. +AM_MAKEINFOFLAGS = --no-split + find.txt: find.texi $(srcdir)/version.texi $(find_TEXINFOS) # find.txt is a file which we need to know how to build @@ -51,7 +55,7 @@ find.txt: find.texi $(srcdir)/version.texi $(find_TEXINFOS) # This rule is derived from the generic .texi.html rule. find_mono.html: find.texi rm -rf $(@:.html=.htp) - if $(MAKEINFOHTML) --no-split $(AM_MAKEINFOHTMLFLAGS) $(MAKEINFOFLAGS) -I $(srcdir) \ + if $(MAKEINFOHTML) $(AM_MAKEINFOHTMLFLAGS) $(MAKEINFOFLAGS) -I $(srcdir) \ -o $(@:.html=.htp) find.texi; \ then \ rm -rf $@; \ -- 2.38.1