summaryrefslogtreecommitdiff
path: root/NEWS
diff options
context:
space:
mode:
authorG. Branden Robinson <g.branden.robinson@gmail.com>2022-11-11 15:55:08 -0600
committerG. Branden Robinson <g.branden.robinson@gmail.com>2022-11-12 13:17:16 -0600
commitb12e42cd2f8f0f8509b68bfe899eb59f9eb35056 (patch)
treeef592e070b54e5e0245894aa9bcce98a3516828b /NEWS
parentea61189077904e484cecb7c40996f2cb225a2411 (diff)
downloadgroff-git-b12e42cd2f8f0f8509b68bfe899eb59f9eb35056.tar.gz
NEWS: Improve terminological discipline.
* Refer to man page "topics", not "titles", to avoid conceptual collisions with manual section titles (e.g., "General Commands Manual"), section or subsection headings (sometimes called titles), and *roff page headers and footers (called "titles" since CSTR #54). * Also refer to special character "identifiers", not "glyph names".
Diffstat (limited to 'NEWS')
-rw-r--r--NEWS12
1 files changed, 6 insertions, 6 deletions
diff --git a/NEWS b/NEWS
index 729daedb2..c867cc914 100644
--- a/NEWS
+++ b/NEWS
@@ -180,7 +180,7 @@ o The pspic package now also has an error hook macro, which you can use
..
o The new rfc1345 macro package, contributed by Dorai Sitaram, defines
- special character glyph names implementing RFC 1345 mnemonics (plus
+ special character identifiers implementing RFC 1345 mnemonics (plus
some additions from Vim, which itself uses RFC 1345 for its digraphs).
It is documented in the groff_rfc1345(7) man page.
@@ -233,7 +233,7 @@ o The an (man) macro package supports a new macro, `MR`, intended for
optional). Because the macro semantically identifies a man page, it
can create a clickable hyperlink ("man:ls(1)" for the above example)
on supporting devices. Furthermore, a new string, `MF`, defines the
- font to be used for setting man page titles (the first argument to
+ font to be used for setting the man page topic (the first argument to
`MR` and `TH`), permitting configuration by distributions, sites, and
users.
@@ -244,13 +244,13 @@ o The an (man) macro package supports a new macro, `MR`, intended for
them; (2) false-positive identification of strings resembling man page
cross references (as can happen with "exit(1)", "while(1)",
"sleep(5)", "time(0)" and others) by terminal emulators and other
- programs; (3) the unwanted intrusion of hyphens into man page titles,
+ programs; (3) the unwanted intrusion of hyphens into man page topics,
which frustrates copy-and-paste operations (this problem has always
been avoidable through use of the \% escape sequence, but cross
references are frequent in man pages and some page authors are
inexpert *roff users); and (4) deep divisions in man page maintenance
communities over which typeface should be used to set the man page
- title (italics, roman, or bold).
+ topic (italics, roman, or bold).
o Part of the an (man) macro package has been renamed from `an-old.tmac`
to `an.tmac`, replacing a file that sourced the `andoc.tmac` wrapper.
@@ -269,12 +269,12 @@ o The an (man) and doc (mdoc) macro packages support a new `AD` string
the Unix man(7) default since 1979.
o The an (man) and doc (mdoc) macro packages support new `CS` and `CT`
- registers to control rendering of man page section headings and titles
+ registers to control rendering of man page section headings and topics
(seen in the page header), respectively, in full capitals. These
default off (with no visible effect on pages that already fully
capitalize such text in man page sources). The rationale is to
encourage man page authors to preserve case distinction information in
- (or restore it to) their titles and section headings, while giving
+ (or restore it to) their topics and section headings, while giving
users (including system administrators, distributors, integrators, and
maintainers of man(1) implementations) a way to view the rendered page
elements in full capitals if desired.