[groff] 30/41: [ms]: Document package's localization status.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 3ccde06a737ad3ded52a8415d54970311c9887ef
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Mar 16 22:17:46 2022 +1100

    [ms]: Document package's localization status.
    
    Show reader how to use ms(7) for non-English documents.  Recast.
    
    * doc/ms.ms: Bump document date.
---
 doc/groff.texi      | 17 +++++++++++++++--
 doc/ms.ms           | 34 ++++++++++++++++++++++++++++++----
 tmac/groff_ms.7.man | 18 ++++++++++++++++--
 3 files changed, 61 insertions(+), 8 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index f4931d5a..839da282 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -4260,8 +4260,21 @@ great deal of time in the long run if you use @file{ms} 
regularly.
 @cindex special characters [@file{ms}]
 @cindex strings [@file{ms}]
 
-Redefine the following strings to adapt the @code{groff} @file{ms} macro
-package to languages other than English.
+@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.  You can load an
+appropriate localization macro package after @file{ms}; see the
+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
diff --git a/doc/ms.ms b/doc/ms.ms
index 4b93dbae..8fdc6b58 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -22,8 +22,8 @@
 .nr TC-MARGIN \w'00' \" expect 2-digit page numbers at most
 .ie t .nr PI 3.5n
 .el   .nr PI 4n
-.ND January 2022
-.EH '%''January 2022'
+.ND March 2022
+.EH '%''March 2022'
 .EF ''''
 .OH 'Using \f[I]groff\f[] with the \f[I]ms\f[] macros''%'
 .OF ''''
@@ -3371,6 +3371,7 @@ Indexing term
 .
 .
 .\" ------------------------
+.KS
 .NH 2
 Localization strings
 .XS
@@ -3379,11 +3380,35 @@ Localization strings
 .
 .
 .LP
-Redefine the following strings to adapt the
 .I "groff ms"
-macro package to languages other than English.
+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
@@ -3412,6 +3437,7 @@ _
 The default for
 .CW \[rs]*[ABSTRACT]
 includes font selection escape sequences to set the word in italics.
+.KE
 .
 .
 .\" ------------------------
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 69662c46..c44b757a 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -2445,9 +2445,23 @@ or another implementation should test this register.
 .SS "Localization strings"
 .\" ====================================================================
 .
-You can redefine the following strings to adapt the
 .I groff ms
-macro package to languages other than English.
+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