summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/groff.texi19
-rw-r--r--doc/ms.ms35
-rw-r--r--tmac/groff_ms.7.man36
3 files changed, 41 insertions, 49 deletions
diff --git a/doc/groff.texi b/doc/groff.texi
index d4179a767..abbffc5fb 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -26,7 +26,7 @@
@copying
This manual documents GNU @code{troff} version 1.23.0.
-Copyright @copyright{} 1994--2022 Free Software Foundation, Inc.
+Copyright @copyright{} 1994--2023 Free Software Foundation, Inc.
@quotation
Permission is granted to copy, distribute and/or modify this document
@@ -468,7 +468,7 @@ developing GNU and promoting software freedom.''
@title groff
@subtitle The GNU implementation of @code{troff}
@subtitle Edition 1.23.0
-@subtitle December 2022
+@subtitle January 2023
@author Trent@tie{}A.@: Fisher
@author Werner Lemberg
@author G.@tie{}Branden Robinson
@@ -4215,9 +4215,9 @@ the first, and produces no footers. You can customize this arrangement.
There are multiple ways to produce headers and footers. One is to
define the strings @code{LH}, @code{CH}, and @code{RH} to set the left,
center, and right headers, respectively; and @code{LF}, @code{CF}, and
-@code{RF} to set the left, center, and right footers similarly. This
-approach works best for documents that do not distinguish odd- and
-even-numbered pages.
+@code{RF} to set the left, center, and right footers. This approach
+suffices for documents that do not distinguish odd- and even-numbered
+pages.
Another method is to call macros that set headers or footers for odd- or
even-numbered pages. Each such macro takes a delimited argument
@@ -4503,7 +4503,7 @@ report errors, rather than silently to ignore them.
@item
Tenth Edition @c possibly 9th
-Research Unix supported @code{P1} and @code{P2} macros for setting code
+Research Unix supported @code{P1}/@code{P2} macros to bracket code
examples; @code{groff} @file{ms} does not.
@item
@@ -4528,8 +4528,8 @@ headings, and displays, cause a reset of paragraph rendering parameters,
and may change the indentation; they do so not by incrementing or
decrementing it, but by setting it absolutely. This can cause problems
for documents that define additional macros of their own that try to
-manipulate indentation. The solution is to use, not the @code{in}
-request, but the @file{ms} @code{RS} and @code{RE} macros.
+manipulate indentation. Use the @file{ms} @code{RS} and @code{RE}
+macros instead of the @code{in} request.
@item
@cindex fractional type sizes in @file{ms} macros
@@ -4590,8 +4590,7 @@ space between columns, not the fixed gutter width of @acronym{AT&T}
@item
The @acronym{AT&T} @file{ms} manual did not document the @code{QI}
-register, whereas Berkeley did; @code{groff} @file{ms} accordingly
-supports it.
+register; Berkeley and @code{groff} @file{ms} do.
@end itemize
@Defmpreg {GS, ms}
diff --git a/doc/ms.ms b/doc/ms.ms
index 341c0451c..982fac3ac 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -22,8 +22,8 @@
.nr TC-MARGIN \w'00' \" expect 2-digit page numbers at most
.ie t .nr PI 3.5n
.el .nr PI 4n
-.ND December 2022
-.EH '%''December 2022'
+.ND January 2023
+.EH '%''January 2023'
.EF ''''
.OH 'Using \f[I]groff\f[] with the \f[I]ms\f[] macros''%'
.OF ''''
@@ -3137,9 +3137,9 @@ and
.CW RF
to set the left,
center,
-and right footers similarly.
+and right footers.
.
-This approach works best for documents that do not distinguish odd- and
+This approach suffices for documents that do not distinguish odd- and
even-numbered pages.
.
.
@@ -3881,10 +3881,9 @@ rather than silently to ignore them.
.PP
Tenth Edition \" possibly 9th
Research Unix supported
-.B P1
-and
+.B P1 /
.B P2
-macros for setting code examples;
+macros to bracket code examples;
.I groff ms
does not.
.
@@ -3943,14 +3942,13 @@ but by setting it absolutely.
This can cause problems for documents that define additional macros of
their own that try to manipulate indentation.
.
-The solution is to use,
-not the
-.CW in
-request,
-but
+Use
.CW .RS
and
-.CW .RE .
+.CW .RE
+instead of the
+.CW in
+request.
.
.
.PP
@@ -3978,9 +3976,8 @@ Register values are converted to and stored as basic units.
.
See \[lq]Measurements\[rq] in the
.I groff
-Texinfo manual or the
-.I groff (7)
-man page.
+Texinfo manual or in
+.I groff (7).
.FE
.
This threshold makes use of a scaling unit with these parameters
@@ -4110,10 +4107,10 @@ The AT&T
.I ms
manual did not document the
.CW QI
-register,
-whereas Berkeley did;
+register;
+Berkeley and
.I "groff ms"
-accordingly supports it.
+do.
.
.
.PP
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index db6896bc5..4fbe8e26c 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -10,7 +10,7 @@ manuscript macro package for formatting documents
.\" Legal Terms
.\" ====================================================================
.\"
-.\" Copyright (C) 1989-2022 Free Software Foundation, Inc.
+.\" Copyright (C) 1989-2023 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
@@ -1828,9 +1828,9 @@ and
.B RF
to set the left,
center,
-and right footers similarly.
+and right footers.
.
-This approach works best for documents that do not distinguish odd- and
+This approach suffices for documents that do not distinguish odd- and
even-numbered pages.
.
.
@@ -2309,11 +2309,9 @@ rather than silently to ignore them.
.
.IP \[bu]
Tenth Edition \" possibly 9th
-Research Unix supported a pair of
-.B P1
-and
-.B P2
-macros for setting code examples;
+Research Unix supported
+.BR P1 / P2
+macros to bracket code examples;
.I groff ms
does not.
.
@@ -2372,14 +2370,13 @@ but by setting it absolutely.
This can cause problems for documents that define additional macros of
their own that try to manipulate indentation.
.
-The solution is to use,
-not the
-.B in
-request,
-but
+Use
.B .RS
and
-.BR .RE .
+.B .RE
+instead of the
+.B in
+request.
.
.
.IP \[bu]
@@ -2408,9 +2405,8 @@ units.
.
See \[lq]Measurements\[rq] in the
.I groff
-Texinfo manual or the
-.MR groff @MAN7EXT@
-man page.)
+Texinfo manual or in
+.MR groff @MAN7EXT@ ).
.
This threshold makes use of a scaling unit with these parameters
practical for high-resolution devices while preserving backward
@@ -2537,10 +2533,10 @@ The AT&T
.I ms
manual did not document the
.B QI
-register,
-whereas Berkeley did;
+register;
+Berkeley and
.I "groff ms"
-accordingly supports it.
+do.
.
.
.IP \[bu]