gbranden pushed a commit to branch master
in repository groff.

commit a81594edab990a0956498e79db9eeb9ee7973bfe
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Apr 24 11:43:04 2026 -0500

    [ms]: Explain "bold" typeface to novices.
    
    We already explain the others; it seems inconsistent to omit this one.
    
    Also break Texinfo input lines in a roff-friendly way.
---
 doc/groff.texi.in   | 22 +++++++++++++++++-----
 doc/ms.ms.in        |  4 +++-
 tmac/groff_ms.7.man |  4 +++-
 3 files changed, 23 insertions(+), 7 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 50dc08d42..356ca6865 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -4108,11 +4108,23 @@ boldface.  By Version@tie{}7 (1979) it recognized a 
second argument; in
 to avoid breaking support for older documents.}
 
 @Defmac {B, [@Var{text} [@Var{post} [@Var{pre}]]], ms}
-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 paragraphing, heading, or no-argument typeface macro
-call.
+Style
+@var{text}
+in
+@b{bold}---that is,
+with a heavier stroke weight---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
+paragraphing,
+heading,
+or no-argument typeface macro call.
 @endDefmac
 
 @Defmac {R, [@Var{text} [@Var{post} [@Var{pre}]]], ms}
diff --git a/doc/ms.ms.in b/doc/ms.ms.in
index 790d9ed3b..8fd658421 100644
--- a/doc/ms.ms.in
+++ b/doc/ms.ms.in
@@ -1672,7 +1672,9 @@ _
 Style
 .I text
 in
-.B bold ,
+.B bold \[em]\c
+that is,
+with a heavier stroke weight\[em]\c
 followed by
 .I post
 in the previous font style without intervening space,
diff --git a/tmac/groff_ms.7.man b/tmac/groff_ms.7.man
index 13186521d..a758347ee 100644
--- a/tmac/groff_ms.7.man
+++ b/tmac/groff_ms.7.man
@@ -1089,7 +1089,9 @@ arguments is a GNU extension.
 .IR text \~[ post \~[ pre ]]]
 Style
 .I text
-in bold,
+in bold\[em]\c
+that is,
+with a heavier stroke weight\[em]\c
 followed by
 .I post
 in the previous font style without intervening space,

_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to