gbranden pushed a commit to branch master
in repository groff.
commit 4ea64eeb36210494ebf8cfab00dd6b3fce89874e
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sun Dec 25 17:33:46 2022 -0600
[docs]: Fix content nits.
* Clarify discussion of end-of-input interaction with last possible
output line.
* Make claim about AT&T troff's special character repertoire more
scrupulously correct. Annotate in comments.
---
doc/groff.texi | 25 ++++++++++++++++---------
man/groff.7.man | 9 +++++++--
man/roff.7.man | 4 ++--
3 files changed, 25 insertions(+), 13 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 35d6da2f4..10c5729de 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -5752,12 +5752,13 @@ place the next text baseline off the page. Rather than
let that happen,
start a new one, and again set the drawing position to one vee below the
page top; this is a @dfn{page break}.
-When the last line of input text is also the last output line that can
-fit on the page, the break caused by the end of input will also break
-the page, producing a useless blank one. Macro packages keep users from
-having to confront this difficulty by setting ``traps'' (@pxref{Traps});
-moreover, all but the simplest page layouts tend to have headers and
-footers, or at least bear vertical margins larger than one vee.
+When the last line of input text corresponds to the last output line
+that fits on the page, the break caused by the end of input will also
+break the page, producing a useless blank one. Macro packages keep
+users from having to confront this difficulty by setting ``traps''
+(@pxref{Traps}); moreover, all but the simplest page layouts tend to
+have headers and footers, or at least bear vertical margins larger than
+one vee.
@c =====================================================================
@@ -6765,9 +6766,15 @@ double quote.
In GNU @code{troff}'s @acronym{AT&T} compatibility mode, these
characters remain available as @code{\(rs} and @code{\(dq},
-respectively. @acronym{AT&T} @code{troff} did not define these special
-characters, but any of its descendants can be made to support them.
-@xref{Device and Font Description Files}.
+respectively. @acronym{AT&T} @code{troff} did not consistently define
+these special characters,
+@c It seems that AT&T troff never recognized \(rs, though DWB 3.3
+@c defined \(bs as an alias of "\" on its "Latin1" device, in
+@c deliberate(?) collision with the Bell System logo identifier. It
+@c also defined \(dq for several devices (pcl, Latin1, nroff, ...) along
+@c with \(aq.
+but its descendants can be made to support them. @xref{Device and Font
+Description Files}.
If even that is not feasible, options remain. To obtain a literal
escape character in a macro argument, you can simply type it if you
diff --git a/man/groff.7.man b/man/groff.7.man
index 646c87488..cbb8327b1 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1570,8 +1570,13 @@ respectively.
.
AT&T
.I troff \" AT&T
-did not define these special characters,
-but any of its descendants can be made to support them.
+did not consistently define these special characters,
+.\" It seems that AT&T troff never recognized \(rs, though DWB 3.3
+.\" defined \(bs as an alias of "\" on its "Latin1" device, in
+.\" deliberate(?) collision with the Bell System logo identifier. It
+.\" also defined \(dq for several devices (pcl, Latin1, nroff, ...)
+.\" along with \(aq.
+but its descendants can be made to support them.
.
See
.MR groff_font @MAN5EXT@ .
diff --git a/man/roff.7.man b/man/roff.7.man
index 9c8b817d1..efc177355 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -611,8 +611,8 @@ this is a
.
.
.P
-When the last line of input text is also the last output line that can
-fit on the page,
+When the last line of input text corresponds to the last output line
+that fits on the page,
the break caused by the end of input will also break the page,
producing a useless blank one.
.
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
