[groff] 15/39: [ms]: Document non-localized predefined strings.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 66b4de56e618b52bad75ce1d968b10f4be941207
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon May 30 11:29:08 2022 -0500

    [ms]: Document non-localized predefined strings.
    
    * doc/groff.texi: Relocate material from adjacency to localization
      discussion to "ms Body Text" section, where it makes more sense.
      Recast.
    
    * doc/ms.ms (Typographical symbols):
    * tmac/groff_ms.7.man (Typographical symbols): Add subsection.
---
 doc/groff.texi      | 39 ++++++++++++++++++++++++---------------
 doc/ms.ms           | 43 +++++++++++++++++++++++++++++++++++++++++++
 tmac/groff_ms.7.man | 33 +++++++++++++++++++++++++++++++++
 3 files changed, 100 insertions(+), 15 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 7c8ee332..d121c69e 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -3181,6 +3181,7 @@ The hyphenation mode (as used by the @code{hy} request) 
is set from the
 @code{HY} register.
 
 @menu
+* Typographical Symbols in ms::
 * Paragraphs in ms::
 * Headings in ms::
 * Highlighting in ms::
@@ -3194,7 +3195,29 @@ The hyphenation mode (as used by the @code{hy} request) 
is set from the
 
 @c ---------------------------------------------------------------------
 
-@node Paragraphs in ms, Headings in ms, ms Body Text, ms Body Text
+@node Typographical Symbols in ms, Paragraphs in ms, ms Body Text, ms Body Text
+@subsubsection Typographical Symbols
+@cindex @file{ms} macros, obtaining typographical symbols
+
+@file{ms} provides a handful of strings to obtain typographical symbols
+not easily entered with the keyboard.  Many others are available as
+special character escape sequences---see the @cite{groff_char@r{(7)}}
+man page.
+
+@Defmpstr {-, ms}
+Interpolate an em dash.
+@endDefmpstr
+
+@DefmpstrList {Q, ms}
+@DefmpstrListEndx {U, ms}
+Interpolate typographer's quotation marks where available, and neutral
+quotes otherwise.  @code{\*Q} is the left quote and @code{\*U} the
+right.  (As a mnemonic, think of ``quote'' and ``unquote''.)
+@endDefmpstr
+
+@c ---------------------------------------------------------------------
+
+@node Paragraphs in ms, Headings in ms, Typographical Symbols in ms, ms Body 
Text
 @subsubsection Paragraphs
 @cindex @file{ms} macros, paragraph handling
 
@@ -4331,20 +4354,6 @@ Contain the full names of the calendar months.  The 
defaults are in
 English: @samp{January}, @samp{February}, and so on.
 @endDefmpstr
 
-The following special characters are available.@footnote{For an
-explanation of what special characters are @ref{Special Characters}.}
-
-@Defmpstr {-, ms}
-Interpolates an em dash.
-@endDefmpstr
-
-@DefmpstrList {Q, ms}
-@DefmpstrListEndx {U, ms}
-Interpolates typographer's quotes where available, and neutral quotes
-otherwise.  @code{\*Q} is the left quote and @code{\*U} is the right
-quote.
-@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 ba7aa5d7..987bbcaf 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -741,6 +741,49 @@ This is a Tenth Edition Research Unix extension.
 .
 .KS
 .NH 2
+Typographical symbols
+.XS
+       Typographical symbols
+.XE
+.
+.
+.LP
+.I ms
+provides a handful of strings to obtain typographical symbols not easily
+entered with the keyboard.
+.
+Many others are available as special character escape sequences\*[-]see
+the
+.I groff_char (7)
+man page.
+.
+.TS
+box center;
+cb lb
+Lf(CR) Lx.
+String Description
+_
+\[rs]*[\-]     Interpolate an em dash.
+_
+\[rs]*[Q]      T{
+Interpolate typographer's quotation marks where available,
+and neutral quotes otherwise.
+.
+.CW \[rs]*[Q]
+is the left quote and
+.CW \[rs]*[U]
+the right.
+.
+(As a mnemonic,
+think of \*[Q]quote\*[U] and \*[Q]unquote\*[U].)
+T}
+\[rs]*[U]      \^
+.TE
+.KE
+.
+.
+.KS
+.NH 2
 Paragraphs
 .XS
        Paragraphs
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 1cec259e..d76c150c 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -643,6 +643,39 @@ This is a Tenth Edition Research Unix extension.
 .
 .
 .\" ====================================================================
+.SS "Typographical symbols"
+.\" ====================================================================
+.
+.I ms
+provides a handful of strings to obtain typographical symbols not easily
+entered with the keyboard.
+.
+Many others are available as special character escape sequences\[em]see
+.MR groff_char 7 .
+.
+.
+.TP
+.B \[rs]*[\-]
+Interpolate an em dash.
+.
+.
+.TP
+.B \[rs]*[Q]
+.TQ
+.B \[rs]*[U]
+Interpolate typographer's quotation marks where available,
+and neutral quotes otherwise.
+.
+.B \[rs]*[Q]
+is the left quote and
+.B \[rs]*[U]
+the right.
+.
+(As a mnemonic,
+think of \[lq]quote\[rq] and \[lq]unquote\[rq].)
+.
+.
+.\" ====================================================================
 .SS Paragraphs
 .\" ====================================================================
 .