[groff] 02/05: [docs]: Enversion groff-man-pages.pdf cover (1/2).

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit bb7ca4651a9029b965882452c75e1efbb6f12636
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Feb 4 02:17:53 2024 -0600

    [docs]: Enversion groff-man-pages.pdf cover (1/2).
    
    Put version number on cover page of collected man pages.
    
    * doc/GMPfront.t: Rename this...
    * doc/GMPfront.t.in: ...to this.
    
    * doc/doc.am (DOCFILES_NOINST): Update to reflect rename.
    
      (DOC_GMP_COVER_PAGE): Add new macro to house the generated file's
      name, "doc/GMPfront.t".
    
      ($(DOC_GMP_COVER_PAGE)): New target creates this file from its *.in.
    
      (doc/groff-man-pages.pdf): Migrate dependency and construction to
      now-generated `$(DOC_GMP_COVER_PAGE)` file.
    
      (MOSTLYCLEANFILES): Add `$(DOC_GMP_COVER_PAGE)`.
    
    * doc/.gitignore: Add "doc/GMPfront.t".
---
 ChangeLog                         | 15 +++++++++++++++
 doc/.gitignore                    |  1 +
 doc/{GMPfront.t => GMPfront.t.in} |  0
 doc/doc.am                        | 16 ++++++++++++----
 4 files changed, 28 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f88d83b8a..e0639dce1 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 collected man pages.
+
+       * doc/GMPfront.t: Rename this...
+       * doc/GMPfront.t.in: ...to this.
+       * doc/doc.am (DOCFILES_NOINST): Update to reflect rename.
+       (DOC_GMP_COVER_PAGE): Add new macro to house the generated
+       file's name, "doc/GMPfront.t".
+       ($(DOC_GMP_COVER_PAGE)): New target creates this file from its
+       *.in.
+       (doc/groff-man-pages.pdf): Migrate dependency and construction
+       to now-generated `$(DOC_GMP_COVER_PAGE)` file.
+       (MOSTLYCLEANFILES): Add `$(DOC_GMP_COVER_PAGE)`.
+
 2024-02-04  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * doc/doc.am (doc/groff-man-pages.pdf): Add dependency on
diff --git a/doc/.gitignore b/doc/.gitignore
index 7fdc71e0c..f923920e5 100644
--- a/doc/.gitignore
+++ b/doc/.gitignore
@@ -1,4 +1,5 @@
 # build artifacts
+/GMPfront.t
 /automake.pdf
 /gnu.eps
 /grnexmpl.ps
diff --git a/doc/GMPfront.t b/doc/GMPfront.t.in
similarity index 100%
rename from doc/GMPfront.t
rename to doc/GMPfront.t.in
diff --git a/doc/doc.am b/doc/doc.am
index d3dcd8eed..5cf4ab306 100644
--- a/doc/doc.am
+++ b/doc/doc.am
@@ -45,6 +45,7 @@ DOC_PDFMOM = \
 
 # This image file is used by several documents in the groff source tree.
 DOC_GNU_EPS = doc/gnu.eps
+DOC_GMP_COVER_PAGE = doc/GMPfront.t
 
 # Other doc, installed in $(docdir)
 # Files located in the source tree
@@ -53,7 +54,7 @@ DOCFILES_INST = \
   doc/ms.ms \
   doc/pic.ms
 DOCFILES_NOINST = \
-  doc/GMPfront.t \
+  doc/GMPfront.t.in \
   doc/meintro.me.in \
   doc/meintro_fr.me.in \
   doc/meref.me.in
@@ -114,7 +115,10 @@ $(PROCESSEDDOCFILES_TXT): $(PROCESSEDFILES_DEPS_TXT)
 otherdocdir = $(docdir)
 dist_otherdoc_DATA = $(DOCFILES_INST)
 nodist_otherdoc_DATA = $(PROCESSEDDOCFILES) $(GENERATEDDOCFILES)
-MOSTLYCLEANFILES += $(GENERATEDDOCFILES) $(PROCESSEDDOCFILES)
+MOSTLYCLEANFILES += \
+  $(GENERATEDDOCFILES) \
+  $(PROCESSEDDOCFILES) \
+  $(DOC_GMP_COVER_PAGE)
 EXTRA_DIST += $(DOCFILES_NOINST)
 
 EXTRA_DIST += doc/automake.mom
@@ -261,6 +265,10 @@ man-all: $(GROFF_MAN_PAGES_ALL)
 man-clean:
        $(RM) $(GROFF_MAN_PAGES_ALL)
 
+$(DOC_GMP_COVER_PAGE): $(doc_srcdir)/GMPfront.t.in
+       $(AM_V_GEN)$(MKDIR_P) `dirname $@` \
+       && $(DOC_SED) $(doc_srcdir)/GMPfront.t.in >$@
+
 # Many pages use tbl, a few use eqn, and soelim(1) uses pic.  We also
 # need groff's FreeEuro font so we can embed it.
 #
@@ -268,12 +276,12 @@ man-clean:
 # ensure consistent rendering of the document, and (3) exercise this
 # feature of gropdf.
 doc/groff-man-pages.pdf: $(GROFF_MAN_PAGES_ALL) \
-  $(top_srcdir)/doc/GMPfront.t \
+  $(DOC_GMP_COVER_PAGE) \
   eqn pic tbl pdfmom \
   $(TMAC_PACKAGE_MAN) $(TMAC_PACKAGE_MDOC) font/devps/freeeuro.pfa
        $(GROFF_V)$(DOC_PDFMOM) -pet -mandoc -dHF=HB -rC1 \
          -rCHECKSTYLE=3 -Tpdf -P-e \
-         $(top_srcdir)/doc/GMPfront.t \
+         $(DOC_GMP_COVER_PAGE) \
          $(GROFF_MAN_PAGES1) \
          $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
          $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@