[latex3-commits] [git/LaTeX3-latex3-latex2e] copyedits-chris: ltnews34: further tweaks and comments (3d6d0470)

[Chris Rowley]

Repository : https://github.com/latex3/latex2e
On branch  : copyedits-chris
Link       : https://github.com/latex3/latex2e/commit/3d6d04703ee1fad195b94dc8ac9dafe3d7d733ef

>---------------------------------------------------------------

commit 3d6d04703ee1fad195b94dc8ac9dafe3d7d733ef
Author: Chris Rowley <car222222 at users.noreply.github.com>
Date:   Wed Oct 27 17:15:31 2021 +0700

    ltnews34: further tweaks and comments


>---------------------------------------------------------------

3d6d04703ee1fad195b94dc8ac9dafe3d7d733ef
 base/doc/ltnews34.tex | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)

diff --git a/base/doc/ltnews34.tex b/base/doc/ltnews34.tex
index e8f96bf0..98a2d75c 100644
--- a/base/doc/ltnews34.tex
+++ b/base/doc/ltnews34.tex
@@ -155,7 +155,11 @@ number of queries which show that some of the documentation was not
 precise enough and that some clarifications were needed; these 
 deficiencies have now been addressed in the documentation. 
 %
-The increased usage has also discovered a small number of 
+The increased usage has also revealed 
+%%CCC discovered is simply wrong! inanimate thimgs cannot perform
+%%     thoughtful acts such as discovery! 
+%%    "uncovered" would be OK too.
+a small number of 
 errors that we thought
 should be corrected now, while the adoption rate is still relatively
 small; the following problems have therefore been addressed in this release.
@@ -171,7 +175,7 @@ implicitly available, springing into life the moment a package, or
 the document preamble, adds any code to one by using \cs{AddToHook}.  
 %
 The kernel offers such hooks for environments
- (\texttt{env/...}) and commands (\texttt{cmd/...}), and for files, 
+ (\texttt{env/...}) and commands (\texttt{cmd/...}), and also for files, 
  packages and classes (\texttt{file/...},
 \texttt{include/...}, \texttt{package/...}, \texttt{class/...}).
 
@@ -214,9 +218,12 @@ Note that a generic hook produced in this way is always a normal hook.
 
 The initial set of generic hooks provided by the kernel had
 two patterns of names:
+%% CCC Not sure about this, it read much better before.
 ones like
 \verb|env/|\meta{name}\verb|/after|, 
-with the variable \meta{name}
+with the variable 
+%z CCC either needs parentheses (or commas) or leave it out
+%%   \meta{name}
 part in the middle position;
 and ones like
 \verb|file/after/|\meta{name}, with the 
@@ -438,7 +445,7 @@ preamble of your documents: this is because having missing glyphs
 in the output is definitely an error and should therefore be 
 flagged as such (to ensure that it gets proper attention).
 Further reasons, related especially to Unicode engines, for making 
-this recommended change are given later in this newsletter 
+this recommended change are explained later in this newsletter 
 (in connection with the misuse of text accents in math mode).
 
 
@@ -672,7 +679,7 @@ no font supports the full Unicode range).
      embellishments in command declarations]
            {Replicate argument processors for all embellishments in command declarations}
 
-%  \\ \mbox{}\qquad ?
+%  \\ \mbox{}\qquad ?  CCC Agreed: Better wothout this. 
 
 There was a bug in \pkg{ltcmd} (formerly \pkg{xparse}) that caused
 commands to misbehave if they were defined with embellishments and