[groff] 02/08: [man pages]: Fix options used by compilation docs.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 43f5bef1db7345ca5153ef7ce5d123bdde256021
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jan 25 20:51:28 2022 +1100

    [man pages]: Fix options used by compilation docs.
    
    * doc/doc.am (doc/groff-man-pages.pdf): Drop `-rU0` option (it's
      unnecessary since we don't yet have PDF hyperlink support in this
      document).  Add `-rC1` option to enable continuous page numbering.
    
      (doc/groff-man-pages.utf8.txt): Drop `-rC1 -rU1`.  Continuous page
      numbering is superfluous since page numbers are not shown in
      continuous rendering mode.  Stop turning on OSC 8 defaults; we don't
      know if the document will be viewed with a supporting pager+terminal
      combination, and further we don't yet have a mechanism for making `MR`
      man page cross references internal to the document when they indicate
      groff man pages.
---
 ChangeLog  | 16 ++++++++++++++++
 doc/doc.am |  4 ++--
 2 files changed, 18 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index cbd9dc4b..82566abb 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -5,6 +5,22 @@
        * src/devices/gropdf/gropdf.pl: Use either '\\\\\\\\n' or
        '\[u000a]' as line separators in the string.
 
+2022-01-25  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       [man pages]: Fix options used to generate compilations.
+
+       * doc/doc.am (doc/groff-man-pages.pdf): Drop `-rU0` option (it's
+       unnecessary since we don't yet have PDF hyperlink support in
+       this document).  Add `-rC1` option to enable continuous page
+       numbering.
+       (doc/groff-man-pages.utf8.txt): Drop `-rC1 -rU1`.  Continuous
+       page numbering is superfluous since page numbers are not shown
+       in continuous rendering mode.  Stop turning on OSC 8 defaults;
+       we don't know if the document will be viewed with a supporting
+       pager+terminal combination, and further we don't yet have a
+       mechanism for making `MR` man page cross references internal to
+       the document when they indicate groff man pages.
+
 2022-01-24  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [man pages]: Ship compilations in UTF-8 text and PDF.
diff --git a/doc/doc.am b/doc/doc.am
index 13431f5f..8ab3e54c 100644
--- a/doc/doc.am
+++ b/doc/doc.am
@@ -223,13 +223,13 @@ GROFF_MAN_PAGES_ALL = $(GROFF_MAN_PAGES1) 
$(GROFF_MAN_PAGES2) \
   $(GROFF_MAN_PAGES3)
 
 doc/groff-man-pages.pdf: $(GROFF_MAN_PAGES_ALL)
-       $(GROFF_V)$(DOC_GROFF) -Tpdf -P-e -mandoc -rU0 \
+       $(GROFF_V)$(DOC_GROFF) -Tpdf -P-e -mandoc -rC1 \
          -rCHECKSTYLE=3 $(GROFF_MAN_PAGES1) \
          $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
          $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@
 
 doc/groff-man-pages.utf8.txt: $(GROFF_MAN_PAGES_ALL)
-       $(GROFF_V)$(DOC_GROFF) -Tutf8 -mandoc -rC1 -rU1 \
+       $(GROFF_V)$(DOC_GROFF) -Tutf8 -mandoc \
          -rCHECKSTYLE=3 $(GROFF_MAN_PAGES1) \
          $(tmac_srcdir)/sv.tmac $(GROFF_MAN_PAGES2) \
          $(tmac_srcdir)/en.tmac $(GROFF_MAN_PAGES3) > $@