[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.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 12/16: [docs]: Fix miscellaneous nits.,
G. Branden Robinson <=