gbranden pushed a commit to branch master
in repository groff.

commit aee7525cd97855c94c11c9bd3335a5196fb7c4c6
Author: G. Branden Robinson <[email protected]>
AuthorDate: Tue Sep 30 06:13:21 2025 -0500

    tmac/an-ext.tmac: Tweak `EX`/`EE` behavior.
    
    ...for more flexible customization of typeface when using typesetters.
    
    * tmac/an-ext.tmac: Stop assigning value "R" to string `mC` in nroff
      mode.  This way it's straightforwardly overridable in a "man.local"
      file, and the user doesn't have to override it differently for nroff
      mode.
    
      (EX): Select font "R" explicitly in nroff mode; a typesetter's
      constant-width font name won't be meaningful to a terminal output
      driver, except in the (unlikely?) case that an installation configures
      a style name as `mC`'s value.  (Unless man(7) pages are then formatted
      with "troff -fC -man" or similar to force a monospaced font for the
      entire document, doing this would largely trash the utility of example
      displays.)
---
 ChangeLog        | 15 +++++++++++++++
 tmac/an-ext.tmac | 12 +++++++-----
 2 files changed, 22 insertions(+), 5 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 1b9c61f37..0b8ed3b5b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,18 @@
+2025-09-30  G. Branden Robinson <[email protected]>
+
+       * tmac/an-ext.tmac: Tweak `EX`/`EE` behavior for more flexible
+       customization of typeface when using typesetters.  Stop
+       assigning value "R" to string `mC` in nroff mode.  This way it's
+       straightforwardly overridable in a "man.local" file, and the
+       user doesn't have to override it differently for nroff mode.
+       (EX): Select font "R" explicitly in nroff mode; a typesetter's
+       constant-width font name won't be meaningful to a terminal
+       output driver, except in the (unlikely?) case that an
+       installation configures a style name as `mC`'s value.  (Unless
+       man(7) pages are then formatted with "troff -fC -man" or
+       similar to force a monospaced font for the entire document,
+       doing this would largely trash the utility of example displays.)
+
 2025-09-19  G. Branden Robinson <[email protected]>
 
        * src/roff/groff/tests/html-device-works-with-grn-and-eqn.sh:
diff --git a/tmac/an-ext.tmac b/tmac/an-ext.tmac
index ad8ced64b..06fb47700 100644
--- a/tmac/an-ext.tmac
+++ b/tmac/an-ext.tmac
@@ -34,11 +34,12 @@
 .if \n(mZ>1 \
 .  nx
 .
-.\" Set `mC` to your implementation's constant-width typeface.  There is
-.\" no globally portable choice; `CW`, `C`, and `CR` are all seen.  AT&T
-.\" troff offers no mechanism to query font availability.
+.\" Set `mC` to your implementation's constant-width typeface for
+.\" typesetter (nor terminal) output.  (You can do so either here or in
+.\" "man.local"; see groff_man(7).)  There is no globally portable
+.\" choice; `CW`, `C`, and `CR` are all seen.  AT&T troff offers no
+.\" mechanism to query font availability.
 .ds mC CW
-.if n .ds mC R
 .
 .\" Save the automatic hyphenation mode.
 .\"
@@ -208,7 +209,8 @@
 .    nr mP \\n(PD
 .    nr PD 1v
 .    nf
-.    ft \\*(mC
+.    ie n .ft \\*(mC
+.    el   .ft R
 .    nr mE 1
 .  \}
 ..

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

Reply via email to