[groff] 17/24: groff_mdoc(7): Document an erratum for groff 1.23.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit daba6dd4458a6bf8f136f565cbc8fc1e96b04141
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Dec 25 17:43:29 2022 -0600

    groff_mdoc(7): Document an erratum for groff 1.23.
    
    Also undocument "type names" as an application of this macro; that seems
    dubious given the existence of `Vt`.
    
    To support this well, we need something like "-enter" and "-exit" macros
    for various mdoc macros, not "-font" ones (see
    mdoc/doc-{nroff,ditroff}).  This might be easy; the definition of a
    parsed macro could interpolate the appropriate `-exit` before setting
    `doc-macro-name` and calling `doc-parse-args`.
    
    Also clarify `Tn` description.
---
 tmac/groff_mdoc.7.man | 19 ++++++++++++++++---
 1 file changed, 16 insertions(+), 3 deletions(-)

diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man
index 82cd04e67..2f525fe0c 100644
--- a/tmac/groff_mdoc.7.man
+++ b/tmac/groff_mdoc.7.man
@@ -3248,10 +3248,14 @@ produces
 .Re
 .Ed
 .
-.Ss "Trade Names (or Acronyms and Type Names)"
+.Ss "Trade Names or Acronyms"
+.
+The trade name macro prints its arguments at a smaller type size.
+.
+It is intended to imitate a small caps fonts for fully capitalized
+acronyms.
+.
 .
-The trade name macro prints its arguments in a smaller font.
-Its intended use is to imitate a small caps fonts for uppercase acronyms.
 .Pp
 .Dl Usage: .Tn Ao symbol Ac ...
 .Pp
@@ -5292,6 +5296,15 @@ and sometimes looks ridiculous if output lines are being 
filled.
 .Pp
 The list and display macros do not do any keeps and certainly should be
 able to.
+.
+.
+.Pp
+As of
+.Xr groff
+1.23,
+.Ql \&Tn
+no longer changes the type size;
+this functionality may return in the next release.
 .\" Note what happens if the parameter list overlaps a newline
 .\" boundary.
 .\" to make sure a line boundary is crossed: