diff options
author | G. Branden Robinson <g.branden.robinson@gmail.com> | 2022-11-11 15:55:08 -0600 |
---|---|---|
committer | G. Branden Robinson <g.branden.robinson@gmail.com> | 2022-11-12 13:17:16 -0600 |
commit | b12e42cd2f8f0f8509b68bfe899eb59f9eb35056 (patch) | |
tree | ef592e070b54e5e0245894aa9bcce98a3516828b /NEWS | |
parent | ea61189077904e484cecb7c40996f2cb225a2411 (diff) | |
download | groff-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-- | NEWS | 12 |
1 files changed, 6 insertions, 6 deletions
@@ -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. |