[groff] 01/01: manuals: Elaborate names of old macro packages.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 117113104468fa6e0f5c63fa6d0febdbe88da826
Author: G. Branden Robinson <address@hidden>
Date:   Fri Nov 3 11:31:02 2017 -0400

    manuals: Elaborate names of old macro packages.
    
    Rewrite "apropos lines" of man pages documenting venerable macro
    packages to give more information and aid in keyword-based searching.
    
    Also use en-dash in copyright year ranges.
    
    Also add Vim modelines.
    
    mmroff(1):
    * Fix minor markup problems.
      + Option should be in bold; it's not a variable.
      + Style variable-text phrases with hyphens, not underscores.
      + Use semicolons to fix comma splices.
    * Actually call the local .au macro to display author information.
    
    Signed-off-by: G. Branden Robinson <address@hidden>
---
 contrib/mm/groff_mm.7.man   |  4 ++--
 contrib/mm/groff_mmse.7.man |  5 +++--
 contrib/mm/mmroff.1.man     | 14 ++++++++------
 tmac/groff_man.7.man        |  5 ++---
 tmac/groff_me.7.man         |  2 +-
 tmac/groff_ms.7.man         |  5 +++--
 6 files changed, 19 insertions(+), 16 deletions(-)

diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 67a6983..44ab263 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -1,7 +1,7 @@
 '\" t
 .TH GROFF_MM @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
 .SH NAME
-groff_mm \- groff mm macros
+groff_mm \- memorandum macros for GNU roff
 .
 .
 .do nr groff_C \n[.C]
@@ -9,7 +9,7 @@ groff_mm \- groff mm macros
 .
 .
 .de co
-Copyright \[co] 1989-2014 Free Software Foundation, Inc.
+Copyright \[co] 1989\[en]2014 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
diff --git a/contrib/mm/groff_mmse.7.man b/contrib/mm/groff_mmse.7.man
index 72b39e8..27b6e78 100644
--- a/contrib/mm/groff_mmse.7.man
+++ b/contrib/mm/groff_mmse.7.man
@@ -1,7 +1,7 @@
 .TH GROFF_MMSE @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
 .
 .SH NAMN
-groff_mmse \- svenska mm makro f�r groff
+groff_mmse \- svenska `memorandum' makro f�r GNU roff
 .
 .
 .do nr groff_C \n[.C]
@@ -9,7 +9,7 @@ groff_mmse \- svenska mm makro f
 .
 .
 .ig
-Copyright \[co] 1989-2014 Free Software Foundation, Inc.
+Copyright \[co] 1989\[en]2014 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -168,3 +168,4 @@ J
 .\" coding: latin-1
 .\" mode: nroff
 .\" End:
+.\" vim: set filetype=groff:
diff --git a/contrib/mm/mmroff.1.man b/contrib/mm/mmroff.1.man
index 4e4256c..a131364 100644
--- a/contrib/mm/mmroff.1.man
+++ b/contrib/mm/mmroff.1.man
@@ -1,6 +1,6 @@
 .TH MMROFF @MAN1EXT@ "@MDATE@" "Groff Version @VERSION@"
 .SH NAME
-mmroff \- cross reference preprocessor
+mmroff \- cross-reference preprocessor for GNU roff mm macro package
 .
 .
 .\" --------------------------------------------------------------------
@@ -8,7 +8,7 @@ mmroff \- cross reference preprocessor
 .\" --------------------------------------------------------------------
 .
 .de co
-Copyright \(co 1989-2014 Free Software Foundation, Inc.
+Copyright \[co] 1989\[en]2014 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -39,9 +39,9 @@ J
 .
 .B mmroff
 [
-.I \-x
+.B \-x
 ]
-.I groff_arguments
+.I groff-arguments
 .
 .
 .\" --------------------------------------------------------------------
@@ -50,7 +50,7 @@ J
 .
 .B mmroff
 is a simple preprocessor for
-.BR groff ,
+.BR groff ;
 it is used for expanding cross references in
 .BR address@hidden@m ,
 see
@@ -69,7 +69,7 @@ when the cross reference file is up to date.
 .B \-x
 Just create the cross reference file.
 .
-This can be used to refresh the cross reference file, it isn't
+This can be used to refresh the cross reference file; it isn't
 always needed to have accurate cross references and by using this
 option
 .B groff
@@ -116,6 +116,7 @@ will only be run once.
 .\" --------------------------------------------------------------------
 .SH AUTHORS
 .\" --------------------------------------------------------------------
+.au
 .
 .
 .
@@ -123,3 +124,4 @@ will only be run once.
 .\" mode: nroff
 .\" coding: latin-1
 .\" End:
+.\" vim: set filetype=groff:
diff --git a/tmac/groff_man.7.man b/tmac/groff_man.7.man
index 8856fcd..ebf9a5d 100644
--- a/tmac/groff_man.7.man
+++ b/tmac/groff_man.7.man
@@ -1,7 +1,6 @@
-.\" -*- nroff -*-
 .TH GROFF_MAN @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
 .SH NAME
-groff_man \- groff man macros to support generation of man pages
+groff_man \- GNU roff macro package for formatting man pages
 .
 .
 .do nr groff_C \n[.C]
@@ -13,7 +12,7 @@ groff_man \- groff man macros to support generation of man 
pages
 .\" --------------------------------------------------------------------
 .
 .de co
-Copyright \[co] 1999-2014 Free Software Foundation, Inc.
+Copyright \[co] 1999\[en]2014 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of this
 manual provided the copyright notice and this permission notice are
diff --git a/tmac/groff_me.7.man b/tmac/groff_me.7.man
index 2a54bfd..f1fae60 100644
--- a/tmac/groff_me.7.man
+++ b/tmac/groff_me.7.man
@@ -3,7 +3,7 @@
 .TH GROFF_ME @MAN7EXT@ "@MDATE@" "@VERSION@"
 .UC 3
 .SH NAME
-groff_me \- troff macros for formatting papers
+groff_me \- \(lqme\(rq macro package for formatting documents with GNU roff
 .
 .
 .\" Copyright (C) 1980 The Regents of the University of California.
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 8942e00..f333e14 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -3,7 +3,7 @@
 .cp 0
 .TH GROFF_MS @MAN7EXT@ "@MDATE@" "Groff Version @VERSION@"
 .SH NAME
-groff_ms \- groff ms macros
+groff_ms \- GNU roff manuscript macro package for formatting documents
 .
 .
 .\" --------------------------------------------------------------------
@@ -11,7 +11,7 @@ groff_ms \- groff ms macros
 .\" --------------------------------------------------------------------
 .
 .de co
-Copyright \[co] 1989-2014 Free Software Foundation, Inc.
+Copyright \[co] 1989\[en]2014 Free Software Foundation, Inc.
 
 Permission is granted to make and distribute verbatim copies of
 this manual provided the copyright notice and this permission notice
@@ -1805,3 +1805,4 @@ by Trent Fisher and Werner Lemberg.
 .\" Local Variables:
 .\" mode: nroff
 .\" End:
+.\" vim: set filetype=groff: