[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 01/23: [ms]: Fix content, style, markup nits in docs.
From: |
G. Branden Robinson |
Subject: |
[groff] 01/23: [ms]: Fix content, style, markup nits in docs. |
Date: |
Sat, 30 Jul 2022 14:53:42 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 63a4340dc8954ec3862f5489a858aef0778f16db
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Jul 23 17:31:46 2022 -0500
[ms]: Fix content, style, markup nits in docs.
* The adjectival form of "integer" is "integral".
* Migrate terminology: "horizontal space" (escape sequence) ->
"horizontal motion".
* doc/ms.ms: Place trailing period correctly.
* Tighten wording.
---
doc/groff.texi | 39 +++++++++++++++++++--------------------
doc/ms.ms | 15 +++++++--------
tmac/groff_ms.7.man | 11 +++++------
3 files changed, 31 insertions(+), 34 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 459806daa..68e88cf6f 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2431,14 +2431,14 @@ documentation.
The @file{ms} (``manuscript'') package is suitable for the preparation
of letters, memoranda, reports, and books. These @code{groff}
macros feature cover page and table of contents generation,
-automatically numbered headings, several different paragraph styles, a
-variety of text styling options, footnotes, and multi-column page
-layouts. @file{ms} supports the @command{tbl}, @command{eqn},
-@command{pic}, and @command{refer} preprocessors for inclusion of
-tables, mathematical equations, diagrams, and standardized bibliographic
-citations. This implementation is mostly compatible with the documented
-interface and behavior of AT&T Unix Version@tie{}7 @file{ms}. Several
-extensions from 4.2BSD (Berkeley)
+automatically numbered headings, several paragraph styles, a variety of
+text styling options, footnotes, and multi-column page layouts.
+@file{ms} supports the @command{tbl}, @command{eqn}, @command{pic}, and
+@command{refer} preprocessors for inclusion of tables, mathematical
+equations, diagrams, and standardized bibliographic citations. This
+implementation is mostly compatible with the documented interface and
+behavior of AT&T Unix Version@tie{}7 @file{ms}. Several extensions from
+4.2BSD (Berkeley)
@c Few changes were made in 4.3, Tahoe, Reno, or 4.4.
and Tenth Edition Research Unix have been recreated.
@@ -3284,7 +3284,7 @@ amount stored in the @code{PI} register on every line
@emph{except} the
first (also known as a hanging indent). This is a Berkeley extension.
@endDefmac
-The following example illustrates several different paragraphing macros.
+The following example illustrates the use of paragraphing macros.
@CartoucheExample
.NH 2
@@ -3327,9 +3327,8 @@ software.
Use headings to create a sequential or hierarchical structure for your
document. The @file{ms} macros print headings in @strong{bold} using
the same font family and, by default, type size as the body text.
-Headings are available with and without automatic numbering. Text lines
-immediately after heading macro calls are treated as part of the
-heading, rendered on the same output line in the same style.
+Headings are available with and without automatic numbering. Text on
+input lines following the macro call becomes the heading's title.
@DefmacList {NH, [@Var{depth}], ms}
@DefmacListEnd {NH, @t{S} @Var{heading-depth-index} @dots{}, ms}
@@ -4401,8 +4400,8 @@ great deal of time in the long run if you use @file{ms}
regularly.
You can customize the style of the leader that bridges each table of
contents entry with its page number; define the @code{TC-LEADER} special
character by using the @code{char} request. A typical leader combines
-the dot glyph @samp{.} with a horizontal space escape sequence to spread
-the dots. The width of the page number field is stored in the
+the dot glyph @samp{.} with a horizontal motion escape sequence to
+spread the dots. The width of the page number field is stored in the
@code{TC-MARGIN} register.
@c ---------------------------------------------------------------------
@@ -4463,12 +4462,12 @@ request, but the @file{ms} @code{RS} and @code{RE}
macros.
@item
@cindex fractional type sizes in @file{ms} macros
@cindex @file{ms} macros, fractional type sizes in
-@acronym{AT&T} @file{ms} supported only integer values for the type size
-and vertical spacing. To overcome this restriction, for the registers
-@code{PS}, @code{VS}, @code{FPS}, and @code{FVS}, @code{groff} @file{ms}
-interprets values equal to or larger than 1000 as decimal fractions
-multiplied by 1000. See the @code{PS} register in @ref{ms Document
-Control Settings}.
+@acronym{AT&T} @file{ms} supported only integral values for the type
+size and vertical spacing. To overcome this restriction, for the
+registers @code{PS}, @code{VS}, @code{FPS}, and @code{FVS}, @code{groff}
+@file{ms} interprets values equal to or larger than 1000 as decimal
+fractions multiplied by 1000. See the @code{PS} register in @ref{ms
+Document Control Settings}.
@item
@acronym{AT&T} @file{ms}'s @code{AU} macro supported arguments used with
diff --git a/doc/ms.ms b/doc/ms.ms
index b5073c82e..760594c68 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -54,7 +54,7 @@ These
.I groff
macros feature cover page and table of contents generation,
automatically numbered headings,
-several different paragraph styles,
+several paragraph styles,
a variety of text styling options,
footnotes,
and multi-column page layouts.
@@ -868,7 +868,7 @@ The
.CW FAM
string sets the font family for body text;
the default is
-.CW T \[rq] \[lq].
+.CW T \[rq]. \[lq]
.
The
.CW PS
@@ -1086,7 +1086,7 @@ T}
.
.KS
.PP
-The following example illustrates several different paragraphing macros.
+The following example illustrates the use of paragraphing macros.
.
.
.TS
@@ -1150,9 +1150,8 @@ type size as the body text.
.
Headings are available with and without automatic numbering.
.
-Text lines immediately after heading macro calls are treated as part of
-the heading,
-rendered on the same output line in the same style.
+Text on input lines following the macro call becomes the heading's
+title.
.
.
.TS
@@ -3581,7 +3580,7 @@ request.
.
A typical leader combines the dot glyph
.CW .\& \[rq] \[lq]
-with a horizontal space escape sequence to spread the dots.
+with a horizontal motion escape sequence to spread the dots.
.
The width of the page number field is stored in the
.CW TC\-MARGIN
@@ -3695,7 +3694,7 @@ and
.PP
AT&T
.I ms
-supported only integer values for the type size and vertical spacing.
+supported only integral values for the type size and vertical spacing.
.
To overcome this restriction,
for the registers
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index a46570bb6..4bc79ec81 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -69,7 +69,7 @@ These
.I groff
macros support cover page and table of contents generation,
automatically numbered headings,
-several different paragraph styles,
+several paragraph styles,
a variety of text styling options,
footnotes,
and multi-column page layouts.
@@ -796,9 +796,8 @@ type size as the body text.
.
Headings are available with and without automatic numbering.
.
-Text lines immediately after heading macro calls are treated as part of
-the heading,
-rendered on the same output line in the same style.
+Text on input lines following the macro call becomes the heading's
+title.
.
.
.TP
@@ -2283,7 +2282,7 @@ request.
.
A typical leader combines the dot glyph
.RB \[lq] .\& \[rq]
-with a horizontal space escape sequence to spread the dots.
+with a horizontal motion escape sequence to spread the dots.
.
The width of the page number field is stored in the
.B TC\-MARGIN
@@ -2419,7 +2418,7 @@ and
.IP \[bu]
AT&T
.I ms
-supported only integer values for the type size and vertical spacing.
+supported only integral values for the type size and vertical spacing.
.
To overcome this restriction,
for the registers
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 01/23: [ms]: Fix content, style, markup nits in docs.,
G. Branden Robinson <=