[groff] 12/30: [ms]: Tweak documentation of `FAM` string.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 49914cca44e5f072a0c45474936683a5317cc27a
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jun 14 01:54:39 2022 -0500

    [ms]: Tweak documentation of `FAM` string.
    
    Sync structure of ms section of our Texinfo manual with doc/ms.ms.
---
 doc/groff.texi      | 30 +++++++++++++++++++-----------
 doc/ms.ms           | 27 ++++++++++++++++++---------
 tmac/groff_ms.7.man | 27 ++++++++++++++++++---------
 3 files changed, 55 insertions(+), 29 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 40c84aff..99adf441 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -2713,7 +2713,8 @@ extension.
 
 Effective: next paragraph.
 
-Default: as defined in the output device.
+Default: defined by the output device; often @samp{T} (@pxref{ms Body
+Text})
 @endDefmpstr
 
 @unnumberedsubsubsec Paragraph settings
@@ -3057,16 +3058,8 @@ A variety of macros, registers, and strings can be used 
to structure and
 style the body of your document.  Examples include paragraphs, headings,
 footnotes, and inclusions of material such as tables and figures.
 
-The @code{FAM} string sets the font family for body text.  If this
-string is undefined at initialization, it is set to @samp{T} (Times).
-Setting the @code{FAM} string before the first call of a heading,
-paragraphing, or (non-date) document description macro also applies it
-to headers, footers, and footnotes.
-
-The hyphenation mode (as used by the @code{hy} request) is set from the
-@code{HY} register.
-
 @menu
+* Text settings in ms::
 * Typographical symbols in ms::
 * Paragraphs in ms::
 * Headings in ms::
@@ -3082,7 +3075,22 @@ The hyphenation mode (as used by the @code{hy} request) 
is set from the
 
 @c ---------------------------------------------------------------------
 
-@node Typographical symbols in ms, Paragraphs in ms, ms Body Text, ms Body Text
+@node Text settings in ms, Typographical symbols in ms, ms Body Text, ms Body 
Text
+@subsubsection Text settings
+@cindex @file{ms} macros, text settings
+
+The @code{FAM} string sets the font family for body text; the default is
+@samp{T} (Times).  The font family setting is ignored on terminal
+devices.  Setting the @code{FAM} string before the first call of a
+heading, paragraphing, or (non-date) document description macro also
+applies it to headers, footers, and (for @code{FAM}) footnotes.
+
+The hyphenation mode (as used by the @code{hy} request) is set from the
+@code{HY} register.
+
+@c ---------------------------------------------------------------------
+
+@node Typographical symbols in ms, Paragraphs in ms, Text settings in ms, ms 
Body Text
 @subsubsection Typographical symbols
 @cindex @file{ms} macros, obtaining typographical symbols
 
diff --git a/doc/ms.ms b/doc/ms.ms
index 492a01e6..86d9e969 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -668,20 +668,29 @@ Text settings
 .LP
 The
 .CW FAM
-string sets the font family for body text.
-.
-If this string is undefined at initialization,
-it is set to
+string sets the font family for body text;
+the default is
 .CW T \[rq] \[lq]
 (Times).
 .
-Setting
-.CW \[rs]*[FAM]
-before the first call of a heading,
+The font family setting is ignored on terminal devices.
+.
+The
+.CW PS
+and
+.CW VS
+registers set the type size and vertical spacing
+(distance between text baselines),
+respectively.
+.
+Setting these parameters before the first call of a heading,
 paragraphing,
-or (non-date) document description macro also applies it to headers,
+or (non-date) document description macro also applies them to headers,
 footers,
-and footnotes.
+and
+(for
+.CW FAM )
+footnotes.
 .
 .
 .PP
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index b2ee2ed1..bb2782db 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -581,20 +581,29 @@ End the abstract.
 .
 The
 .B FAM
-string sets the font family for body text.
-.
-If this string is undefined at initialization,
-it is set to
+string sets the font family for body text;
+the default is
 .RB \[lq] T \[rq]
 (Times).
 .
-Setting
-.B \[rs]*[FAM]
-before the first call of a heading,
+The font family setting is ignored on terminal devices.
+.
+The
+.B PS
+and
+.B VS
+registers set the type size and vertical spacing
+(distance between text baselines),
+respectively.
+.
+Setting these parameters before the first call of a heading,
 paragraphing,
-or (non-date) document description macro also applies it to headers,
+or (non-date) document description macro also applies them to headers,
 footers,
-and footnotes.
+and
+(for
+.BR FAM )
+footnotes.
 .
 .
 .P