gbranden pushed a commit to branch master
in repository groff.
commit 1a9024a3dd1d5c40534dc1036dc0c27ead6c3c5d
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Apr 25 18:11:39 2026 -0500
[doc,man]: Revise and sync special char/GGL stuff.
* Define what the "groff glyph list" (GGL) is in our man pages.
* Favor active voice over passive.
* Break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 18 ++++++++++++------
man/groff_char.7.man | 14 ++++++++++++++
2 files changed, 26 insertions(+), 6 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 79617f775..4f9888e68 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -13239,12 +13239,18 @@ groff -T dvi -m ec -m an groff_char.7 > groff_char.dvi
@cindex @code{groff} glyph list (GGL)
@cindex GGL (@code{groff} glyph list)
@cindex Adobe Glyph List (AGL)
-Special character names not listed in @cite{groff_char@r{(7)}} are
-derived algorithmically, using a simplified version of the Adobe Glyph
-List (AGL) algorithm, which is described in
-@uref{https://github.com@//adobe-type-tools@//agl-aglfn}. The (frozen)
-set of names that can't be derived algorithmically is called the
-@dfn{@code{groff} glyph list (GGL)}.
+Except for those listed in
+@cite{groff_char@r{(7)}},
+GNU
+@command{troff} @c GNU
+derives special character names algorithmically,
+using a simplified version of the technique employed by the
+Adobe Glyph List (AGL) algorithm,
+described in
+@uref{https://github.com@//adobe-type-tools@//agl-aglfn}.
+The (frozen) set of names that can't be derived algorithmically
+is called the
+@dfn{groff glyph list (GGL)}.
@itemize @bullet
@item
diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index ef471adac..dc51b9c2f 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -836,6 +836,20 @@ at present it also accepts
on ISO\~Latin-1 systems.)
.
.
+Except for the special character names listed
+in the \[lq]Input\[rq] columns of the glyph tables below,
+GNU
+.I troff \" GNU
+derives special character names algorithmically,
+using a simplified version of the technique employed by the
+.UR https://\:github\:.com/\:adobe\-type\-tools/\:agl\-aglfn
+Adobe Glyph List (AGL) algorithm
+.UE .
+.
+The (frozen) set of names that can't be derived algorithmically
+is called the
+@dfn{@code{groff} glyph list (GGL)}.
+.
.TP
.BI \[rs][u base-character\c
[\c
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
