[groff] 14/16: groff(7): Document more escapes.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 4ce19cc101accac69ef5c424c5a0cbdec9cda533
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Aug 23 12:11:16 2021 +1000

    groff(7): Document more escapes.
    
    * man/groff.7.man (Escape short reference): Document `\[charNNN]`,
      `\[uNNNN]`, `\[uNNNN_NNNN...]` escape sequences.  Revise descriptions
      of `\O0` and `\O1` escape sequences.  Document `\O2`, `\O3`, `\O4`,
      and `\O5` escape sequences.
---
 ChangeLog       |  9 ++++++++
 man/groff.7.man | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++----
 2 files changed, 76 insertions(+), 4 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 0e3ad7c..2472c40 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,14 @@
 2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
+       groff(7): Document more escapes.
+
+       * man/groff.7.man (Escape short reference): Document
+       `\[charNNN]`, `\[uNNNN]`, `\[uNNNN_NNNN...]` escape sequences.
+       Revise descriptions of `\O0` and `\O1` escape sequences.
+       Document `\O2`, `\O3`, `\O4`, and `\O5` escape sequences.
+
+2021-08-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
        groff(7): Fix bug in `\?` escape rendering.
 
        * man/groff.7.man (ESC?): Fix bug in page-private macro: the
diff --git a/man/groff.7.man b/man/groff.7.man
index d1cadac..32f4145 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -3520,6 +3520,30 @@ and components
 and so on.
 .
 .
+.TP
+.ESC[] "" "\f[CB]char\f[]nnn"
+Interpolate glyph of eight-bit encoded character
+.IR nnn ,
+where
+.RI 0\|\[<=]\| nnn \|\[<=]\|255.
+.
+.
+.TP
+.ESC[] "" "\f[CB]u\f[]nnnn\f[R][\f[]n\f[R][\f[]n\f[R]]]"
+Interpolate glyph of Unicode character with code point
+.IR nnnn [ n [ n ]]
+in uppercase hexadecimal.
+.
+.
+.TP
+.ESC[] "" "\f[CB]u\f[]base-glyph\f[R][\f[]\f[CB]_\f[]\
+combining-component\f[R]].\|.\|."
+Interpolate composite glyph from Unicode character
+.I base-glyph
+and
+.IR combining-components .
+.
+.
 .\" ========= alphabetical escapes =========
 .
 .TP
@@ -3804,15 +3828,54 @@ and so on.
 .
 .TP
 .ESC O0
-Disable glyph output.
+At the outermost suppression level,
+disable glyph emission to the output driver.
 .
-Mainly for internal use.
 .
 .TP
 .ESC O1
-Enable glyph output.
+At the outermost suppression level,
+enable glyph emission to the output driver.
+.
+.
+.TP
+.ESC O2
+At the outermost suppression level,
+enable glyph emission to the output driver and write to the standard
+error stream the page number and four bounding box registers enclosing
+glyphs written since the previous
+.B \[rs]O
+escape sequence.
+.
+.
+.TP
+.ESC O3
+Begin a nested suppression level.
+.
+.
+.TP
+.ESC O4
+End a nested suppression level.
+.
+.
+.TP
+.ESC[] O "\f[CB]5\f[]Pfilename"
+At the outermost suppression level,
+write
+.I filename
+to the standard error stream;
+.IR P \~indicates
+the position of an image and must be one of
+.BR l ,
+.BR r ,
+.BR c ,
+or
+.B i
+(left,
+right,
+centered,
+inline).
 .
-Mainly for internal use.
 .
 .TP
 .ESC p