[latex3-commits] [git/LaTeX3-latex3-latex2e] copyedits-chris: ltnews34: draft 3 almost there! (eafa5073)

[Chris Rowley]

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

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

commit eafa507310d663621725d443245f53f03aa8a7c8
Author: Chris Rowley <car222222 at users.noreply.github.com>
Date:   Wed Oct 20 10:20:58 2021 +0700

    ltnews34: draft 3 almost there!
    
    Needs small final tweaking, after visual check
    No intro is planned for this week


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

eafa507310d663621725d443245f53f03aa8a7c8
 base/doc/ltnews34.tex | 74 +++++++++++++++++++++------------------------------
 1 file changed, 31 insertions(+), 43 deletions(-)

diff --git a/base/doc/ltnews34.tex b/base/doc/ltnews34.tex
index 8551f40b..0c7442b6 100644
--- a/base/doc/ltnews34.tex
+++ b/base/doc/ltnews34.tex
@@ -34,11 +34,9 @@
 
 \documentclass{ltnews}
 
-%%CCC  Temporary definitions:   CCC Remove these! 
+%%  Temporary definition for Chris' inadequate system:  CCC
 \providecommand\Dash {\unskip ---}
 
-
-
 %% NOTE:  Chris' preferred hyphens!
 %%\showhyphens{parameters}
 %%  \hyphenation{because parameters parameter}
@@ -72,7 +70,7 @@
           	    {github issue#1 #2}%
            )}%
      \par\smallskip}
-%% CCC TEMP mostly disable \href for TEXPAD
+%% But Chris has to mostly disable \href for his TEXPAD app:  CCC
 \def\href #1{} 
 
 % simple solution right now (just link to the first issue if there are more)
@@ -349,11 +347,6 @@ and it is also truly independent of package loading order.
 \githubissue{625}
 
 
-
-
-
-
-
 \section{New or improved commands}
 
 
@@ -387,8 +380,6 @@ new commands: \cs{ClassNote} and \cs{ClassNoteNoLine}.
 The commands \cs{counterwithout} and \cs{counterwithin} each now has
 an additional optional argument, similar to that for the command 
  \cs{numberwithin} from \pkg{amsmath}, 
-%% FMi the implicit suggestion is to use the kernel method
-%% CCC Like this?   EMAIL
 for which these are now the preferred replacements.
 This optional argument 
 specifies the format of the counter, such as \cs{roman}, 
@@ -404,7 +395,8 @@ characters into errors and not just warnings.
 This engine change made us
 realize that \LaTeX{} should set a better default value for this parameter
 (previously, the warning was written only to the transcript file).
-Using the now available \texttt{3} as the default would really be best, but for
+Using the now available value of \texttt{3} as the default
+would really be best, but for
 compatibility reasons we have only increased it to \texttt{2} in the kernel.
 %
 However, we recommend setting \cs{tracinglostchars}\texttt{=3}, 
@@ -412,14 +404,9 @@ in either a package or the
 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).
-%%  CCC   ADD see also ... another reason 
-
-\iffalse
-We
-strongly recommend this, especially for Unicode engines where missing
-characters are common as no font supports the full Unicode range.
-%% CCC From text accents in math
-\fi 
+Further reasons, related especially to Unicode engines, for making 
+this recommended change can be found later in this newsletter 
+(in connection with the misuse of text accents in mathmode).
 
 
 \subsection{Tests for package and class loading}
@@ -532,8 +519,8 @@ erroneously, to input a variety files in the preamble of the document
 Therefore \LaTeX\ now warns about such bad use of \cs{include}.
 As a recovery action it will nevertheless input the specified file 
 if it exists (this is as before).  Note, however, that this is now done 
-without any adjustments to the aux file settings and without running 
-the \cs{include} file hooks (only the generic 
+without any adjustments to the \texttt{.aux} file settings and 
+without running the \cs{include} file hooks (only the generic 
 file hooks from \cs{InputIfFileExists} are run).
 % 
 \githubissue{645}
@@ -635,29 +622,30 @@ package files that defines \cs{@currentlabel} to also set
 \githubissue{300, 687}
 
 
-\subsection{Better error when text accent used in mathmode}
-%%  CCC \subsection{Better Error handling of text accents in Math}
-
-If you use a text accent such as \verb|\^| in math mode instead of the
-math accent \cs{hat}, then  \LaTeX\ gives a warning,
-which is  usually followed by a \TeX\ primitive error message produced by the \cs{accent} command.
-If the accent and base would form a composite character in text mode,
-(often the case with Unicode engines) then  typically  you will get
-a warning such as\\
-\verb|  Missing character:|\\
-\verb|       There is no á (U+00E1) in font cmmi10!|\\
-%%  CCC  fix non-ascii character in verbatim ?? 
-With \TeX\ implementations from 2020 onwards this warning can be
-converted to an error by setting \cs{tracinglostchars} to 3 in the preamble. We
-strongly recommend this, especially for Unicode engines where missing
-characters are common as no font supports the full Unicode range.
-%%  CCC   ADD see also ... another reason  in value of tracinglost
-%
-\githubissue{643}
-
-
+\subsection{Better message if text accent used in mathmode}
 
+Using text accents like \verb|\^| in math does not work 
+(and \TeX{} explicitly provides math accents such as \cs{hat} 
+for accessing such symbols in mathmode). Therefore LaTeX issued a 
+warning when such a wrongly placed accent was encountered 
+and, in many cases, this was followed by a strange, and apparently 
+unrelated, low-level error.  
+%
+This has now been changed so that the message generated by this 
+error is at least about accents, which we hope is less puzzling. 
 
+Discussion of such warnings or errors reminds us to reinforce 
+here a recommendation from earlier in this newsletter, as part 
+of the item on the value of \cs{tracinglostchars}.
+%
+Using \TeX\ implementations from 2020 onwards, any warning that 
+concerns missing characters can be
+converted to an error by setting \cs{tracinglostchars} to 3; we therefore 
+now strongly recommend changing this setting to 3, especially for 
+Unicode engines where such missing characters are common (because 
+no font supports the full Unicode range).
+%
+\githubissue{643}
 
 
 \section{Bug fixes}