[groff] 07/16: [ms]: In docs, relocate and retitle a section.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 36091bf609035cb65ff92c862867dca2476107cc
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jun 7 22:34:19 2022 -0500

    [ms]: In docs, relocate and retitle a section.
    
    Rename "Localization strings" to "Language and localization" (more
    readily understood by people who haven't done i18n/l10n work).  Relocate
    to group it with other "body text" topics.
---
 doc/groff.texi      | 106 +++++++++++++++++++++------------------
 doc/ms.ms           | 140 ++++++++++++++++++++++++++--------------------------
 tmac/groff_ms.7.man | 104 +++++++++++++++++++-------------------
 3 files changed, 180 insertions(+), 170 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 928d8f3d..25948c95 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -3091,6 +3091,7 @@ The hyphenation mode (as used by the @code{hy} request) 
is set from the
 * ms Insertions::
 * Example multi-page table::
 * ms Footnotes::
+* ms language and localization::
 @end menu
 
 @c ---------------------------------------------------------------------
@@ -3965,6 +3966,63 @@ operator precedence (parentheses are honored).
 
 @c ---------------------------------------------------------------------
 
+@node ms language and localization, ms Page Layout, ms Footnotes, ms Body Text
+@subsubsection Language and localization
+@cindex @file{ms} macros, language
+@cindex @file{ms} macros, localization
+@cindex language [@file{ms}]
+@cindex localization [@file{ms}]
+
+@code{groff} @file{ms} provides several strings that you can customize
+for your own purposes, or redefine to adapt the macro package to
+languages other than English.  It is already localized for
+@c cs, de, fr, it, sv
+Czech, German, French, Italian, and Swedish.  Load the desired
+localization macro package after @file{ms}; see the
+@cite{groff_tmac@r{(5)}} man page.
+
+@CartoucheExample
+$ groff -ms -mfr bienvenue.ms
+@endCartoucheExample
+
+The following strings are available.
+
+@Defmpstr {REFERENCES, ms}
+Contains the string printed at the beginning of a references
+(bibliography) page produced with GNU @cite{refer@r{(1)}}.  The default
+is @samp{References}.
+@c XXX: Use of refer(1) with ms is insufficiently documented.
+@endDefmpstr
+
+@Defmpstr {ABSTRACT, ms}
+Contains the string printed at the beginning of the abstract.  The
+default is @samp{\f[I]ABSTRACT\f[]}; it includes font selection escape
+sequences to set the word in italics.
+@endDefmpstr
+
+@Defmpstr {TOC, ms}
+Contains the string printed at the beginning of the table of contents.
+The default is @samp{Table of Contents}.
+@endDefmpstr
+
+@DefmpstrList {MONTH1, ms}
+@DefmpstrItemx {MONTH2, ms}
+@DefmpstrItemx {MONTH3, ms}
+@DefmpstrItemx {MONTH4, ms}
+@DefmpstrItemx {MONTH5, ms}
+@DefmpstrItemx {MONTH6, ms}
+@DefmpstrItemx {MONTH7, ms}
+@DefmpstrItemx {MONTH8, ms}
+@DefmpstrItemx {MONTH9, ms}
+@DefmpstrItemx {MONTH10, ms}
+@DefmpstrItemx {MONTH11, ms}
+@DefmpstrListEndx {MONTH12, ms}
+Contain the full names of the calendar months.  The defaults are in
+English: @samp{January}, @samp{February}, and so on.
+@endDefmpstr
+
+@c ---------------------------------------------------------------------
+
 @node ms Page Layout, Differences from AT&T ms, ms Body Text, ms
 @subsection Page layout
 @cindex @file{ms} macros, page layout
@@ -4206,54 +4264,6 @@ great deal of time in the long run if you use @file{ms} 
regularly.
 @cindex special characters [@file{ms}]
 @cindex strings [@file{ms}]
 
-@code{groff} @file{ms} provides several strings that you can customize
-for your own purposes, or redefine to adapt the macro package to
-languages other than English.  It is already localized for
-@c cs, de, fr, it, sv
-Czech, German, French, Italian, and Swedish.  Load the desired
-localization macro package after @file{ms}; see the
-@cite{groff_tmac@r{(5)}} man page.
-
-@CartoucheExample
-$ groff -ms -mfr bienvenue.ms
-@endCartoucheExample
-
-The following strings are available.
-
-@Defmpstr {REFERENCES, ms}
-Contains the string printed at the beginning of a references
-(bibliography) page produced with GNU @cite{refer@r{(1)}}.  The default
-is @samp{References}.
-@c XXX: Use of refer(1) with ms is insufficiently documented.
-@endDefmpstr
-
-@Defmpstr {ABSTRACT, ms}
-Contains the string printed at the beginning of the abstract.  The
-default is @samp{\f[I]ABSTRACT\f[]}; it includes font selection escape
-sequences to set the word in italics.
-@endDefmpstr
-
-@Defmpstr {TOC, ms}
-Contains the string printed at the beginning of the table of contents.
-The default is @samp{Table of Contents}.
-@endDefmpstr
-
-@DefmpstrList {MONTH1, ms}
-@DefmpstrItemx {MONTH2, ms}
-@DefmpstrItemx {MONTH3, ms}
-@DefmpstrItemx {MONTH4, ms}
-@DefmpstrItemx {MONTH5, ms}
-@DefmpstrItemx {MONTH6, ms}
-@DefmpstrItemx {MONTH7, ms}
-@DefmpstrItemx {MONTH8, ms}
-@DefmpstrItemx {MONTH9, ms}
-@DefmpstrItemx {MONTH10, ms}
-@DefmpstrItemx {MONTH11, ms}
-@DefmpstrListEndx {MONTH12, ms}
-Contain the full names of the calendar months.  The defaults are in
-English: @samp{January}, @samp{February}, and so on.
-@endDefmpstr
-
 Improved accent marks are available in the @file{ms} macros.
 
 @Defmac {AM, , ms}
diff --git a/doc/ms.ms b/doc/ms.ms
index 018bcbb0..4b237750 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -2596,6 +2596,76 @@ but on the next page in multiple-column contexts.
 .
 .
 .\" ------------------------
+.KS
+.NH 2
+Language and localization
+.XS
+       Language and localization
+.XE
+.
+.
+.LP
+.I "groff ms"
+provides several strings that you can customize for your own purposes,
+or redefine to adapt the macro package to languages other than English.
+.
+It is already localized for
+.\" cs, de, fr, it, sv
+Czech,
+German,
+French,
+Italian,
+and
+Swedish.
+.
+Load the desired localization macro package after
+.I ms ;
+see the
+.I groff_tmac (5)
+man page.
+.
+.TS
+box center;
+lf(CR).
+$ \f[CB]groff \-ms \-mfr bienvenue.ms
+.TE
+.
+.
+.PP
+The following strings are available.
+.
+.TS
+box center;
+cb lb
+lf(CR) lf(CR) .
+String Default
+_
+\[rs]*[REFERENCES]     References
+\[rs]*[ABSTRACT]       \[rs]f[I]ABSTRACT\[rs]f[]
+\[rs]*[TOC]    Table of Contents
+\[rs]*[MONTH1] January
+\[rs]*[MONTH2] February
+\[rs]*[MONTH3] March
+\[rs]*[MONTH4] April
+\[rs]*[MONTH5] May
+\[rs]*[MONTH6] June
+\[rs]*[MONTH7] July
+\[rs]*[MONTH8] August
+\[rs]*[MONTH9] September
+\[rs]*[MONTH10]        October
+\[rs]*[MONTH11]        November
+\[rs]*[MONTH12]        December
+.TE
+.
+.
+.PP
+The default for
+.CW \[rs]*[ABSTRACT]
+includes font selection escape sequences to set the word in italics.
+.KE
+.
+.
+.\" ------------------------
 .if t .bp
 .NH 1
 Page layout
@@ -3455,76 +3525,6 @@ Indexing term
 .
 .
 .\" ------------------------
-.KS
-.NH 2
-Localization strings
-.XS
-       Localization strings
-.XE
-.
-.
-.LP
-.I "groff ms"
-provides several strings that you can customize for your own purposes,
-or redefine to adapt the macro package to languages other than English.
-.
-It is already localized for
-.\" cs, de, fr, it, sv
-Czech,
-German,
-French,
-Italian,
-and
-Swedish.
-.
-Load the desired localization macro package after
-.I ms ;
-see the
-.I groff_tmac (5)
-man page.
-.
-.TS
-box center;
-lf(CR).
-$ \f[CB]groff \-ms \-mfr bienvenue.ms
-.TE
-.
-.
-.PP
-The following strings are available.
-.
-.TS
-box center;
-cb lb
-lf(CR) lf(CR) .
-String Default
-_
-\[rs]*[REFERENCES]     References
-\[rs]*[ABSTRACT]       \[rs]f[I]ABSTRACT\[rs]f[]
-\[rs]*[TOC]    Table of Contents
-\[rs]*[MONTH1] January
-\[rs]*[MONTH2] February
-\[rs]*[MONTH3] March
-\[rs]*[MONTH4] April
-\[rs]*[MONTH5] May
-\[rs]*[MONTH6] June
-\[rs]*[MONTH7] July
-\[rs]*[MONTH8] August
-\[rs]*[MONTH9] September
-\[rs]*[MONTH10]        October
-\[rs]*[MONTH11]        November
-\[rs]*[MONTH12]        December
-.TE
-.
-.
-.PP
-The default for
-.CW \[rs]*[ABSTRACT]
-includes font selection escape sequences to set the word in italics.
-.KE
-.
-.
-.\" ------------------------
 .if t .bp
 .NH 1
 Further reading
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 4faf5e99..0d6efbeb 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1691,6 +1691,58 @@ but set the footnote paragraph with the marker hanging
 .
 .
 .\" ====================================================================
+.SS "Language and localization"
+.\" ====================================================================
+.
+.I groff ms
+provides several strings that you can customize for your own purposes,
+or redefine to adapt the macro package to languages other than English.
+.
+It is already localized for
+.\" cs, de, fr, it, sv
+Czech,
+German,
+French,
+Italian,
+and
+Swedish.
+.
+Load the desired localization macro package after
+.IR ms ;
+see
+.MR groff_tmac @MAN5EXT@ .
+.
+.RS
+.TS
+cb   cb
+lf(CR) lf(CR).
+String Default
+_
+\[rs]*[REFERENCES]     References
+\[rs]*[ABSTRACT]       \[rs]f[I]ABSTRACT\[rs]f[]
+\[rs]*[TOC]    Table of Contents
+\[rs]*[MONTH1] January
+\[rs]*[MONTH2] February
+\[rs]*[MONTH3] March
+\[rs]*[MONTH4] April
+\[rs]*[MONTH5] May
+\[rs]*[MONTH6] June
+\[rs]*[MONTH7] July
+\[rs]*[MONTH8] August
+\[rs]*[MONTH9] September
+\[rs]*[MONTH10]        October
+\[rs]*[MONTH11]        November
+\[rs]*[MONTH12]        December
+_
+.TE
+.RE
+.
+The default for
+.B ABSTRACT
+includes font selection escape sequences to set the word in italics.
+.
+.
+.\" ====================================================================
 .SS "Headers and footers"
 .\" ====================================================================
 .
@@ -2445,58 +2497,6 @@ Documents that need to determine whether they are being 
formatted with
 or another implementation should test this register.
 .
 .
-.\" ====================================================================
-.SS "Localization strings"
-.\" ====================================================================
-.
-.I groff ms
-provides several strings that you can customize for your own purposes,
-or redefine to adapt the macro package to languages other than English.
-.
-It is already localized for
-.\" cs, de, fr, it, sv
-Czech,
-German,
-French,
-Italian,
-and
-Swedish.
-.
-Load the desired localization macro package after
-.IR ms ;
-see
-.MR groff_tmac @MAN5EXT@ .
-.
-.RS
-.TS
-cb   cb
-lf(CR) lf(CR).
-String Default
-_
-\[rs]*[REFERENCES]     References
-\[rs]*[ABSTRACT]       \[rs]f[I]ABSTRACT\[rs]f[]
-\[rs]*[TOC]    Table of Contents
-\[rs]*[MONTH1] January
-\[rs]*[MONTH2] February
-\[rs]*[MONTH3] March
-\[rs]*[MONTH4] April
-\[rs]*[MONTH5] May
-\[rs]*[MONTH6] June
-\[rs]*[MONTH7] July
-\[rs]*[MONTH8] August
-\[rs]*[MONTH9] September
-\[rs]*[MONTH10]        October
-\[rs]*[MONTH11]        November
-\[rs]*[MONTH12]        December
-_
-.TE
-.RE
-.
-The default for
-.B ABSTRACT
-includes font selection escape sequences to set the word in italics.
-.
-.
 .\" TODO: Put this in a legacy feature support section, alongside AT&T
 .\" accent marks and .AM.
 .\".PP