groff-commit
[Top][All Lists]
Advanced

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

[groff] 26/40: NEWS: Improve terminological discipline.


From: G. Branden Robinson
Subject: [groff] 26/40: NEWS: Improve terminological discipline.
Date: Sat, 12 Nov 2022 14:43:38 -0500 (EST)

gbranden pushed a commit to branch master
in repository groff.

commit b12e42cd2f8f0f8509b68bfe899eb59f9eb35056
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Nov 11 15:55:08 2022 -0600

    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".
---
 NEWS | 12 ++++++------
 1 file 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.



reply via email to

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