[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 02/06: [docs]: Make cosmetic cleanups.
From: |
G. Branden Robinson |
Subject: |
[groff] 02/06: [docs]: Make cosmetic cleanups. |
Date: |
Thu, 14 Jan 2021 03:42:58 -0500 (EST) |
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,
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 02/06: [docs]: Make cosmetic cleanups.,
G. Branden Robinson <=