[groff] 06/11: ChangeLog, NEWS: Clarify items.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 2bedef263e71b862c47d748c0be028d9daea856d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Nov 25 06:47:33 2023 -0600

    ChangeLog, NEWS: Clarify items.
---
 ChangeLog | 26 ++++++++++++++------------
 NEWS      | 20 ++++++++++----------
 2 files changed, 24 insertions(+), 22 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 22fa68ee7..6f9b467dc 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -2,18 +2,19 @@
 
        [man]: Don't enforce tag separation on `IP`.
 
-       The tags to `IP` macros are often very short, as with bullets or
-       list enumerators (and in fact we encourage this practice in our
-       style advice, promoting `TP` for definition lists and similar).
-       We therefore don't want to enforce the `TS` tag separation for
-       them.  `.IP \[bu] 2n` is a perfectly cromulent usage pattern.
+       The marker argument to the `IP` macro is often very short, such
+       as a bullet or list enumerator (and in fact we encourage this
+       practice in our style advice, promoting `TP` instead for
+       definition lists and similar).  We therefore don't want to
+       enforce the `TS` tag separation for them.  `.IP \[bu] 2n` is a
+       perfectly cromulent usage pattern.
 
        * tmac/an.tmac: Add new Boolean-valued register,
-       `an*enforce-tag-separation` to control this aspect of state.
+       `an*enforce-tag-separation`, to control this aspect of state.
        Initialize it true.
        (an-write-paragraph-tag): Multiply `TS` by this register to
        apply enforcement (or not).
-       (IP): Temporarily clear register while setting paragraph.
+       (IP): Temporarily clear register while setting paragraph tag.
 
        * tmac/groff_man.7.man.in (Paragraphing macros, Options):
        * NEWS: Update documentation.
@@ -22,7 +23,7 @@
 
        [build]: In source files that #include <assert.h>, ensure that
        we #include <config.h> first (with a `HAVE_CONFIG_H` inclusion
-       guard).  This should prevent build failures on AIX.
+       guard).  This should prevent build failures on AIX with Clang++.
 
        * src/devices/grodvi/dvi.cpp:
        * src/devices/grolbp/lbp.cpp:
@@ -642,7 +643,7 @@
 
 2023-09-01  G. Branden Robinson <g.branden.robinson@gmail.com>
 
-       [grog]: Drop `--ligatures`, `-run` support.
+       [grog]: Drop `--ligatures`, `--run` support.
 
        Simulate the former (which was specific to the "pdf" output
        device) with the option sequence "-P -U -P y", and the latter by
@@ -774,9 +775,10 @@
        `default_param_table`.
        (get_param): New function accesses `param_table` entries via a C
        string rather than integer lvalues.  Use `assert()` to dump
-       core; this function is never called by the parser, but only by
-       static logic.  Add `fatal()` under this same circumstance, in
-       case anyone `#define`s `NDEBUG`.
+       core if the parameter name is not recognized; this function is
+       never called by the parser, but only by static logic.  Add
+       `fatal()` under this same circumstance, in case anyone
+       `#define`s `NDEBUG`.
        (init_param_table): New function populates the (mutable)
        `param_table` from the (immutable) `default_param_table` using
        heap storage.
diff --git a/NEWS b/NEWS
index 69f04f28f..57d7f6232 100644
--- a/NEWS
+++ b/NEWS
@@ -19,9 +19,9 @@ o In nroff mode (in other words, when producing output for 
devices that
   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,
-  just as it does for regular breakable spaces.
+o The device-independent output now reports unbreakable spaces (those
+  produced with the `\~` escape sequence) as word breaks with the
+  documentary 'w' command, just as it does for regular breakable spaces.
 
 o A new read-only, string-valued register, `.trap`, interpolates the
   name of the next vertical position trap that will be sprung.
@@ -33,9 +33,9 @@ eqn
 ---
 
 o The "gifont" primitive replaces "gfont" as the means of configuring
-  the global italic face within an equation.  "gfont" remains recognized
-  as a synonym for backward compatibility.  The new name is intended to
-  ease acquisition of the eqn language in light of GNU eqn's
+  the global italic face in preprocessed equations.  "gfont" remains
+  recognized as a synonym for backward compatibility.  The new name is
+  intended to ease acquisition of the eqn language in light of GNU eqn's
   thirty-year-old extensions "gbfont" and "grfont".
 
 o New parameters tunable with the GNU eqn "set" primitive, "half_space"
@@ -80,10 +80,10 @@ o The an (man) and doc (mdoc) macro packages now support a 
`BP` register
   used by man(7) for paragraphs not within an `RS`/`RE` relative inset,
   and in mdoc(7) for all paragraphs.  Formerly, the `IN` register
   configured this amount with other indentation and inset amount
-  parameters used by man(7).  (In mdoc(7), it had no other purpose.) The
-  base paragraph indentation default is now 5n, corresponding to that
-  used by historical man(7) and mdoc(7) implementations going back to
-  Unix Version 7 and 4.3BSD-Reno, respectively.
+  parameters used by man(7).  (In mdoc(7), it had no other purpose.)
+  The base paragraph indentation default is now 5n, corresponding to
+  that used by historical man(7) and mdoc(7) implementations going back
+  to Unix Version 7 (1979) and 4.3BSD-Reno (1990), respectively.
 
 o The an (man) and doc (mdoc) macro packages now support a `PO` register
   to configure the page offset used by the formatter.