[groff] 07/16: [ms]: Drop use of undefined term, fix error.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit fe137f3a32f5f0ca019a3e5bf33c6c1673d6dece
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Dec 14 14:25:55 2022 -0600

    [ms]: Drop use of undefined term, fix error.
    
    * We don't define what a "highlighting" macro is, and it's not a useful
      term anyway.
    * Clarify that typeface-changing macros (.B, .I, .R, .BI, .CW), when
      used without arguments, persist until another no-argument version of
      them is encountered, instead of another "highlighting" macro, which
      could be construed to include these same face macros used _with_
      arguments.
    * Clarify that the type size changing macros' effect is not cancelled by
      "highlighting" macros.  Typeface changes persist.
---
 doc/groff.texi      | 16 ++++++++--------
 doc/ms.ms           | 15 +++++++--------
 tmac/groff_ms.7.man | 13 +++++++------
 3 files changed, 22 insertions(+), 22 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 8ca802a17..b7e8dda94 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -3474,7 +3474,6 @@ and displays} and @ref{ms Insertions}.
 
 @node Typeface and decoration, Lists in ms, Headings in ms, ms Body Text
 @subsubsection Typeface and decoration
-@cindex @file{ms} macros, highlighting
 
 The @file{ms} macros provide a variety of ways to style text.
 Attend closely to the ordering of arguments labeled @var{pre} and
@@ -3490,7 +3489,8 @@ to avoid breaking support for older documents.}
 Style @var{text} in @b{bold}, followed by @var{post} in the previous
 font style without intervening space, and preceded by @var{pre}
 similarly.  Without arguments, @file{ms} styles subsequent text in bold
-until the next highlighting, paragraphing, or heading macro call.
+until the next paragraphing, heading, or no-argument typeface macro
+call.
 @endDefmac
 
 @Defmac {R, [@Var{text} [@Var{post} [@Var{pre}]]], ms}
@@ -3528,16 +3528,16 @@ Typeset @var{text} with an underline.  Set @var{post}, 
if present, after
 
 @Defmac {LG, , ms}
 Set subsequent text in larger type (two points larger than the
-current size) until the next font size, highlighting, paragraphing, or
-heading macro call.  You can specify this macro multiple times to
-enlarge the type size as needed.
+current size) until the next type size, paragraphing, or heading macro
+call.  You can specify this macro multiple times to enlarge the type
+size as needed.
 @endDefmac
 
 @Defmac {SM, , ms}
 Set subsequent text in smaller type (two points smaller than the current
-size) until the next type size, highlighting, paragraphing, or heading
-macro call.  You can specify this macro multiple times to reduce the
-type size as needed.
+size) until the next type size, paragraphing, or heading macro call.
+You can specify this macro multiple times to reduce the type size as
+needed.
 @endDefmac
 
 @Defmac {NL, , ms}
diff --git a/doc/ms.ms b/doc/ms.ms
index 4c75b66f1..c6dbdc7e9 100644
--- a/doc/ms.ms
+++ b/doc/ms.ms
@@ -1548,9 +1548,10 @@ similarly.
 Without arguments,
 .I ms
 styles subsequent text in bold
-until the next highlighting,
+until the next
 paragraphing,
-or heading macro call.
+heading,
+or no-argument typeface macro call.
 T}
 _
 \&.R \f[R][\f[I]text\f[] [\f[I]post\f[] [\f[I]pre\f[]]]]       T{
@@ -1638,9 +1639,8 @@ Set subsequent text in
 larger type
 .NL
 (2\~points larger than the current size)
-until
-the next font size,
-highlighting,
+until the next
+type size,
 paragraphing,
 or heading macro call.
 .
@@ -1659,9 +1659,8 @@ Set subsequent text in
 smaller type
 .NL
 (2\~points smaller than the current size)
-until
-the next type size,
-highlighting,
+until the next
+type size,
 paragraphing,
 or heading macro call.
 .
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index f361449f9..770b8b5e8 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1047,9 +1047,10 @@ similarly.
 Without arguments,
 .I ms
 styles subsequent text in bold
-until the next highlighting,
+until the next
 paragraphing,
-or heading macro call.
+heading,
+or no-argument typeface macro call.
 .
 .
 .TP
@@ -1137,8 +1138,8 @@ with no intervening space.
 .B .LG
 Set subsequent text in larger type
 (2\~points larger than the current size)
-until the next font size,
-highlighting,
+until the next
+type size,
 paragraphing,
 or heading macro call.
 .
@@ -1150,8 +1151,8 @@ needed.
 .B .SM
 Set subsequent text in smaller type
 (2\~points smaller than the current size)
-until the next type size,
-highlighting,
+until the next
+type size,
 paragraphing,
 or heading macro call.
 .