groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 01/01: man pages: Rationalize author sections.


From: G. Branden Robinson
Subject: [groff] 01/01: man pages: Rationalize author sections.
Date: Sun, 5 Nov 2017 09:42:38 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit 7ca66dd2987146f597f29ffdbc00dcd3084fecb4
Author: G. Branden Robinson <address@hidden>
Date:   Sun Nov 5 08:03:46 2017 -0500

    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 @address@hidden; 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 <address@hidden>
---
 contrib/chem/chem.1.man                       | 31 +++++++++-------
 contrib/gdiffmk/gdiffmk.1.man                 | 12 +++----
 contrib/glilypond/glilypond.1.man             | 20 +++++------
 contrib/gperl/gperl.1.man                     | 21 ++++++-----
 contrib/gpinyin/gpinyin.1.man                 | 17 +++++----
 contrib/groff_filenames/groff_filenames.5.man | 19 +++++-----
 contrib/groffer/groffer.1.man                 | 20 +++++------
 contrib/groffer/roff2.1.man                   | 20 +++++------
 contrib/hdtbl/groff_hdtbl.7.man               | 22 ++++++------
 contrib/mm/groff_mm.7.man                     | 21 ++++++-----
 contrib/mm/mmroff.1.man                       | 22 ++++++------
 contrib/mom/groff_mom.7.man                   | 48 ++++++++++++-------------
 contrib/pdfmark/pdfroff.1.man                 | 23 ++++++------
 contrib/pic2graph/pic2graph.1.man             | 21 +++++------
 man/ditroff.7.man                             | 28 +++++++--------
 man/groff.7.man                               | 28 +++++++--------
 man/groff_char.7.man                          | 44 +++++++++++------------
 man/groff_diff.7.man                          | 36 +++++++++----------
 man/groff_out.5.man                           | 26 ++++++++------
 man/groff_tmac.5.man                          | 26 +++++++-------
 man/roff.7.man                                | 27 +++++++-------
 src/devices/gropdf/pdfmom.1.man               | 29 ++++++++-------
 src/devices/xditview/gxditview.1.man          | 34 +++++++++---------
 src/preproc/grn/grn.1.man                     | 25 ++++++-------
 src/roff/groff/groff.1.man                    | 42 +++++++++++-----------
 src/roff/grog/grog.1.man                      | 35 +++++++++---------
 src/roff/troff/troff.1.man                    | 32 +++++++++--------
 tmac/groff_man.7.man                          | 51 +++++++++++++++------------
 tmac/groff_ms.7.man                           | 23 ++++++------
 tmac/groff_trace.7.man                        | 23 ++++++------
 tmac/groff_www.7.man                          | 23 +++++++-----
 31 files changed, 432 insertions(+), 417 deletions(-)

diff --git a/contrib/chem/chem.1.man b/contrib/chem/chem.1.man
index 7910e72..b0c26b7 100644
--- a/contrib/chem/chem.1.man
+++ b/contrib/chem/chem.1.man
@@ -26,14 +26,6 @@ The license text for GPL2 is available in the internet at
 .UE .
 ..
 .
-.de au
-This file was written by Bernd Warken <address@hidden>.
-
-It is based on the documentation of Brian Kernighan's original awk
-version of chem at
-.UR http://cm.bell-labs.com/cm/cs/who/bwk/index.html
-.UE .
-..
 .
 .\" ====================================================================
 .\" Setup
@@ -964,6 +956,25 @@ for information on availability.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+The GNU version of
+.B chem
+was written by
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+It is based on the documentation of Brian Kernighan's original
+.I awk
+version of
+.I chem
+at
+.UR http://cm.bell\-labs.com/\:cm/cs/who/bwk/index.html
+.UE .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -996,10 +1007,6 @@ is
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/contrib/gdiffmk/gdiffmk.1.man b/contrib/gdiffmk/gdiffmk.1.man
index 325f8e5..34e81bf 100644
--- a/contrib/gdiffmk/gdiffmk.1.man
+++ b/contrib/gdiffmk/gdiffmk.1.man
@@ -27,12 +27,6 @@ You should have received a copy of the GNU General Public 
License
 along with this program.  If not, see <http://www.gnu.org/licenses/>.
 ..
 .
-.de au
-This document was written and is maintained by
-.MT address@hidden
-Mike Bianchi
-.ME .
-..
 .
 .\" ====================================================================
 .SH SYNOPSIS
@@ -269,7 +263,11 @@ you are using.
 .\" ====================================================================
 .SH AUTHORS
 .\" ====================================================================
-.au
+.B gdiffmk
+was written and is maintained by
+.MT address@hidden
+Mike Bianchi
+.ME .
 .
 .
 .\" ====================================================================
diff --git a/contrib/glilypond/glilypond.1.man 
b/contrib/glilypond/glilypond.1.man
index 956f1a0..06a1015 100644
--- a/contrib/glilypond/glilypond.1.man
+++ b/contrib/glilypond/glilypond.1.man
@@ -31,12 +31,6 @@ The license text is available in the internet at
 .UE .
 ..
 .
-.de au
-This document was written by
-.MT address@hidden
-Bernd Warken
-.ME .
-..
 .
 .\" ====================================================================
 .\" Characters
@@ -870,6 +864,16 @@ stored into a file by given the option
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B glilypond
+was written by
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -938,10 +942,6 @@ format.
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .\" ====================================================================
diff --git a/contrib/gperl/gperl.1.man b/contrib/gperl/gperl.1.man
index 936a0ba..fa6b179 100644
--- a/contrib/gperl/gperl.1.man
+++ b/contrib/gperl/gperl.1.man
@@ -8,13 +8,6 @@ gperl \- groff preprocessor for Perl parts in roff files
 .\" Legalese
 .\" ====================================================================
 .
-.de au
-This file was written by
-.MT address@hidden
-Bernd Warken
-.ME .
-..
-.
 .de co
 Copyright \[co] 2014 Free Software Foundation, Inc.
 .
@@ -482,6 +475,16 @@ command lines are created:
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B gperl
+was written by
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -508,10 +511,6 @@ are
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .\" ====================================================================
diff --git a/contrib/gpinyin/gpinyin.1.man b/contrib/gpinyin/gpinyin.1.man
index 161aae9..fe2465a 100644
--- a/contrib/gpinyin/gpinyin.1.man
+++ b/contrib/gpinyin/gpinyin.1.man
@@ -26,9 +26,6 @@ The license text is available in the internet at
 .UE .
 ..
 .
-.de au
-This file was written by Bernd Warken <address@hidden>.
-..
 .
 .\" ====================================================================
 .\" Characters
@@ -295,6 +292,16 @@ numbers 0 or 5 must be written.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B gpinyin
+was written by
+.MT <address@hidden>
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -400,10 +407,6 @@ py\-vowels.htm
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .\" ====================================================================
diff --git a/contrib/groff_filenames/groff_filenames.5.man 
b/contrib/groff_filenames/groff_filenames.5.man
index f5292d6..4139a38 100644
--- a/contrib/groff_filenames/groff_filenames.5.man
+++ b/contrib/groff_filenames/groff_filenames.5.man
@@ -24,12 +24,6 @@ The license text can be found in the internet at
 .UE .
 ..
 .
-.de au
-This file was written by
-.MT address@hidden
-Bernd Warken
-.ME .
-..
 .
 .\" ====================================================================
 .SH DESCRIPTION
@@ -600,6 +594,15 @@ system
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+This document was written by
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -654,10 +657,6 @@ You can get this package with the shell command:
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .\" ====================================================================
diff --git a/contrib/groffer/groffer.1.man b/contrib/groffer/groffer.1.man
index 82b7e5b..0d5dbef 100644
--- a/contrib/groffer/groffer.1.man
+++ b/contrib/groffer/groffer.1.man
@@ -36,12 +36,6 @@ The license text is available in the internet at
 .UE .
 ..
 .
-.de au
-This file was written by
-.MT address@hidden
-Bernd Warken
-.ME .
-..
 .
 .\" ====================================================================
 .\" Characters
@@ -3705,6 +3699,16 @@ for information on availability.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B groffer
+was written by
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -3884,10 +3888,6 @@ The decompression programs supported by
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .\" ====================================================================
diff --git a/contrib/groffer/roff2.1.man b/contrib/groffer/roff2.1.man
index 035a560..b404f34 100644
--- a/contrib/groffer/roff2.1.man
+++ b/contrib/groffer/roff2.1.man
@@ -27,12 +27,6 @@ The license text is available in the internet at
 .UE .
 ..
 .
-.de au
-This file was written by
-.MT address@hidden
-Bernd Warken
-.ME .
-..
 .
 .\" ====================================================================
 .\" Characters
@@ -192,6 +186,16 @@ or
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B address@hidden@
+was written by
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -216,10 +220,6 @@ or
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHOR"
-.\" ====================================================================
-.au
 .
 .
 .\" ====================================================================
diff --git a/contrib/hdtbl/groff_hdtbl.7.man b/contrib/hdtbl/groff_hdtbl.7.man
index 9604c52..daaee8a 100644
--- a/contrib/hdtbl/groff_hdtbl.7.man
+++ b/contrib/hdtbl/groff_hdtbl.7.man
@@ -26,13 +26,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
-This document was written by
-.MT address@hidden
-Joachim Walsdorff
-.ME .
-..
-.
 .
 .ig
   Some simple formatting macros.  Note that we use `.ig' here and not a
@@ -1256,13 +1249,20 @@ or directly to the author.
 .
 .
 .\" ====================================================================
-.SH COPYING
+.SH AUTHORS
 .\" ====================================================================
-.co
+The
+.B hdtbl
+macro package was written by
+.MT address@hidden
+Joachim Walsdorff
+.ME .
+.
+.
 .\" ====================================================================
-.SH AUTHORS
+.SH COPYING
 .\" ====================================================================
-.au
+.co
 .
 .
 .cp \n[groff_C]
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 339abc8..cf145f7 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -27,11 +27,6 @@ translations approved by the Free Software Foundation 
instead of in
 the original English.
 ..
 .
-.de au
-.MT address@hidden
-J\[:o]rgen H\[:a]gg, Lund, Sweden
-.ME .
-..
 .
 .\" ====================================================================
 .SH SYNOPSIS
@@ -3956,6 +3951,18 @@ then assigns the argument to the string variable
 .B @TMAC_MDIR@/locale
 .
 .
+.\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+The GNU version of the
+.I mm
+macro package was written by
+.MT address@hidden
+J\[:o]rgen H\[:a]gg
+.ME
+of Lund, Sweden.
+.
+.
 .na
 .\" ====================================================================
 .SH "SEE ALSO"
@@ -3974,10 +3981,6 @@ then assigns the argument to the string variable
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHOR
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/contrib/mm/mmroff.1.man b/contrib/mm/mmroff.1.man
index 3ad6d09..ad6f936 100644
--- a/contrib/mm/mmroff.1.man
+++ b/contrib/mm/mmroff.1.man
@@ -26,12 +26,6 @@ translations approved by the Free Software Foundation 
instead of in
 the original English.
 ..
 .
-.de au
-This document was written by
-.MT address@hidden
-J�rgen H�gg, Lund, Sweden
-.ME .
-..
 .
 .\" ====================================================================
 .SH SYNOPSIS
@@ -95,6 +89,17 @@ will only be run once.
 .B @TMAC_MDIR@/locale
 .
 .
+.\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B mmroff
+was written by
+.MT address@hidden
+J�rgen H�gg
+.ME
+of Lund, Sweden.
+.
+.
 .na
 .\" ====================================================================
 .SH "SEE ALSO"
@@ -113,11 +118,6 @@ will only be run once.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
-.
 .
 .
 .\" Local Variables:
diff --git a/contrib/mom/groff_mom.7.man b/contrib/mom/groff_mom.7.man
index 488208f..e0c3eff 100644
--- a/contrib/mom/groff_mom.7.man
+++ b/contrib/mom/groff_mom.7.man
@@ -32,26 +32,6 @@ Or read the man page
 You can also visit <http://www.gnu.org/licenses/>.
 ..
 .
-.de au
-mom was written by
-.MT address@hidden
-Peter Schaffter
-.ME
-and revised by
-.MT address@hidden
-Werner Lemberg
-.ME .
-
-PDF support was provided by
-.MT address@hidden
-Deri James
-.ME .
-
-The alphabetical documentation of macros and escape seqauences in this
-man page were written by the
-.I mom
-team.
-..
 .
 .\" ====================================================================
 .\" Setup
@@ -3365,6 +3345,30 @@ after NEWPAGE, like this:
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.I mom
+was written by
+.MT address@hidden
+Peter Schaffter
+.ME
+and revised by
+.MT address@hidden
+Werner Lemberg
+.ME .
+.
+PDF support was provided by
+.MT address@hidden
+Deri James
+.ME .
+.
+The alphabetical documentation of macros and escape seqauences in this
+man page were written by the
+.I mom
+team.
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -3401,10 +3405,6 @@ or directly to the authors.
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_mom_C]
diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index cfa1726..a510318 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -39,15 +39,6 @@ the GNU copyleft site
 .UE .
 ..
 .
-.de au
-It was originally written by
-.MT address@hidden:ntlworld.com
-Keith Marshall
-.ME ,
-who also wrote the implementation of the
-.I pdfroff
-program, to which it relates.
-..
 .
 .\" ====================================================================
 .\" Local macro definitions
@@ -799,6 +790,16 @@ in the proper sequence,
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B pdfroff
+was written by
+.MT address@hidden:ntlworld.com
+Keith Marshall
+.ME .
+.
+.
+.\" ====================================================================
 .SH SEE ALSO
 .\" ====================================================================
 .
@@ -846,10 +847,6 @@ included in the installed documentation set as
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/contrib/pic2graph/pic2graph.1.man 
b/contrib/pic2graph/pic2graph.1.man
index 4d4fc23..5fbb774 100644
--- a/contrib/pic2graph/pic2graph.1.man
+++ b/contrib/pic2graph/pic2graph.1.man
@@ -11,12 +11,6 @@ pic2graph \- convert a PIC diagram into a cropped image
 This documentation is released to the public domain.
 ..
 .
-.de au
-.MT address@hidden
-Eric S.\& Raymond
-.ME ,
-based on a recipe by W.\& Richard Stevens.
-..
 .
 .\" ====================================================================
 .SH SYNOPSIS
@@ -211,6 +205,17 @@ which no longer has trimming behavior.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B pic2graph
+was written by
+.MT address@hidden
+Eric S.\& Raymond
+.ME ,
+based on a recipe by W.\& Richard Stevens.
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -227,10 +232,6 @@ which no longer has trimming behavior.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .\" Local Variables:
diff --git a/man/ditroff.7.man b/man/ditroff.7.man
index cc3cf80..f3f6f87 100644
--- a/man/ditroff.7.man
+++ b/man/ditroff.7.man
@@ -22,16 +22,7 @@ available on-line at the
 GNU copyleft site
 .UE .
 ..
-.de au
-It was written by
-.MT address@hidden:web.de
-Bernd Warken
-.ME
-and is maintained by
-.MT address@hidden:gnu.org
-Werner Lemberg
-.ME .
-..
+.
 .
 .\" ====================================================================
 .SH DESCRIPTION
@@ -109,6 +100,19 @@ that automatically handles postprocessing.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+This document was written by
+.MT address@hidden:web.de
+Bernd Warken
+.ME
+and is maintained by
+.MT address@hidden:gnu.org
+Werner Lemberg
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -160,10 +164,6 @@ multi-devicing.
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .\" Local Variables:
 .\" mode: nroff
 .\" End:
diff --git a/man/groff.7.man b/man/groff.7.man
index e1949cc..9c9c9a1 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -29,16 +29,6 @@ available in the internet at
 .UE .
 ..
 .
-.de au
-This documentation was written by
-.MT address@hidden
-Bernd Warken
-.ME
-and is appended and maintained by
-.MT address@hidden
-Werner Lemberg
-.ME .
-..
 .
 .\" ====================================================================
 .\" Setup
@@ -4578,6 +4568,19 @@ be reproduced, and say which version of groff you are 
using.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+This document was written by
+.MT address@hidden
+Bernd Warken
+.ME
+and is updated and maintained by
+.MT address@hidden
+Werner Lemberg
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -4650,10 +4653,7 @@ documentations and other information.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
+.
 .
 .cp \n[groff_C]
 .
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index 63a876d..d51f38e 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -35,25 +35,6 @@ GPL2
 .UE .
 ..
 .
-.de au
-This document was written by
-.MT address@hidden
-James Clark
-.ME
-with additions by
-.MT address@hidden
-Werner Lemberg
-.ME
-and
-.MT address@hidden
-Bernd Warken
-.ME .
-.
-This document was revised to use real tables by
-.MT address@hidden
-Eric S. Raymond
-.ME .
-..
 .
 .\" ====================================================================
 .\" Setup
@@ -1331,6 +1312,27 @@ _
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+This document was written by
+.MT address@hidden
+James Clark
+.ME ,
+with additions by
+.MT address@hidden
+Werner Lemberg
+.ME
+and
+.MT address@hidden
+Bernd Warken
+.ME ,
+and revised to use real tables by
+.MT address@hidden
+Eric S.\& Raymond
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -1359,10 +1361,6 @@ The Unicode Standard
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_char_C]
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 0d06494..2f3b4a9 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -34,21 +34,6 @@ GNU FDL license
 .UE .
 ..
 .
-.de au
-This document was written by
-.MT address@hidden
-James Clark
-.ME ,
-was modified by
-.MT address@hidden
-Werner Lemberg
-.ME
-and
-.MT address@hidden
-Bernd Warken
-.ME .
-..
-.
 .
 .\" ====================================================================
 .\" Local definitions
@@ -3907,6 +3892,23 @@ classical \[oq]device-independent\[cq] troff did.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+This document was written by
+.MT address@hidden
+James Clark
+.ME
+and modified by
+.MT address@hidden
+Werner Lemberg
+.ME
+and
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -3962,10 +3964,6 @@ classical troff documentation
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/man/groff_out.5.man b/man/groff_out.5.man
index a520296..fb58b11 100644
--- a/man/groff_out.5.man
+++ b/man/groff_out.5.man
@@ -37,13 +37,6 @@ GNU FDL license
 .UE .
 ..
 .
-.de au
-In 2001, this document was rewritten from scrach by
-.MT address@hidden
-Bernd Warken
-.ME .
-..
-.
 .
 .\" ====================================================================
 .\" Setup
@@ -1857,6 +1850,21 @@ format.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+James Clark wrote an early version of this document, which described
+only the differences between
+.BR ditroff (7)'s
+output format and that of GNU
+.IR roff .
+.
+The present version was completely rewritten in 2001 by
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -2000,10 +2008,6 @@ CSTR\~#54
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/man/groff_tmac.5.man b/man/groff_tmac.5.man
index b405179..17df424 100644
--- a/man/groff_tmac.5.man
+++ b/man/groff_tmac.5.man
@@ -32,16 +32,6 @@ GNU copyleft site
 .UE .
 ..
 .
-.de au
-This file was written by
-.MT address@hidden
-Bernd Warken
-.ME
-and
-.MT address@hidden
-Werner Lemberg
-.ME .
-..
 .
 .ds Ellipsis \&.\|.\|.\&\"
 .
@@ -1270,6 +1260,17 @@ See the previous section for a detailed description.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+This document was written by
+.MT address@hidden
+Bernd Warken
+.ME
+and
+.MT address@hidden
+Werner Lemberg
+.ME .
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -1319,10 +1320,7 @@ FHS web site
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHOR
-.\" ====================================================================
-.au
+.
 .
 .cp \n[groff_C]
 .
diff --git a/man/roff.7.man b/man/roff.7.man
index b3be147..90e7bb7 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -32,16 +32,6 @@ GNU copyleft site
 .UE .
 ..
 .
-.de au
-This man page was written by
-.MT address@hidden
-Bernd Warken
-.ME
-and is maintained by
-.MT address@hidden
-Werner Lemberg
-.ME .
-..
 .
 .\" ====================================================================
 .\" Local macros
@@ -1144,6 +1134,19 @@ program.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+This document was written by
+.MT address@hidden
+Bernd Warken
+.ME
+and is maintained by
+.MT address@hidden
+Werner Lemberg
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -1368,10 +1371,6 @@ might be a good starting point.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/src/devices/gropdf/pdfmom.1.man b/src/devices/gropdf/pdfmom.1.man
index 7745cd6..6854124 100644
--- a/src/devices/gropdf/pdfmom.1.man
+++ b/src/devices/gropdf/pdfmom.1.man
@@ -25,17 +25,6 @@ versions, except that this permission notice may be included 
in
 translations approved by the Free Software Foundation instead of in
 the original English.
 ..
-.de au
-This document was written by
-.MT address@hidden
-Deri James
-.ME
-and
-.MT address@hidden
-Peter Schaffter
-.ME .
-..
-.
 .\" ====================================================================
 .SH SYNOPSIS
 .\" ====================================================================
@@ -152,6 +141,20 @@ This is more of an annoyance than a bug, and may safely be 
ignored.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B pfdmom
+was written by
+.MT address@hidden
+Deri James
+.ME
+and
+.MT address@hidden
+Peter Schaffter
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -164,10 +167,6 @@ This is more of an annoyance than a bug, and may safely be 
ignored.
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .\" Local Variables:
diff --git a/src/devices/xditview/gxditview.1.man 
b/src/devices/xditview/gxditview.1.man
index 62b4fc0..3c8fe6d 100644
--- a/src/devices/xditview/gxditview.1.man
+++ b/src/devices/xditview/gxditview.1.man
@@ -15,20 +15,6 @@ See
 for a full statement of rights and permissions.
 ..
 .
-.de au
-Keith Packard (MIT X Consortium)
-.br
-Richard L.\& Hyde (Purdue)
-.br
-David Slattengren (Berkeley)
-.br
-Malcolm Slaney (Schlumberger Palo Alto Research)
-.br
-Mark Moraes (University of Toronto)
-.br
-James Clark
-..
-.
 .\" ====================================================================
 .SH SYNOPSIS
 .\" ====================================================================
@@ -503,6 +489,22 @@ for more.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B gxditview
+and its predecessor
+.B xditview
+were written by
+Keith Packard (MIT X Consortium),
+Richard L.\& Hyde (Purdue),
+David Slattengren (Berkeley),
+Malcolm Slaney (Schlumberger Palo Alto Research),
+Mark Moraes (University of Toronto),
+and
+James Clark.
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -531,10 +533,6 @@ which was derived from
 .SH COPYRIGHT
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .\" Local Variables:
diff --git a/src/preproc/grn/grn.1.man b/src/preproc/grn/grn.1.man
index fa43592..c242542 100644
--- a/src/preproc/grn/grn.1.man
+++ b/src/preproc/grn/grn.1.man
@@ -28,16 +28,6 @@ translations approved by the Free Software Foundation 
instead of in
 the original English.
 ..
 .
-.\" authors
-.de au
-David Slattengren and Barry Roitblat wrote the original Berkeley
-.IR @address@hidden .
-.
-.PP
-Daniel Senderowicz and Werner Lemberg modified it for
-.IR groff .
-..
-.
 .\" ====================================================================
 .\" Definitons
 .\" ====================================================================
@@ -791,6 +781,16 @@ Device description file for device
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+David Slattengren and Barry Roitblat wrote the original Berkeley
+.IR grn .
+.
+Daniel Senderowicz and Werner Lemberg modified it for
+.IR groff .
+.
+.
+.\" ====================================================================
 .SH SEE ALSO
 .\" ====================================================================
 .
@@ -804,10 +804,7 @@ Device description file for device
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
+.
 .
 .cp \n[grn_C]
 .
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 382dff1..5919b35 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -36,24 +36,6 @@ GNU copyleft site
 .UE .
 ..
 .
-.\" Authors
-.de au
-This document is based on the original
-.I groff
-man page written by
-.MT address@hidden
-James Clark
-.UE .
-.
-It was rewritten, enhanced, and put under the FDL license by
-Bernd Warken <address@hidden>.
-.
-It is maintained by
-.MT address@hidden
-Werner Lemberg
-.ME .
-..
-.
 .\" ====================================================================
 .\" Definitions
 .\" ====================================================================
@@ -1876,6 +1858,26 @@ This is the only grap version supported by
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B groff
+was written by
+.MT address@hidden
+James Clark
+.ME .
+.
+This document was rewritten, enhanced, and put under the FDL license by
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+It is maintained by
+.MT address@hidden
+Werner Lemberg
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .ad l
@@ -2026,10 +2028,6 @@ The following utilities are available:
 .SH COPYING (LICENSE)
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/src/roff/grog/grog.1.man b/src/roff/grog/grog.1.man
index 13df30b..838055d 100644
--- a/src/roff/grog/grog.1.man
+++ b/src/roff/grog/grog.1.man
@@ -33,20 +33,6 @@ GNU copyleft site
 .UE .
 ..
 .
-.de au
-Written by James Clark.
-
-Maintained by
-.MT address@hidden
-Werner Lemberg
-.ME .
-
-Rewritten and put under GPL by
-.MT address@hidden
-Bernd Warken
-.ME .
-..
-.
 .\" ====================================================================
 .\" Characters
 .\" ====================================================================
@@ -448,6 +434,23 @@ this file does not use a macro package.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+.B grog
+was originally written by James Clark.
+.
+The current Perl implementation was written by
+.MT address@hidden
+Bernd Warken
+.ME
+with contributions from Ralph Corderoy,
+and is maintained by
+.MT address@hidden
+Werner Lemberg
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -506,10 +509,6 @@ for graphical mode (default is PDF mode).
 .SH "COPYING"
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH "AUTHORS"
-.\" ====================================================================
-.au
 .
 .
 .\" ====================================================================
diff --git a/src/roff/troff/troff.1.man b/src/roff/troff/troff.1.man
index adf2d4b..0359d12 100644
--- a/src/roff/troff/troff.1.man
+++ b/src/roff/troff/troff.1.man
@@ -26,17 +26,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
-This file was originally written by James Clark, it was modified by
-.MT address@hidden
-Werner Lemberg
-.ME
-and
-.MT address@hidden
-Bernd Warken
-.ME .
-..
-.
 .\" ====================================================================
 .SH SYNOPSIS
 .\" ====================================================================
@@ -616,6 +605,23 @@ necessary.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+The GNU version of
+.I troff
+was originally written by James Clark;
+he also wrote the original version of this document,
+which was modified by
+.MT address@hidden
+Werner Lemberg
+.ME
+and
+.MT address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -674,10 +680,6 @@ presents all groff documentation within a single document.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .\" ====================================================================
diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index afde8dd..44989e5 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -30,24 +30,6 @@ translations approved by the Free Software Foundation 
instead of in
 the original English.
 ..
 .
-.de au
-This manual page was originally written for the Debian GNU/Linux
-system by
-.MT address@hidden
-Susan G.\& Kleinmann
-.ME .
-
-It was corrected and updated by
-.MT address@hidden
-Werner Lemberg
-.ME .
-
-The extension macros were documented (and partly designed) by
-.MT address@hidden
-Eric S.\& Raymond
-.ME ;
-he also wrote the portability advice.
-..
 .
 .\" ====================================================================
 .SH SYNOPSIS
@@ -1458,6 +1440,35 @@ Local changes and customizations should be put into this 
file.
 .
 .ad l
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+The GNU version of the
+.I man
+macro package was written by James Clark and contributors.
+.
+The extension macros were written by
+.MT address@hidden
+Werner Lemberg
+.ME
+and
+.MT address@hidden
+Eric S.\& Raymond
+.ME .
+.
+.
+.PP
+This document was originally written for the Debian GNU/Linux system by
+.MT address@hidden
+Susan G.\& Kleinmann
+.ME .
+.
+It was corrected and updated by Werner Lemberg.
+.
+The extension macros were documented (and partly designed) by
+Eric S.\& Raymond; he also originated the portability advice.
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .BR @address@hidden (@MAN1EXT@),
@@ -1472,10 +1483,6 @@ Local changes and customizations should be put into this 
file.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 400f340..8e3ee8e 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -29,12 +29,6 @@ translations approved by the Free Software Foundation 
instead of in
 the original English.
 ..
 .
-.de au
-Original manual page by James Clark et al., rewritten by
-.MT address@hidden
-Larry Kollar
-.ME .
-..
 .
 .\" ====================================================================
 .SH SYNOPSIS
@@ -1775,6 +1769,19 @@ Names containing only uppercase letters and digits.
 .
 .
 .\" ====================================================================
+.SH AUTHORS
+.\" ====================================================================
+The GNU version of the
+.I ms
+macro package was written by James Clark and contributors.
+.
+This document was (re-)written by
+.MT address@hidden
+Larry Kollar
+.ME .
+.
+.
+.\" ====================================================================
 .ad l
 .SH "SEE ALSO"
 .\" ====================================================================
@@ -1793,10 +1800,6 @@ by Trent Fisher and Werner Lemberg.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_ms_C]
diff --git a/tmac/groff_trace.7.man b/tmac/groff_trace.7.man
index 9e8a7be..5bd6a5d 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 address@hidden
-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 address@hidden
+Bernd Warken
+.ME .
+.
+.
+.\" ====================================================================
 .SH "SEE ALSO"
 .\" ====================================================================
 .
@@ -321,10 +328,6 @@ file.
 .SH COPYING
 .\" ====================================================================
 .co
-.\" ====================================================================
-.SH AUTHORS
-.\" ====================================================================
-.au
 .
 .
 .cp \n[groff_C]
diff --git a/tmac/groff_www.7.man b/tmac/groff_www.7.man
index c9030fa..ea22a23 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 address@hidden "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 address@hidden:glam.ac.uk "Gaius Mulley" ,
+with additions by
+.MTO address@hidden:gnu.org "Werner Lemberg"
+and
+.MTO address@hidden: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]



reply via email to

[Prev in Thread] Current Thread [Next in Thread]