[groff] 11/17: [docs]: Update descriptions of \[ozZ] escapes.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 2b20816f4ecac4707840db8c46978246bfa8dd2d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Jun 7 11:55:07 2023 -0500

    [docs]: Update descriptions of \[ozZ] escapes.
---
 doc/groff.texi       | 23 ++++++++++++-----------
 man/groff.7.man      | 12 ++++--------
 man/groff_diff.7.man |  3 +--
 3 files changed, 17 insertions(+), 21 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 3a02a97ed..be4c4fbcd 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -13876,33 +13876,34 @@ A read-only register containing the current 
horizontal output position
 (relative to the current indentation).
 @endDefreg
 
-@Defesc {\\o, @code{'}, abc, @code{'}}
+@Defesc {\\o, @code{'}, abc@dots{}, @code{'}}
 @cindex overstriking glyphs (@code{\o})
 @cindex glyphs, overstriking (@code{\o})
-Overstrike glyphs @var{a}, @var{b}, @var{c}, @dots{}; the glyphs are
-centered, and the resulting spacing is the largest width of the affected
-glyphs.
+Overstrike the glyphs of characters @var{a}, @var{b}, @var{c}, @dots{};
+the glyphs are centered, written, and the drawing position advanced by
+the widest of the glyphs.
 @endDefesc
 
 @Defesc {\\z, , c, }
 @cindex zero-width printing (@code{\z}, @code{\Z})
 @cindex printing, zero-width (@code{\z}, @code{\Z})
-Print glyph @var{c} with zero width, i.e., without spacing.  Use this to
-overstrike glyphs left-aligned.
+Format the character @var{c} with zero width; that is, without advancing
+the drawing position.  Use @code{\z} to overstrike glyphs aligned to
+their left edges, in contrast to @code{\o}'s centering.
 @endDefesc
 
 @Defesc {\\Z, @code{'}, anything, @code{'}}
 @cindex zero-width printing (@code{\z}, @code{\Z})
 @cindex printing, zero-width (@code{\z}, @code{\Z})
-Save the drawing position, format @var{anything}, then restore it.  The
-argument may not contain tabs or leaders.
+Save the drawing position, format @var{anything}, then restore it.  Tabs
+and leaders in the argument are ignored with an error diagnostic.
 
-An example of a strike-through macro follows.
+We might implement a strike-through macro thus.
 
 @Example
 .de ST
-.nr ww \w'\\$1'
-\Z@@\v'-.25m'\l'\\n[ww]u'@@\\$1
+.nr width \w'\\$1'
+\Z@@\v'-.25m'\l'\\n[width]u'@@\\$1
 ..
 .
 This is
diff --git a/man/groff.7.man b/man/groff.7.man
index 4dd6d913c..f9e86855d 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -5083,16 +5083,14 @@ Interpolate glyph with
 .RI index\~ n
 in the current font.
 .
-.
 .TP
-.ESCq o abc\fR\&.\|.\|.\&\fP
-Overstrike glyphs
+.ESCq o abc\f[R].\|.\|.\f[]
+Overstrike centered glyphs of characters
 .IR a ,
 .IR b ,
 .IR c ,
 and so on.
 .
-.
 .TP
 .ESC O0
 At the outermost suppression level,
@@ -5363,11 +5361,9 @@ output as a device control command.
 .
 .TP
 .ESC z c
-Output glyph
+Format character
 .I c
-without advancing the print position,
-as if it were zero-width.
-.
+with zero width\[em]without advancing the drawing position.
 .
 .TP
 .ESCq Z anything
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index f9c8e07bf..81d11d35b 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1007,8 +1007,7 @@ format
 .IR anything ,
 then restore it.
 .
-.I anything
-may not contain tabs or leaders.
+Tabs and leaders in the argument are ignored with an error diagnostic.
 .
 .
 .TP