[groff] 01/04: ChangeLog, NEWS: Tweak wording and style.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit c5fe7ac8a7f318a9894f45e1118fdfe4ef7ef9c7
Author: G. Branden Robinson <address@hidden>
Date:   Wed Sep 11 06:17:43 2019 +1000

    ChangeLog, NEWS: Tweak wording and style.
    
    * Try to editorialize less about the bad wrongfulness of putting
      shouting capitals in man page sources (even if I think obliterating
      case distinctions in a case-sensitive environment is like burning the
      Library at Alexandria).
    * Mention ISO 8859 alongside ECMA-94, since the former is the (much)
      better-known form of the 8-bit Latin character encoding standard.
    * Make layout of the new NEWS section for 1.22.5 consistent with
      historical entries.
---
 ChangeLog | 12 ++++++------
 NEWS      | 37 +++++++++++++++++++++----------------
 2 files changed, 27 insertions(+), 22 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index e4537dd..ab8258b 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -53,15 +53,15 @@
 2019-09-09  G. Branden Robinson <address@hidden>
 
        The an (man) macro package supports new CS and CT number
-       registers to impose full capitalization on man page section
-       headings and titles, respectively.  These default off (with no
-       visible effect on pages which already fully capitalize these
+       registers to control rendering of man page section headings and
+       titles, respectively, in full capitals.  These default off (with
+       no visible effect on pages which already fully capitalize these
        strings in man page sources).  The rationale is to encourage man
-       page authors to preserve and/or restore case distinction
-       information in their titles and section headings, while giving
+       page authors to preserve case distinction information in (or
+       restore it to) their titles and section headings, while giving
        users (including system administrators, distributors,
        integrators, and maintainers of man(1) implementations) a way to
-       impose full capitalization on these page elements if desired.
+       view the rendered page elements in full capitals if desired.
 
        * tmac/an-old.tmac (TH/an-init): If number register CT is
        defined and nonzero, call .stringup on \*[an-title].
diff --git a/NEWS b/NEWS
index 690398a..086cc5a 100644
--- a/NEWS
+++ b/NEWS
@@ -12,7 +12,8 @@ VERSION 1.22.5
 
 Troff
 -----
-o New requests 'stringdown' and 'stringup' are implemented.  These change
+
+o New requests 'stringdown' and 'stringup' are available.  These change
   the string named in their argument by replacing each of its bytes with its
   lowercase or uppercase version (if any), respectively.  groff special
   characters (see the groff_char(7) man page) can be used and the output
@@ -21,10 +22,11 @@ o New requests 'stringdown' and 'stringup' are implemented. 
 These change
 
 o On the Latin-1 output device ("groff -T latin1") the output glyph \[oq]
   (opening quote) is now rendered as code point 0x27 (apostrophe) instead of
-  0x60 (grave accent).  The ECMA-94 Latin character sets do not define any
-  glyphs for directional ("typographer's") quotation marks, but the
-  apostrophe is depicted as a neutral (vertical) glyph, whereas the grave
-  accent 0x60 and acute accent 0xB4 are mirror-symmetric diacritical marks.
+  0x60 (grave accent).  The ISO 8859/ECMA-94 Latin character sets do not
+  define any glyphs for directional ("typographer's") quotation marks, but
+  the apostrophe is depicted as a neutral (vertical) glyph, whereas the
+  grave accent 0x60 and acute accent 0xB4 are mirror-symmetric diacritical
+  marks.
 
   Note that this change has no effect on _input_ conventions for roff source
   documents.  You can still get directional single quotes on UTF-8,
@@ -32,17 +34,20 @@ o On the Latin-1 output device ("groff -T latin1") the 
output glyph \[oq]
   sequences like `this' in the input (character remapping with ".char"
   requests and similar notwithstanding).
 
-an (man) Macros
-===============
-o The "an" (man) macro package supports new CS and CT number registers to
-  impose full capitalization on man page section headings and titles,
-  respectively.  These default off (with no visible effect on pages which
-  already fully capitalize these strings in man page sources).  The
-  rationale is to encourage man page authors to preserve and/or restore case
-  distinction information in their titles and section headings, while giving
-  users (including system administrators, distributors, integrators, and
-  maintainers of man(1) implementations) a way to impose full capitalization
-  on these page elements if desired.
+
+Macro Packages
+--------------
+
+o The an (man) macro package supports new CS and CT number registers to
+  control rendering of man page section headings and titles, respectively,
+  in full capitals.  These default off (with no visible effect on pages
+  which already fully capitalize these strings 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 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.
+
 
 VERSION 1.22.4
 ==============