gbranden pushed a commit to branch master
in repository groff.

commit 6297362eac589c693130e9dc8e0f2ba9bf7b3662
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Aug 14 12:16:29 2025 -0500

    [mm]: Rename `Tcst` string to `Tcstatus`.
    
    * contrib/mm/m.tmac: Rename API string `Tcst` to `Tcstatus` to make its
      purpose less obscure.  Its new name is no more lengthy than
      `Letnsdef`, and the package elsewhere uses "st" to abbreviate
      "string", as in the `GETST` macro.  Retain the old name as an alias.
    
    * contrib/mm/groff_mm.7.man (Strings): Document it.
    
    * NEWS: Add item.
---
 NEWS                      |  3 +++
 contrib/mm/ChangeLog      |  9 +++++++++
 contrib/mm/groff_mm.7.man |  2 +-
 contrib/mm/m.tmac         | 12 +++++++-----
 4 files changed, 20 insertions(+), 6 deletions(-)

diff --git a/NEWS b/NEWS
index c1cd66484..4bf6af0f3 100644
--- a/NEWS
+++ b/NEWS
@@ -660,6 +660,9 @@ Macro packages
      `Litb`  -> `Captb`
    The old names remain as aliases.
 
+*  The m (mm) macro package has renamed the `Tcst` string to `Tcstatus`
+   to make its purpose less obscure.  The old name remains as an alias.
+
 *  The s (ms) macro package now sets the vertical spacing register
    defaults for normal (`VS`) and footnote (`FVS`) text to 120% of the
    type size configured in the `PS` and `FPS` registers, respectively,
diff --git a/contrib/mm/ChangeLog b/contrib/mm/ChangeLog
index b92e0250e..876ecc6b4 100644
--- a/contrib/mm/ChangeLog
+++ b/contrib/mm/ChangeLog
@@ -1,3 +1,12 @@
+2025-08-14  G. Branden Robinson <[email protected]>
+
+       * m.tmac: Rename API string `Tcst` to `Tcstatus` to make its
+       purpose less obscure.  Its new name is no more lengthy than
+       `Letnsdef`, and the package elsewhere uses "st" to abbreviate
+       "string", as in the `GETST` macro.  Retain the old name as an
+       alias.
+       * groff_mm.7.man (Strings): Document it.
+
 2025-08-05  G. Branden Robinson <[email protected]>
 
        * m.tmac ([initializtion): Configure a 3v margin (one half-inch
diff --git a/contrib/mm/groff_mm.7.man b/contrib/mm/groff_mm.7.man
index 462db6d43..846ba0a82 100644
--- a/contrib/mm/groff_mm.7.man
+++ b/contrib/mm/groff_mm.7.man
@@ -4567,7 +4567,7 @@ interpolates the service mark sign.
 .
 .
 .TP
-.B Tcst
+.B Tcstatus
 interpolates an indicator of the
 .B TC
 macro's processing status.
diff --git a/contrib/mm/m.tmac b/contrib/mm/m.tmac
index 4610c252f..65c6f6120 100644
--- a/contrib/mm/m.tmac
+++ b/contrib/mm/m.tmac
@@ -404,7 +404,9 @@ http://savannah.gnu.org/bugs/?group=groff.
 .\" state of TOC formatting
 .\" This is empty outside the table of contents; inside it is set to co,
 .\" fg, tb, ec, ex, or ap.
-.ds Tcst \" empty
+.ds Tcstatus \" empty
+.\" alias for groff <= 1.23 compatibility
+.als Tcst Tcstatus
 .\" argument(s) for VERBON to give to `nm` request
 .ds Verbnm 1\"
 .\" indentation of verbatim regions (VERBON)
@@ -2853,7 +2855,7 @@ exceeds depth of nested lists (\\n[li*lvl])
 .if \w@\\$4@>0 .nr toc*tab \\$4
 .if \\n[pg*cols-per-page]>1 .1C
 .ds H1txt \\*[Licon]
-.ds Tcst co
+.ds Tcstatus co
 .pg@clear-hd
 .EF ""
 .OF ""
@@ -3087,7 +3089,7 @@ exceeds depth of nested lists (\\n[li*lvl])
 .de lix@print-ds
 .\" arg: fg,tb,ec,ex text
 .ds H1txt \\$3
-.ds Tcst \\$1
+.ds Tcstatus \\$1
 .if !\\n[Cp] .pg@next-page
 .\" print LIST OF XXXX
 .\" execute user-defined macros
@@ -3375,7 +3377,7 @@ argument: '\\$2'
 .\" .if \\n[.$]<2 .@error "APP: too few arguments"
 .app@set-ind "\\$1"
 .\"
-.ds Tcst ap
+.ds Tcstatus ap
 .ds Apptxt \\$2
 .\"
 .ie \\n[Aph] .app@header \\*[app*ind] "\\$2"
@@ -3389,7 +3391,7 @@ argument: '\\$2'
 .if \\n[.$]<2 .@error \\$0: expected 2 or 3 arguments, got \\n[.$]
 .app@set-ind "\\$1"
 .\"
-.ds Tcst ap
+.ds Tcstatus ap
 .ds Apptxt \\$3
 .\"
 .ie \\n[Aph] .app@header \\*[app*ind] "\\$3"

_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to