groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 12/16: [docs]: Fix miscellaneous nits.


From: G. Branden Robinson
Subject: [groff] 12/16: [docs]: Fix miscellaneous nits.
Date: Mon, 4 Sep 2023 13:31:28 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 8019c9831ed0911da7a7e7b8c704e09ab1920f2c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sun Sep 3 18:41:02 2023 -0500

    [docs]: Fix miscellaneous nits.
    
    * ChangeLog: Fix whitespace goof.
    * NEWS: Throw users a bigger bone so they can cope better with attempts
      to select unavailable fonts, a popular pastime among man page authors
      (and automatic generators).  Also clarify item that mentions "nroff
      mode".
    * src/utils/xtotroff/xtotroff.1.man: Use correct indefinite article with
      subsequent word beginning with vowel sound.
---
 ChangeLog                         |  2 +-
 NEWS                              | 17 ++++++++++-------
 src/utils/xtotroff/xtotroff.1.man |  2 +-
 3 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index dd9f3beb1..61e2de4b6 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -30,7 +30,7 @@
        * tmac/html.tmac:
        * tmac/lbp.tmac:
        * tmac/lj4.tmac:
-       * tmac/ps.tmac:  Do it.
+       * tmac/ps.tmac: Do it.
 
        * NEWS: Add item.
 
diff --git a/NEWS b/NEWS
index e98531f8c..64731b289 100644
--- a/NEWS
+++ b/NEWS
@@ -13,11 +13,11 @@ VERSION next
 troff
 -----
 
-o In nroff mode (in other words, when producing output for terminal
-  devices), the formatter now reports warning diagnostics regarding
-  certain output problems using units of lines instead of inches (or the
-  unit configured with the `warnscale` request) to describe the vertical
-  drawing position where the problem occurred.
+o In nroff mode (in other words, when producing output for devices that
+  claim to be terminals), the formatter now reports warning diagnostics
+  regarding certain output problems using units of lines instead of
+  inches (or the unit configured with the `warnscale` request) to
+  describe the vertical drawing position where the problem occurred.
 
 o The output now reports unbreakable spaces (those produced with the
   `\~` escape sequence) as word breaks with the documentary 'w' command,
@@ -55,8 +55,11 @@ o The device-specific macro files loaded by "troffrc" 
automatically on
   problems with attempts to use nonexistent font names.  We recommend
   addressing such portability issues wherever suits you; in a document,
   perhaps by using `ie` and `el` requests and the `.g` register to test
-  for groff extensions; in your "troffrc" file; or by modifying these
-  macro files.  Users of the "dvi" and "lbp" output devices should be
+  for groff extensions, then `ie` and `el` again with the `F` groff
+  conditional expression operator to check for font availability, and
+  perform font remappings with the groff `ftr` request as desired; doing
+  so in your "troffrc" file; or by modifying these macro files
+  similarly.  Users of the "dvi" and "lbp" output devices should be
   aware that these devices don't supply full families of monospaced
   fonts (and never have).  See grodvi(1) and grolbp(1).
 
diff --git a/src/utils/xtotroff/xtotroff.1.man 
b/src/utils/xtotroff/xtotroff.1.man
index 98d6a4cb0..47fab2292 100644
--- a/src/utils/xtotroff/xtotroff.1.man
+++ b/src/utils/xtotroff/xtotroff.1.man
@@ -90,7 +90,7 @@ Each line in
 .I font-map
 pairs a
 .I groff
-font name with an X font name as a X Logical Font Description (XLFD)
+font name with an X font name as an X Logical Font Description (XLFD)
 pattern.
 .
 The pair's members are separated by spaces and/or tabs.



reply via email to

[Prev in Thread] Current Thread [Next in Thread]