[groff] 30/38: tmac/mdoc/doc-ditroff: Kill Inline Courier (2/3).

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 2df87c6b6d6f4aca719fd2a7a38c288b71cc57ac
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Mar 19 12:25:33 2024 -0500

    tmac/mdoc/doc-ditroff: Kill Inline Courier (2/3).
    
    [mdoc]: Change default font used for many macros when formatting
    for typesetters (cf. terminals).
    
    * tmac/mdoc/doc-ditroff: Stop switching to Courier family when setting
      arguments to the macros `Ar`, `Cm`, `Er`, `Fa`, `Fd`, `Fl`, `Fn`,
      `Ft`, `Ic`, `Li`, and `Nm`.
    
    * NEWS: Document it.
    
    Only you can prevent aneurysms; see discussion starting at
    <https://lists.gnu.org/archive/html/groff/2024-03/msg00152.html> and
    bear in mind that you can use the mdoc.local file to customize the font
    used to render nearly any mdoc(7) macro.  This mechanism has been in
    place since 1992.
    
    Also drop trailing empty comments from string definitions; either all of
    them should get the comments or none should, and it's less churn in this
    commit to just toss them.
---
 ChangeLog             | 15 +++++++++++++++
 NEWS                  | 10 ++++++++++
 tmac/mdoc/doc-ditroff | 26 +++++++++++++-------------
 3 files changed, 38 insertions(+), 13 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index d684578d0..81531ff57 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,18 @@
+2024-03-23  G. Branden Robinson <g.branden.robinson@gmail.com>
+
+       [mdoc]: Change default font used for many macros when formatting
+       for typesetters (cf. terminals).
+
+       * tmac/mdoc/doc-ditroff: Stop switching to Courier family when
+       setting arguments to the macros `Ar`, `Cm`, `Er`, `Fa`, `Fd`,
+       `Fl`, `Fn`, `Ft`, `Ic`, `Li`, and `Nm`.
+
+       Only you can prevent aneurysms; see discussion starting at
+       <https://lists.gnu.org/archive/html/groff/2024-03/msg00152.html>
+       and bear in mind that you can use the mdoc.local file to
+       customize the font used to render nearly any mdoc(7) macro.
+       This mechanism has been in place since 1992.
+
 2024-03-23  G. Branden Robinson <g.branden.robinson@gmail.com>
 
        [mdoc]: Add support for `MF` rendering option.  in parallel with
diff --git a/NEWS b/NEWS
index d2575537b..28ba61bc7 100644
--- a/NEWS
+++ b/NEWS
@@ -184,6 +184,16 @@ o The doc (mdoc) macro package's `Mt` macro now sets its 
argument in
   configured to use).  A new string, `doc-Mt-font`, for use in
   "mdoc.local" files and similar, supports configuration of this face.
 
+o The doc (mdoc) macro package now performs font family switches
+  inline (that is, on the same output line) to Courier much less
+  frequently when formatting for typesetters, affecting the `Ar`, `Cm`,
+  `Er`, `Fa`, `Fd`, `Fl`, `Fn`, `Ft`, `Ic`, `Li`, and `Nm` macros.  This
+  change was made to reduce the ambiguity of space widths when
+  typesetting the monospaced Courier and proportional Times fonts
+  adjacently.  Bear in mind that you can use the mdoc.local file to
+  customize the font used to render nearly any mdoc(7) macro; this
+  mechanism has been in place since 1992.
+
 o The doc (mdoc) macro package's `Lk`, `Mt`, and `Xr` macros now produce
   hyperlinks on HTML, PDF, and terminal devices.  See above regarding
   hyperlink support being enabled by default.
diff --git a/tmac/mdoc/doc-ditroff b/tmac/mdoc/doc-ditroff
index 0c95e6c2f..e2f88c4b4 100644
--- a/tmac/mdoc/doc-ditroff
+++ b/tmac/mdoc/doc-ditroff
@@ -54,25 +54,25 @@
 .ds doc-page-identifier-font \f[\*[MF]]
 .ds doc-page-section-font \f[R]
 .ds doc-Ad-font \f[I]
-.ds doc-Ar-font \f[CI]
-.ds doc-Cm-font \f[CR]
+.ds doc-Ar-font \f[I]
+.ds doc-Cm-font \f[R]
 .ds doc-Em-font \f[I]
-.ds doc-Er-font \f[CR]
+.ds doc-Er-font \f[R]
 .ds doc-Ev-font \f[I]
-.ds doc-Fa-font \f[CI]
-.ds doc-Fd-font \f[CB]
-.ds doc-Fl-font \f[CR]
-.ds doc-Fn-font \f[CB]
-.ds doc-Ft-font \f[CI]
-.ds doc-Ic-font \f[CB]
-.ds doc-Li-font \f[CR]
-.ds doc-Lk-font \f[R]\"
+.ds doc-Fa-font \f[I]
+.ds doc-Fd-font \f[B]
+.ds doc-Fl-font \f[R]
+.ds doc-Fn-font \f[B]
+.ds doc-Ft-font \f[I]
+.ds doc-Ic-font \f[B]
+.ds doc-Li-font \f[R]
+.ds doc-Lk-font \f[R]
 .ds doc-Me-font \f[B]
 .ds doc-Mt-font \f[R]
-.ds doc-Nm-font \f[CB]
+.ds doc-Nm-font \f[B]
 .ds doc-No-font \f[R]
 .ds doc-Pa-font \f[I]
-.ds doc-Sh-font \f[\*[HF]]\"
+.ds doc-Sh-font \f[\*[HF]]
 .ds doc-Sy-font \f[B]
 .ds doc-Tn-font \f[R]
 .ds doc-Va-font \f[I]