[groff] 04/18: [docs]: Settle on "thin" and "hair" space terms.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit b20ff7688a85fdd3ef527a66b9163858e0cc28c1
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Aug 17 05:50:54 2021 +1000

    [docs]: Settle on "thin" and "hair" space terms.
    
    Also, say "non-adjustable" instead of "unpaddable".  Adjustment may in
    the future permit "squeezing" as well as padding or "stretching".
---
 doc/groff.texi  | 18 +++++++++++-------
 doc/meintro.me  |  2 +-
 doc/meref.me    |  4 ++--
 man/groff.7.man |  4 ++--
 4 files changed, 16 insertions(+), 12 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 25e4fbf..6106a6f 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -12645,27 +12645,31 @@ There are a number of special-case escapes for 
horizontal motion.
 @Defesc {\\@key{SP}, , , }
 @cindex space, unbreakable
 @cindex unbreakable space
-An unbreakable, unpaddable (i.e., not expanded during filling) space.
-(Note: This is a backslash followed by a space.)  Usually you want one
-of the following escapes instead, often @code{\~}.
+An unbreakable, non-adjustable space.  (This is a backslash followed by
+a space.)  Usually you want one of the following escapes instead, often
+@code{\~}.
 @endDefesc
 
 @Defesc {\\~, , , }
 An unbreakable space that is adjustable like a normal inter-word space.
 @endDefesc
 
+@cindex thin space
+@cindex space, thin
 @Defesc {\\|, , , }
-A 1/6@dmn{th} em unbreakable space.  Ignored (rounded to zero width) on
-terminal output devices.
+A one-sixth @dmn{em} unbreakable (``thin'') space.  Ignored (rounded to
+zero width) on terminal output devices.
 
 However, if there is a glyph defined in the current font with name
 @code{\|} (note the leading backslash), the width of this glyph is used
 instead (even on terminals).
 @endDefesc
 
+@cindex hair space
+@cindex space, hair
 @Defesc {\\^, , , }
-A 1/12@dmn{th} em unbreakable space.  Ignored (rounded to zero width) on
-terminal output devices.
+A one-twelfth @dmn{em} unbreakable (``hair'') space.  Ignored (rounded
+to zero width) on terminal output devices.
 
 However, if there is a glyph defined in the current font with name
 @code{\^} (note the leading backslash), the width of this glyph is used
diff --git a/doc/meintro.me b/doc/meintro.me
index 298617f..fe9658c 100644
--- a/doc/meintro.me
+++ b/doc/meintro.me
@@ -2012,7 +2012,7 @@ in italics, you must type:
 .)b
 The
 .b \e|
-produces a very narrow space
+produces a thin space
 so that the
 .q l
 does not overlap the quote sign in \*G,
diff --git a/doc/meref.me b/doc/meref.me
index 876b2d2..ea0bf7f 100644
--- a/doc/meref.me
+++ b/doc/meref.me
@@ -2115,7 +2115,7 @@ NAME      TYPE    DESCRIPTION
 \e(\'  F\(sc   acute accent
 \e(\`  F\(sc   grave accent
 \e*}   S       end superscript
-\e^    F\(sc   1/12 em narrow space
+\e^    F\(sc   1/12 em unbreakable hair space
 \e*^   S       caret
 \&.ad  M\(sc   set text adjustment
 \&.af  M\(sc   assign format to register
@@ -2267,7 +2267,7 @@ NAME      TYPE    DESCRIPTION
 \en(yr R\(sc   year minus 1900
 \en(zs R       floating keep pre/post space
 \e{    F\(sc   begin conditional group
-\e|    F\(sc   1/6 em narrow space
+\e|    F\(sc   1/6 em unbreakable thin space
 \e}    F\(sc   end conditional group
 \e*~   S       tilde
 \en(_M R       section type (as set with .++ macro)
diff --git a/man/groff.7.man b/man/groff.7.man
index 203bd7f..6862e42 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3358,13 +3358,13 @@ Digit-width unbreakable space.
 .
 .TP
 .ESC |
-1/6\ em narrow unbreakable space glyph;
+1/6\~em unbreakable (\[lq]thin\[rq]) space glyph;
 zero-width in
 .IR nroff .
 .
 .TP
 .ESC \[ha]
-1/12\ em half-narrow unbreakable space glyph;
+1/12\~em unbreakable (\[lq]hair\[rq]) space glyph;
 zero-width in
 .IR nroff .
 .