gbranden pushed a commit to branch master
in repository groff.
commit 8dc589e6733b1fdcd98e7826f1bffa7917bc9996
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Apr 25 09:20:50 2026 -0500
[doc,man]: Revise and sync \' \- \_ \` material.
* Speak of "the formatter", not "GNU troff", when describing generally
applicable *roff behavior.
* Favor active voice over passive.
* Break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 22 ++++++++++++++++++----
man/groff_char.7.man | 4 ++--
2 files changed, 20 insertions(+), 6 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index c03c25c8a..79617f775 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -13305,10 +13305,24 @@ more @var{combining-component}s. For example,
@samp{\[A ho]} is a
capital letter ``A'' with a ``hook accent'' (ogonek).
There is no special syntax for one-character names---the analogous form
-@samp{\@var{n}} would collide with other escape sequences. However, the
-four escape sequences @code{\'}, @code{\-}, @code{\_}, and @code{\`},
-are translated on input to the special character escape sequences
-@code{\[aa]}, @code{\[-]}, @code{\[ul]}, and @code{\[ga]}, respectively.
+@samp{\@var{n}}
+would collide with other escape sequences.
+A few escape sequences that are not
+special characters also produce glyphs;
+these exist for syntactical or historical reasons.
+The formatter translates the four escape sequences
+@code{\'},
+@code{\-},
+@code{\_},
+and
+@code{\`},
+on input to the special character escape sequences
+@code{\[aa]},
+@code{\[-]},
+@code{\[ul]},
+and
+@code{\[ga]},
+respectively.
A special character name of length one is not the same thing as an
ordinary character: that is, the character @code{a} is not the same as
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index dc6e3bf44..f12c31a5e 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -162,16 +162,16 @@ primarily using font
.
.P
A few escape sequences that are not
-.I groff
special characters also produce glyphs;
these exist for syntactical or historical reasons.
.
+The formatter translates the four escape sequences
.BR \e\[aq] ,
.BR \e\[ga] ,
.BR \e\- ,
and
.B \e_
-are translated on input to the special character escape sequences
+on input to the special character escape sequences
.BR \e[aa] ,
.BR \e[ga] ,
.BR \e[\-] ,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
