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.

1 files changed, 31 insertions, 5 deletions

diff --git a/man/groff_char.7.man b/man/groff_char.7.man
index 9fd8ffda3..25d8e18a6 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
 .\" ====================================================================
 .