gbranden pushed a commit to branch master
in repository groff.
commit a58d05636ea296146c69df70a366087dc1d6efac
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun May 17 17:15:04 2026 -0500
[doc,man]: Fix style nits.
...in discussions of AT&T and GNU troff differences.
* Recast for greater grammatical parallelism.
* Add missing `@noindent` Texinfo command to paragraph interrupted by
displayed example.
* Clarify wording.
* Clarify the meaning of "doing nothing" in `dt` request discussion.
---
doc/groff.texi.in | 24 ++++++++++++------------
man/groff_diff.7.man | 23 +++++++++++------------
2 files changed, 23 insertions(+), 24 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index a7592f448..a59de62f4 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -23315,7 +23315,9 @@ it does not.
@cindex @code{\H}, incompatibilities with @acronym{AT&T} @code{troff}
@cindex @code{\s}, incompatibilities with @acronym{AT&T} @code{troff}
@cindex @code{\S}, incompatibilities with @acronym{AT&T} @code{troff}
-The escape sequences
+In @acronym{AT&T}
+@command{troff}, @c AT&T
+the escape sequences
@code{\f},
@code{\H},
@code{\m},
@@ -23330,17 +23332,13 @@ or after the conditional expression of an
@code{if}
or
@code{ie}
-request,
-only in compatibility mode.
-That is,
-upon interpreting them,
+request.
+After reading an escape sequence that starts an input line,
GNU
@command{troff} @c GNU
normally no longer recognizes a control character on the input line;
but in compatibility mode,
-it does,
-just like AT&T
-@command{troff}. @c AT&T
+it does.
Thus the next example produces bold output in both modes,
but the text differs.
@@ -23540,6 +23538,7 @@ given the input
\fBfoo\fZbar\fPbaz
@endExample
+@noindent
and,
assuming that the output device lacks a font named
@samp{Z},
@@ -23561,7 +23560,7 @@ is to save the value of the
register prior to attempting the change,
make the attempt,
then compare the saved value to the current one;
-if it changed,
+if they differ,
the font selection presumably succeeded.
Since doing so requires
@code{nr}
@@ -23713,8 +23712,8 @@ produces different results with each of the three
formatters.}
@cindex @code{sy} request, incompatibilities with @acronym{AT&T} @code{troff}
GNU
@command{troff} @c GNU
-interprets request arguments representing file names
-and system commands
+interprets a request argument representing a file name
+or system command
in the same way it does the
@var{contents}
argument to the
@@ -23874,7 +23873,8 @@ behaves as if it were given no arguments at all,
removing any existing diversion trap;
GNU
@command{troff} @c GNU
-does nothing,
+does nothing
+(besides issue diagnostics),
more consistently with other requests given unintelligible arguments.
@cindex @code{lf} request, incompatibilities with @acronym{AT&T} @code{troff}
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 96d753fd1..38f9afc42 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -6673,7 +6673,9 @@ See section \[lq]Miscellaneous\[rq] above.
.
.
.P
-The escape sequences
+In AT&T
+.I troff, \" AT&T
+the escape sequences
.BR \[rs]f ,
.BR \[rs]H ,
.BR \[rs]m ,
@@ -6688,18 +6690,14 @@ or after the conditional expression of an
.RB \[lq] if \^\[rq]
or
.B ie
-request,
-only in compatibility mode.
+request.
.
-That is,
-upon interpreting them,
+After reading an escape sequence that starts an input line,
GNU
.I troff \" GNU
normally no longer recognizes a control character on the input line;
but in compatibility mode,
-it does,
-just like AT&T
-.I troff. \" AT&T
+it does.
.
.
.P
@@ -6826,7 +6824,7 @@ is to save the value of the
register prior to attempting the change,
make the attempt,
then compare the saved value to the current one;
-if it changed,
+if they differ,
the font selection presumably succeeded.
.
Since doing so requires
@@ -6989,8 +6987,8 @@ after a word-initial one.
.P
GNU
.I troff \" GNU
-interprets request arguments representing file names
-and system commands
+interprets a request argument representing a file name
+or system command
in the same way it does the
.I contents
argument to the
@@ -7148,7 +7146,8 @@ behaves as if it were given no arguments at all,
removing any existing diversion trap;
GNU
.I troff \" GNU
-does nothing,
+does nothing
+(besides issue diagnostics),
more consistently with other requests given unintelligible arguments.
.
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
