[groff] 29/35: groff_char(7): Recast accent/composite stuff.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 91a048aa09f5c77456ab83373c2a86e73293afc2
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Feb 21 04:42:27 2022 +1100

    groff_char(7): Recast accent/composite stuff.
    
    Add a "Files" section as well, in pursuit of the quest to document all
    of our macro files.
---
 man/groff_char.7.man | 36 +++++++++++++++++++++++++++++++-----
 1 file changed, 31 insertions(+), 5 deletions(-)

diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index 9fd8ffda..25d8e18a 100644
--- a/man/groff_char.7.man
+++ b/man/groff_char.7.man
@@ -1025,11 +1025,28 @@ _
 .SS Accents
 .\" ====================================================================
 .
-The
+Normally,
+the formatting of a special character advances the drawing position as
+an ordinary character does.
+.
+.IR groff 's
 .B composite
-request is used to map the accents to code points with non-spacing
-semantics;
-the values given in parentheses are their spacing counterparts.
+request designates a special character as combining.
+.
+The
+.I composite.tmac
+macro file,
+loaded automatically by default,
+maps the following special characters to the combining characters shown
+below.
+.
+The non-combining code point in parentheses is used when the special
+character occurs in isolation
+(compare
+.RB \[lq] "caf\[rs][e aa]" \[rq]
+and
+.RB \[lq] "caf\[rs][aa]e" \[rq]).
+.
 .
 .TS
 l l l lx.
@@ -1057,7 +1074,7 @@ _
 .
 All of these glyphs can be composed using combining glyph names as
 described in subsection \[lq]Special character escape forms\[rq] above;
-the names below can be thought of as short aliases for convenience.
+the names below are short aliases for convenience.
 .
 .TS
 l l l lx.
@@ -1754,6 +1771,15 @@ _
 .
 .
 .\" ====================================================================
+.SH Files
+.\" ====================================================================
+.
+.TP
+.I @MACRODIR@/\:\%composite\:.tmac
+See subsection \[lq]Accents\[rq] above.
+.
+.
+.\" ====================================================================
 .SH Authors
 .\" ====================================================================
 .