[groff] 10/10: [man]: Stop supplying volume title for section 3p.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 2285cbc71b58b9387ccf72368b4f128f5cb7fa3d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Oct 26 18:20:01 2021 +1100

    [man]: Stop supplying volume title for section 3p.
    
    * tmac/an.tmac (TH): Stop populating `an-extra3` (the default center
      header) if the section argument is "3p".  "3p" does not always mean a
      Perl-related man page; Debian- and Arch Linux-based systems[1][2] (at
      least) have long used a "3perl" suffix, while OpenBSD appears to still
      use "3p" for Perl[3], which is also used by the POSIX man page
      distribution[4].  Fortunately, Perl and POSIX are reliable at
      providing a fifth argument to `TH` anyway, so our fallback is as
      unnecessary as it is non-impartial.
    
    * tmac/groff_man.7.man.in (Document structure macros) <TH>: De-document
      the above behavior.
    
    [1] https://manpages.debian.org/bullseye/perl-doc/Pod::Man.3perl.en.html
    [2] https://man.archlinux.org/man/Pod::Man.3perl
    [3] https://man.openbsd.org/man3p/Pod::Man.3p
    [4] https://man7.org/linux/man-pages/man3/system.3p.html
---
 ChangeLog               | 20 ++++++++++++++++++++
 tmac/an.tmac            |  1 -
 tmac/groff_man.7.man.in |  1 -
 3 files changed, 20 insertions(+), 2 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index f3e785b..7f4e3d3 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,25 @@
 2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       * tmac/an.tmac (TH): Stop populating `an-extra3` (the default
+       center header) if the section argument is "3p".  "3p" does not
+       always mean a Perl-related man page; Debian- and Arch
+       Linux-based systems[1][2] (at least) have long used a "3perl"
+       suffix, while OpenBSD appears to still use "3p" for Perl[3],
+       which is also used by the POSIX man page distribution[4].
+       Fortunately, Perl and POSIX are reliable at providing a fifth
+       argument to `TH` anyway, so our fallback is as unnecessary as it
+       is non-impartial.
+       * tmac/groff_man.7.man.in (Document structure macros) <TH>:
+       De-document the above behavior.
+
+       [1] https://manpages.debian.org/bullseye/perl-doc/\
+       Pod::Man.3perl.en.html
+       [2] https://man.archlinux.org/man/Pod::Man.3perl
+       [3] https://man.openbsd.org/man3p/Pod::Man.3p
+       [4] https://man7.org/linux/man-pages/man3/system.3p.html
+
+2021-10-26  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        [man]: Abbreviate the inside footer if necessary.
 
        * tmac/an.tmac (an-prepare-inner-footer): Prevent the inside
diff --git a/tmac/an.tmac b/tmac/an.tmac
index 287983b..7b42e45 100644
--- a/tmac/an.tmac
+++ b/tmac/an.tmac
@@ -224,7 +224,6 @@
 .  el \{ .ie '\\$2'1'  .ds an-extra3 General Commands Manual\"
 .  el \{ .ie '\\$2'2'  .ds an-extra3 System Calls Manual\"
 .  el \{ .ie '\\$2'3'  .ds an-extra3 Library Functions Manual\"
-.  el \{ .ie '\\$2'3p' .ds an-extra3 Perl Programmer's Reference Guide\"
 .  el \{ .ie '\\$2'4'  .ds an-extra3 Kernel Interfaces Manual\"
 .  el \{ .ie '\\$2'5'  .ds an-extra3 File Formats Manual\"
 .  el \{ .ie '\\$2'6'  .ds an-extra3 Games Manual\"
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 9a01a1d..74282fd 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -403,7 +403,6 @@ is centered in the header line.
 If
 .I section
 is a simple integer between 1 and\~9 (inclusive),
-or is exactly \(lq3p\(rq,
 there is no need to specify
 .IR header-middle ;
 the macro package will supply text for it.