diff options
-rw-r--r-- | doc/groff.texi | 19 | ||||
-rw-r--r-- | doc/ms.ms | 35 | ||||
-rw-r--r-- | tmac/groff_ms.7.man | 36 |
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} @@ -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] |