[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 07/23: [ms]: Align documentation.
From: |
G. Branden Robinson |
Subject: |
[groff] 07/23: [ms]: Align documentation. |
Date: |
Sat, 6 May 2023 20:58:16 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 94a3ae189df4a083bc1db84f408a0f25f169e969
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu May 4 16:49:11 2023 -0500
[ms]: Align documentation.
Also slightly recast in places for better style.
---
doc/groff.texi | 12 ++++++------
doc/ms.ms | 7 ++++---
tmac/groff_ms.7.man | 17 ++++++++++-------
3 files changed, 20 insertions(+), 16 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 2db5aea19..99626b398 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4477,9 +4477,9 @@ spread the dots. The width of the page number field is
stored in the
The @code{groff} @file{ms} macros are an independent reimplementation,
using no @acronym{AT&T} code. Since they take advantage of the extended
features of @code{groff}, they cannot be used with @acronym{AT&T}
-@code{troff}. @code{groff} @file{ms} supports several features
-described above as Berkeley and Tenth Edition Research Unix extensions,
-and adds several of its own.
+@code{troff}. @code{groff} @file{ms} supports features described above
+as Berkeley and Tenth Edition Research Unix extensions, and adds several
+of its own.
@itemize @bullet
@item
@@ -4495,7 +4495,7 @@ manual.@footnote{@cite{Typing Documents on the UNIX
System: Using the
@item
The error-handling policy of @code{groff} @file{ms} is to detect and
-report errors, rather than silently to ignore them.
+report errors, rather than to ignore them silently.
@item
Tenth Edition @c possibly 9th
@@ -4813,8 +4813,8 @@ The following conventions are used for names of macros,
strings, and
registers. External names available to documents that use the
@code{groff} @file{ms} macros contain only uppercase letters and digits.
-Internally the macros are divided into modules. The naming conventions
-are as follows.
+Internally, the macros are divided into modules. Conventions for
+identifier names are as follows.
@itemize @bullet
@item
diff --git a/doc/ms.ms b/doc/ms.ms
index 03a13b46d..f58caae11 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -3914,7 +3914,7 @@ manual [Lesk 1978].
The error-handling policy of
.I groff ms
is to detect and report errors,
-rather than silently to ignore them.
+rather than to ignore them silently.
.
.
.PP
@@ -3938,8 +3938,9 @@ it aborts processing with a diagnostic message.
.
.
.PP
-Multiple line spacing is not supported
-(use a larger vertical spacing instead).
+Multiple line spacing is not supported.
+.
+Use a larger vertical spacing instead.
.
.
.PP
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index f88ccc020..1aa22b994 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -2290,8 +2290,8 @@ they cannot be used with AT&T
.IR troff .
.
.I groff ms
-supports several features described above as Berkeley and Tenth Edition
-Research Unix extensions,
+supports features described above as Berkeley and Tenth Edition Research
+Unix extensions,
and adds several of its own.
.
.
@@ -2323,7 +2323,7 @@ Bell Laboratories,
The error-handling policy of
.I groff ms
is to detect and report errors,
-rather than silently to ignore them.
+rather than to ignore them silently.
.
.
.IP \[bu]
@@ -2346,8 +2346,9 @@ it aborts processing with a diagnostic message.
.
.
.IP \[bu]
-Multiple line spacing is not supported
-(use a larger vertical spacing instead).
+Multiple line spacing is not supported.
+.
+Use a larger vertical spacing instead.
.
.
.IP \[bu]
@@ -2728,8 +2729,10 @@ macros contain only uppercase letters and digits.
.
.
.LP
-Internally the macros are divided into modules;
-naming conventions are as follows:
+Internally,
+the macros are divided into modules.
+.
+Conventions for identifier names are as follows.
.
.IP \[bu] 3n
Names used only within one module are of the form
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 07/23: [ms]: Align documentation.,
G. Branden Robinson <=