man pages: Rationalize author sections.

Part 1 of a man page author and copyright information overhaul; see
https://lists.gnu.org/archive/html/groff/2017-11/msg00013.html et seq.

Thanks to Werner Lemberg, Ingo Schwarze, and Ralph Corderoy for their
feedback and support.

* Stop defining page-local "au" macros to store author information.

* Instead, move it directly inline in the page, as is common practice
  elsewhere.

I made several cleanups along the way, but only to material in the
AUTHORS section:

* Researched (insofar as I was able) and added program and macro package
  author information.  Something seems slightly wrong to me to have a
  man page that documents some other work and then identify only the
  authors of the man page itself.  (By contrast, some section 5 and 7
  man pages are sui generis.)

* Where the page documented a GNU reimplementation of a historical roff
  work (program or macro package), clarify the point.

* Don't refer to the original Berkeley grn as @g@grn; it'll be wrong if
  anyone sets the program prefix.

* Discuss "this document" or a program rather than "this file".

* Changed inline email addresses to use MT/ME macros.

* Escaped hyphens in arguments to MT and UR macros.

* Dropped unnecessary quotation marks from the argument to SH.

* Call the section AUTHORS even if there is only one author, for
  consistency and future-proofing.  This is what the man-pages project
  folks call it, too, even though they discourage its use.

* Added discretionary hyphenless breakpoints to MT and UR macros (not
  comprehensively, though).

* Set the page's own name in bold where this was not already done.

* Set references to software tools and systems in italics where they
  were not (1) man page cross references; or (2) the topic of the
  immediate page.

* Relocate AUTHORS section to immediately precede SEE ALSO section.

Signed-off-by: G. Branden Robinson <g.branden.robinson@gmail.com>

1 files changed, 14 insertions, 9 deletions

diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index c9030fa6d..ea22a2346 100644
--- a/tmac/groff_www.7.man
+++ b/tmac/groff_www.7.man
@@ -35,11 +35,6 @@ GPLs
 .UE .
 ..
 .
-.de au
-.B \%grohtml
-was written by
-.MTO gaius@glam.ac.uk "Gaius Mulley"
-..
 .
 .\" we need the .LK here as we use it in the middle as an example --
 .\" once the user requests .LK then the automatic generation of links
@@ -696,6 +691,20 @@ be reproduced, and say which version of groff you are using.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+The
+.I www
+macro package
+was written by
+.MTO gaius@\:glam.ac.uk "Gaius Mulley" ,
+with additions by
+.MTO wl@\:gnu.org "Werner Lemberg"
+and
+.MTO groff\-bernd.warken\-72@\:web.de "Bernd Warken" .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .BR groff (@MAN1EXT@),
@@ -708,10 +717,6 @@ be reproduced, and say which version of groff you are using.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_www_C]