[groff] 02/03: [docs]: Minimally document `tag`, `taga` requests.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 80b6e1e2f5941f36995006b9209ccdb65be91e51
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Apr 14 19:41:08 2023 -0500

    [docs]: Minimally document `tag`, `taga` requests.
    
    * doc/groff.texi (Postprocessor Access):
    * man/groff.7 (Request short reference): Do it.
    
    Fixes <https://savannah.gnu.org/bugs/?62695>.
    
    I don't know if we need to keep these.  They do much the same thing as
    `device`, and are implemented nearly identically to each other.  They
    have only one user, the also undocumented "devtag.tmac".
    
    One difference is that the `device` request constructs a "macro"
    (internally to GNU troff), and `tag{,a}` construct strings (from groff's
    string class, not the C++ standard library's).
    
    Possibly the type used for storage of the node contents is intended to
    address some of the same problems we've seen crop up in issues like
    Savannah #63074.
---
 ChangeLog       | 9 +++++++++
 doc/groff.texi  | 5 +++++
 man/groff.7.man | 7 +++++++
 3 files changed, 21 insertions(+)

diff --git a/ChangeLog b/ChangeLog
index 3b9777e29..a53ac4174 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2023-04-14  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       [docs]: Minimally document `tag`, `taga` requests.
+
+       * doc/groff.texi (Postprocessor Access):
+       * man/groff.7 (Request short reference): Do it.
+
+       Fixes <https://savannah.gnu.org/bugs/?62695>.
+
 2023-04-11  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [docs]: Fix typos.
diff --git a/doc/groff.texi b/doc/groff.texi
index eb2292444..597188319 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -16098,6 +16098,11 @@ confuses drivers that do not know about this extension 
(@pxref{Device
 Control Commands}).
 @endDefesc
 
+@DefreqList {tag, name}
+@DefreqListEndx {taga, name}
+Reserved for internal use.
+@endDefreq
+
 @codequotebacktick off
 @codequoteundirected off
 
diff --git a/man/groff.7.man b/man/groff.7.man
index fdb9b262e..aebc5617a 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -4131,6 +4131,13 @@ for right-aligned.
 .
 .
 .TPx
+.REQ .tag
+.TQ
+.REQ .taga
+Reserved for internal use.
+.
+.
+.TPx
 .REQ .tc
 Remove tab repetition glyph.
 .