gbranden pushed a commit to branch master
in repository groff.
commit f110cd5d46f08f6620a881175e5b7a9c59c7249e
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Mar 27 20:10:25 2026 -0500
[doc,man]: Tweak wording and sync.
Also break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 15 +++++++++------
man/groff.7.man | 22 ++++++++++++++++++----
2 files changed, 27 insertions(+), 10 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 8eadbf521..0e9ea8ae3 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6473,14 +6473,17 @@ A document encoded in
(US-@acronym{ASCII}),
or,
equivalently,
-uses only code points from the
-``C0 Controls'' and ``Basic Latin'' parts of the Unicode character set
+that uses only code points from the
+``C0 Controls'' and ``Basic Latin'' parts
+of the Unicode character set
is also a valid ISO @w{Latin-1} document;
the standards are interchangeable
in their first 128 code points.@footnote{The
-@emph{semantics} of certain punctuation code points have gotten stricter
-with the successive standards, a cause of some frustration among man
-page writers; see @cite{groff_char@r{(7)}}.}
+@emph{semantics}
+of certain punctuation code points have gotten stricter
+with the successive standards,
+a cause of some frustration among man page writers;
+see @cite{groff_char@r{(7)}}.}
@cindex invalid input characters
@cindex input characters, invalid
@@ -7132,7 +7135,7 @@ En;
on typesetters,
an en is one-half em,
but on terminals an en equals an em,
-because they align all text to a grid of character cells.
+because such devices align all text to a grid of character cells.
@item v
@cindex vertical space unit (@code{v})
diff --git a/man/groff.7.man b/man/groff.7.man
index bd4c5841d..faf3132f4 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -361,9 +361,22 @@ into lines separated by the Unix newline character
using the character encoding it recognizes:
ISO\~Latin-1 (8859-1).
.
-We recommend use of ISO\~646:1991\~IRV (US-ASCII)
-or (equivalently) the Basic Latin subset
-of ISO\~10646 (Unicode);
+A document encoded in
+ISO\~646:1991\~IRV
+(US-ASCII)
+or,
+equivalently,
+that uses only code points from the
+\[lq]C0 Controls\[rq] and \[lq]Basic Latin\[rq] parts
+of the Unicode character set
+is also a valid ISO \%Latin-1 document;
+the standards are interchangeable
+in their first 128 code points.
+(The
+.I semantics
+of certain punctuation code points have gotten stricter
+with the successive standards,
+a cause of some frustration among man page writers;
see
.MR groff_char @MAN7EXT@ .
.
@@ -968,7 +981,8 @@ an em is equal to the current type size in points.
En;
on typesetters,
an en is one-half em,
-but on terminals an en equals an em.
+but on terminals an en equals an em,
+because such devices align all text to a grid of character cells.
.
.TP
.B v
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
