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, 13 insertions, 10 deletions

diff --git a/tmac/groff_trace.7.man b/tmac/groff_trace.7.man
index 9e8a7be47..5bd6a5da7 100644
--- a/tmac/groff_trace.7.man
+++ b/tmac/groff_trace.7.man
@@ -29,12 +29,6 @@ A copy of the Free Documentation License is included as a file called
 FDL in the main directory of the groff source package.
 ..
 .
-.de au
-Written by
-.MT groff\-bernd.warken\-72@web.de
-Bernd Warken
-.ME .
-..
 .
 .ds Ellipsis .\|.\|.\&\"
 .
@@ -286,6 +280,19 @@ for details.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+The
+.I trace
+macro packages was written by James Clark.
+.
+This document was written by
+.MT groff\-bernd.warken\-72@web.de
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -321,10 +328,6 @@ file.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]