[groff] 17/27: [doc,man]: Clarify `bd` behavior.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 6095c8bb434d805c2417b8bceed488b988d7cbf7
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Dec 29 16:22:35 2024 -0600

    [doc,man]: Clarify `bd` behavior.
---
 doc/groff.texi.in    |  7 +++++--
 man/groff.7.man      |  6 ++++++
 man/groff_diff.7.man | 15 +++++++++++++++
 3 files changed, 26 insertions(+), 2 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 5aeed2ab3..c81fb02b3 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -11801,8 +11801,11 @@ issued repeatedly to set up different emboldening 
values for different
 current fonts.  If the second argument is missing, emboldening is turned
 off for this particular current font.
 
-This affects special fonts only (either set up with the @code{special}
-command in font files or with the @code{fspecial} request).
+Because the emboldening is conditional, it applies only if the glyph to
+be formatted is not available in the current font.  @var{font1} must
+therefore be a special font, configured either with the @code{special}
+directive in its font description file or with the @code{fspecial}
+request).
 @end itemize
 @endDefreq
 
diff --git a/man/groff.7.man b/man/groff.7.man
index 8c05f2a2e..a9c24c31b 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -2662,6 +2662,12 @@ when
 .I font
 is selected.
 .
+.\" XXX: Possibly allow prefixing an integer with `\&` to force
+.\" interpretation of this form.
+.I special-font
+must be a font name,
+not a mounting position.
+.
 .TPx
 .REQ .bd "special-font font n"
 Embolden
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index e26b19035..6089841af 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -4069,6 +4069,21 @@ are read in copy mode.
 .\" ====================================================================
 .
 .TP
+.BI .bd\~ "special-font font"
+Stop emboldening
+.I special-font
+when
+.I font
+is selected.
+.
+.\" XXX:
+.\" Possibly allow prefixing an integer with `\&` to force
+.\" interpretation of this form.
+.I special-font
+must be a font name,
+not a mounting position.
+.
+.TP
 .BR .cf\~ [ \[dq] ]\c
 .I file
 In a diversion,