[groff] 04/05: [docs]: Enversion groff Texinfo manual (1/2).

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 99d06510be35d4eac05e3e9a1474a89892d2e168
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Feb 4 02:59:01 2024 -0600

    [docs]: Enversion groff Texinfo manual (1/2).
    
    Put version number on cover page of our Texinfo manual.
    
    * doc/groff.texi: Rename this...
    * doc/groff.texi.in: ...to this.
    
    * doc/doc.am (EXTRA_DIST): Add "doc/groff.texi.in".
    
      (MAINTAINERCLEANFILES): Add "doc/groff.texi".
    
      (doc/groff.texi): Add rule for constructing "groff.texi" from
      "groff.texi.in", using `DOC_SED` macro of course.
    
      (doc/groff.info): Update dependency and construction to use the
      now-generated "groff.texi" (so look for it in the build directory).
    
      (maintainer-clean-local): Delete "doc/groff.texi".
    
    * doc/.gitignore: Add "doc/groff.texi".
---
 ChangeLog                         | 15 +++++++++++++++
 doc/.gitignore                    |  1 +
 doc/doc.am                        | 16 +++++++++++-----
 doc/{groff.texi => groff.texi.in} |  0
 4 files changed, 27 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 1b74b191e..3e0afce9e 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,18 @@
+2024-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       Put version number on cover page of our Texinfo manual.
+
+       * doc/groff.texi: Rename this...
+       * doc/groff.texi.in: ...to this.
+       * doc/doc.am (EXTRA_DIST): Add "doc/groff.texi.in".
+       (MAINTAINERCLEANFILES): Add "doc/groff.texi".
+       (doc/groff.texi): Add rule for constructing "groff.texi" from
+       "groff.texi.in", using `DOC_SED` macro of course.
+       (doc/groff.info): Update dependency and construction to use the
+       now-generated "groff.texi" (so look for it in the build
+       directory).
+       (maintainer-clean-local): Delete "doc/groff.texi".
+
 2024-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        Put version number on cover page of collected man pages.
diff --git a/doc/.gitignore b/doc/.gitignore
index f923920e5..62f8acd76 100644
--- a/doc/.gitignore
+++ b/doc/.gitignore
@@ -13,6 +13,7 @@
 /groff.info-[1-9]
 /groff.pdf
 /groff.pdf.t2p/
+/groff.texi
 /groff.txt
 /img/pic-*.png
 /img/webpage-*.png
diff --git a/doc/doc.am b/doc/doc.am
index 5cf4ab306..b906f2bf1 100644
--- a/doc/doc.am
+++ b/doc/doc.am
@@ -548,20 +548,25 @@ GROFF_DVI = doc/groff.dvi
 GROFF_PDF = doc/groff.pdf
 endif
 
-all: doc/groff.info doc/groff.txt doc/groff.html $(GROFF_DVI) \
-  $(GROFF_PDF)
+all: doc/groff.info doc/groff.txt doc/groff.html \
+       $(GROFF_DVI) $(GROFF_PDF)
 
 # Distribute the manual in source form as well.
-EXTRA_DIST += doc/groff.texi doc/fdl.texi
+EXTRA_DIST += doc/groff.texi.in doc/groff.texi doc/fdl.texi
+MAINTAINERCLEANFILES += doc/groff.texi
+
+doc/groff.texi: $(top_srcdir)/doc/groff.texi.in
+       $(AM_V_GEN)$(MKDIR_P) `dirname $@` \
+       && $(DOC_SED) $(top_srcdir)/doc/groff.texi.in >$@
 
 EXTRA_DIST += doc/groff.info
 MAINTAINERCLEANFILES += doc/groff.info
-doc/groff.info: $(doc_srcdir)/groff.texi
+doc/groff.info: doc/groff.texi
        $(AM_V_at)$(MKDIR_P) $(doc_builddir)
        $(AM_V_GEN)LANG=C \
        LC_ALL=C \
        $(MAKEINFO) -o doc/groff.info --enable-encoding \
-         -I $(doc_srcdir) $(doc_srcdir)/groff.texi
+         -I $(doc_srcdir) $(doc_builddir)/groff.texi
 
 # Distribute the Info files.
 dist-hook: dist-info-bits
@@ -654,6 +659,7 @@ maintainer-clean-local:
        $(RM) $(doc_builddir)/groff.txt
        $(RM) -r $(doc_builddir)/groff.html.*
        $(RM) -r $(doc_builddir)/*.t2d $(doc_builddir)/*.t2p
+       $(RM) $(doc_builddir)/groff.texi
 
 # Generated forms of the groff Texinfo manual might be in the source
 # directory (distribution archive build) or in the build directory (Git
diff --git a/doc/groff.texi b/doc/groff.texi.in
similarity index 100%
rename from doc/groff.texi
rename to doc/groff.texi.in