[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 07/16: [ms]: Drop use of undefined term, fix error.
From: |
G. Branden Robinson |
Subject: |
[groff] 07/16: [ms]: Drop use of undefined term, fix error. |
Date: |
Wed, 14 Dec 2022 21:12:14 -0500 (EST) |
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.
.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 07/16: [ms]: Drop use of undefined term, fix error.,
G. Branden Robinson <=