[groff] 25/49: [mdoc]: Drop now-unused `doc-pageref` string.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 9b740789a25606fc24a2a47cf7b1af99dcdc87b4
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Nov 3 08:21:07 2022 -0500

    [mdoc]: Drop now-unused `doc-pageref` string.
    
    It was nowhere interpolated outside of state management macros.
    
    * tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
    * tmac/mdoc/doc-common: Do it.
    
    Also update some comments.
---
 ChangeLog            |  8 ++++++++
 tmac/doc.tmac        |  2 --
 tmac/mdoc/doc-common | 20 ++------------------
 3 files changed, 10 insertions(+), 20 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 7bf55f583..41a83740b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,11 @@
+2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       [mdoc]: Drop now-unused `doc-pageref` string.  It was nowhere
+       interpolated outside of state management macros.
+
+       * tmac/doc.tmac (doc-save-global-vars, doc-restore-global-vars):
+       * tmac/mdoc/doc-common: Do it.
+
 2022-11-03  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        * tmac/mdoc/doc-common (doc-header, doc-footer): Revise for
diff --git a/tmac/doc.tmac b/tmac/doc.tmac
index 705e41486..1a627e47d 100644
--- a/tmac/doc.tmac
+++ b/tmac/doc.tmac
@@ -3650,7 +3650,6 @@
 .  ds doc-operating-system-saved "\*[doc-operating-system]
 .  ds doc-date-string-saved "\*[doc-date-string]
 .  nr doc-display-vertical-saved \n[doc-display-vertical]
-.  ds doc-pageref-saved "\*[doc-pageref]
 .  nr doc-in-see-also-section-saved \n[doc-in-see-also-section]
 .  nr doc-in-files-section-saved \n[doc-in-files-section]
 .  nr doc-in-authors-section-saved \n[doc-in-authors-section]
@@ -3791,7 +3790,6 @@
 .  ds doc-operating-system "\*[doc-operating-system-saved]
 .  ds doc-date-string "\*[doc-date-string-saved]
 .  nr doc-display-vertical \n[doc-display-vertical-saved]
-.  ds doc-pageref "\*[doc-pageref-saved]
 .  nr doc-in-see-also-section \n[doc-in-see-also-section-saved]
 .  nr doc-in-files-section \n[doc-in-files-section-saved]
 .  nr doc-in-authors-section \n[doc-in-authors-section-saved]
diff --git a/tmac/mdoc/doc-common b/tmac/mdoc/doc-common
index 4cc3cf319..15cc5b1eb 100644
--- a/tmac/mdoc/doc-common
+++ b/tmac/mdoc/doc-common
@@ -251,30 +251,13 @@
 .ds doc-section \" empty
 .
 .
-.\" NS doc-pageref global string
-.\" NS   the man page identifier formatted for cross-reference
-.
-.ds doc-pageref \" empty
-.
-.
 .\" NS doc-set-up-titles macro
 .\" NS   install and initialize header and footer support
-.\" NS
-.\" NS modifies:
-.\" NS   doc-pageref
 .\"
 .\" TODO: Support man(7)'s `FT` register.
-.\" TODO: support man(7)'s `MF` string.  Embed the font selection escape
-.\"   sequences in `doc-pageref` here; `doc-header` and `doc-footer` can
-.\"   treat it atomically and strings are already defined for the
-.\"   separate components; see below.
 .
 .eo
 .de doc-set-up-titles
-.  ds doc-pageref "\*[doc-page-topic]
-.  if !"\*[doc-section]"" \
-.    as doc-pageref \|(\*[doc-section])
-.
 .  br
 .
 .  if !\n[cR] \{\
@@ -1072,6 +1055,8 @@
 .\"
 .\" NS local variables:
 .\" NS   doc-xref
+.\"
+.\" TODO: Support man(7)'s `X` register.
 .
 .eo
 .de doc-footer
@@ -1673,7 +1658,6 @@
 .  tm doc-operating-system == '\*[doc-operating-system]'
 .  tm doc-date-string == '\*[doc-date-string]'
 .  tm doc-display-vertical == \n[doc-display-vertical]
-.  tm doc-pageref == '\*[doc-pageref]'
 .  tm doc-in-synopsis-section == \n[doc-in-synopsis-section]
 .  tm doc-in-library-section == \n[doc-in-library-section]
 .  tm doc-in-see-also-section == \n[doc-in-see-also-section]