[groff] 02/06: [docs]: Make cosmetic cleanups.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 005406f0d15e763c0d325c2779bc6b455c14e78b
Author: Dave Kemper <saint.snit@gmail.com>
AuthorDate: Fri Oct 30 00:45:32 2020 +0000

    [docs]: Make cosmetic cleanups.
    
    * NEWS:
    * contrib/groff_filenames/groff_filenames.5.man:
    * src/devices/grops/grops.1.man:
    * src/preproc/preconv/preconv.1.man
    * tmac/groff_man.7.man.in: Update with mostly trivial punctuation fixes,
      tightening of the wording, and standardizing of idioms.
    
    Fixes <https://savannah.gnu.org/bugs/?59382>.
---
 NEWS                                          |  2 +-
 contrib/groff_filenames/groff_filenames.5.man |  4 ++--
 src/devices/grops/grops.1.man                 | 10 +++++-----
 src/preproc/preconv/preconv.1.man             |  2 +-
 tmac/groff_man.7.man.in                       |  8 ++++----
 5 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/NEWS b/NEWS
index 7763cfb..5155743 100644
--- a/NEWS
+++ b/NEWS
@@ -196,7 +196,7 @@ o PDFPIC has been corrected so the behaviour is the same 
whether you use
   can set an environment variable "export GROFF_PDFPIC_NOSPACE=1" which
   will restore the previous behaviour for all runs.
 
-  Note that this change has no effect if you were using .PDFPIC with the
+  This change has no effect if you were using .PDFPIC with the
   PostScript driver--only if you used it with the PDF driver.
 
 Gropdf
diff --git a/contrib/groff_filenames/groff_filenames.5.man 
b/contrib/groff_filenames/groff_filenames.5.man
index 3a1cab2..1c3025f 100644
--- a/contrib/groff_filenames/groff_filenames.5.man
+++ b/contrib/groff_filenames/groff_filenames.5.man
@@ -102,7 +102,7 @@ are widely called
 .
 The
 .I man page
-style is the best known part of the
+style is the best-known part of the
 .I roff
 language.
 .
@@ -405,7 +405,7 @@ macro package.
 .P
 In the
 .B groff
-source, more suitable file names were integrated, see later on.
+source, more suitable file names were integrated; see later on.
 .
 .
 .\" ====================================================================
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 59f8403..30ba5db 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -203,7 +203,7 @@ requires page reversal.
 .
 .IP
 Add\~16 if no media size information should be included in the
-document (this is, neither use
+document (that is, neither use
 .B %%Document\%Media
 nor the
 .B setpagedevice
@@ -1009,7 +1009,7 @@ If the height argument is omitted it is scaled uniformly 
in the
 x and y\~directions so that it has the specified width.
 .
 .IP
-Note that the contents of the
+The contents of the
 .B \[rs]X
 command are not interpreted by
 .BR troff ;
@@ -1285,8 +1285,8 @@ option.
 .SH "Font Installation"
 .\" ====================================================================
 .
-This section gives a summary of the above explanations; it can serve
-as a step-by-step font installation guide for
+This section summarizes the above explanations; it can serve as a
+step-by-step font-installation guide for
 .BR grops .
 .
 .IP \(bu
@@ -1318,7 +1318,7 @@ The very first characters in a Type\~42 font file look 
like this:
 .IP
 This is a wrapper format for TrueType fonts.
 .
-Old PS printers might not support it (this is, they don't have a
+Old PS printers might not support it (that is, they might not have a
 built-in TrueType font interpreter).
 .
 .IP
diff --git a/src/preproc/preconv/preconv.1.man 
b/src/preproc/preconv/preconv.1.man
index dde9da5..2f7b66b 100644
--- a/src/preproc/preconv/preconv.1.man
+++ b/src/preproc/preconv/preconv.1.man
@@ -236,7 +236,7 @@ supports the coding tag convention
 (with some restrictions)
 used by GNU\~Emacs.
 .
-These are indicated in specially-marked regions of an input file
+These are indicated in specially marked regions of an input file
 designated for \[lq]file-local variables\[rq].
 .
 .
diff --git a/tmac/groff_man.7.man.in b/tmac/groff_man.7.man.in
index 2de24b1..acd2c80 100644
--- a/tmac/groff_man.7.man.in
+++ b/tmac/groff_man.7.man.in
@@ -1059,8 +1059,8 @@ repeated arbitrarily.
 .
 .
 .IP
-Authors of man pages should note the use of the non-printing input break
-escape sequence
+Authors of man pages should note the non-printing input break escape
+sequence
 .B \e&
 preceding the ellipsis,
 which prevents it from being misinterpreted as an invalid control line,
@@ -1442,8 +1442,8 @@ set in roman.
 .
 .
 .PP
-Be frugal with the use of italics for emphasis,
-and particularly with the use of bold.
+Be frugal with italics for emphasis,
+and particularly with bold.
 .
 Brief runs of literal text,
 such as references to individual characters or short strings,