[groff] 11/14: [man]: Reflect rename in documentation.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 1180b353de18ad26ed2bbfb0a8a88ab565343f55
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Jul 5 23:35:01 2021 +1000

    [man]: Reflect rename in documentation.
    
    * PROBLEMS:
    * doc/groff.texi (man):
    * tmac/man.local: Update documentation appropriately.
    
    * NEWS: Add item.
    
    Fixes <https://savannah.gnu.org/bugs/?60789>.
---
 ChangeLog      |  8 ++++++++
 NEWS           | 11 +++++++++++
 PROBLEMS       |  4 ++--
 doc/groff.texi |  1 -
 tmac/man.local |  4 ++--
 5 files changed, 23 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index b982dc5..e5a1ee7 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -57,6 +57,14 @@
 
        * tmac/an.tmac: Drop "-old" nomenclature.
 
+       * PROBLEMS:
+       * doc/groff.texi (man):
+       * tmac/man.local: Update documentation appropriately.
+
+       * NEWS: Add item.
+
+       Fixes <https://savannah.gnu.org/bugs/?60789>.
+
 2021-07-05  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [troff]: Slightly refactor.  Make the source code slightly more
diff --git a/NEWS b/NEWS
index 15f402a..3d33a1d 100644
--- a/NEWS
+++ b/NEWS
@@ -112,6 +112,17 @@ o The new rfc1345 macro package, contributed by Dorai 
Sitaram, defines
   some additions from Vim, which itself uses RFC 1345 for its digraphs).
   It is documented in the groff_rfc1345(7) man page.
 
+o Part of the an (man) macro package has been renamed from "an-old.tmac"
+  to "an.tmac", replacing a file that sourced the "andoc.tmac" wrapper.
+  This means that the "-man" argument to groff (or nroff, or troff) will
+  no longer load the andoc wrapper, and not successfully format mdoc(7)
+  man pages.  If you are not sure which macro package a given man page
+  uses, or you wish to batch-process a series of man pages written
+  variously in the man and mdoc formats, be sure to call the formatter
+  with the "-mandoc" option explicitly, as "-man" will no longer do
+  this.  The man-db man(1) implementation has, since 2001, used
+  "-mandoc" preferentially if available when man-db is configured.
+
 o The an (man) macro package supports a new AD string to put the default
   adjustment mode under user control.  The default is 'b' (adjust lines
   to both margins) as has been the Unix man(7) default since 1979.
diff --git a/PROBLEMS b/PROBLEMS
index 952bb6e..c690dac 100644
--- a/PROBLEMS
+++ b/PROBLEMS
@@ -222,8 +222,8 @@ comments, you can do it like this:
 
 There seem to be many different styles of page header and footer
 produced by different versions of the -man macros.  You need to put
-modified macros from tmac/an-old.tmac into man.local.  More
-information is available in groff_man(7).
+modified macros from tmac/an.tmac into man.local.  More information is
+available in groff_man(7).
 
 ----------------------------------------------------------------------
 
diff --git a/doc/groff.texi b/doc/groff.texi
index 04a85fe..9d17ec8 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2192,7 +2192,6 @@ groff -m man -m ms foo.man bar.doc
 @cindex man pages
 @pindex an.tmac
 @pindex man.tmac
-@pindex man-old.tmac
 
 The @code{man} macro package is the most widely-used and probably the
 most important ever developed for @code{troff}.  It is easy to use, and
diff --git a/tmac/man.local b/tmac/man.local
index 3030a84..8cb0be2 100644
--- a/tmac/man.local
+++ b/tmac/man.local
@@ -1,4 +1,4 @@
 .\" -*- nroff -*-
 .\"
-.\" This file is loaded after an-old.tmac.
-.\" Put any local modifications to an-old.tmac here.
+.\" This file is loaded after an.tmac.
+.\" Put any local modifications to an.tmac here.