[latex3-commits] [git/LaTeX3-latex3-latex2e] master: discuss BOM character handling and amsmath changes [ci skip] (236b88b)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : master
Link       : https://github.com/latex3/latex2e/commit/236b88bd90b420436ce1b8077647675d5087a97e

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

commit 236b88bd90b420436ce1b8077647675d5087a97e
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Thu Apr 5 12:00:18 2018 +0200

    discuss BOM character handling and amsmath changes [ci skip]


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

236b88bd90b420436ce1b8077647675d5087a97e
 doc/ltnews28.tex |   41 +++++++++++++++++++++++++++++++++++++++--
 1 file changed, 39 insertions(+), 2 deletions(-)

diff --git a/doc/ltnews28.tex b/doc/ltnews28.tex
index 9d18a95..92c087e 100644
--- a/doc/ltnews28.tex
+++ b/doc/ltnews28.tex
@@ -161,7 +161,7 @@ the like) they always have to use
 in the preamble of their documents as otherwise \LaTeX{} will produce
 gibberish.
 
-\subsection*{The new default}
+\subsection{The new default}
 
 With this release, the default encoding for \LaTeX\ files has been
 changed from the ``fall through raw'' encoding to UTF-8 if used with
@@ -179,7 +179,7 @@ is no longer required to always specify
 will not hurt either.
 
 
-\subsection*{Compatibility}
+\subsection{Compatibility}
 
 For most existing documents this change will be transparent:
 \begin{itemize}
@@ -223,6 +223,24 @@ As usual, this change may also be reverted via the more general
 \package{latexrelease} package mechanism, by speciying a release date
 earlier than this release.
 
+
+\subsection{BOM: byte order mark handling}
+
+When using Unicode the first bytes of a file may be a, so called, BOM
+character (byte order mark) to indicate the byte oder used in the
+file. While this is not required with UTF-8 encoded files (where the
+byte order is known) it is nevertheless allowed by the standard and
+some editors add that byte sequence to the beginning of a file. In the
+past such files would have generated a ``Missing begin document''
+error or displayed strange characters when loaded at a later stage.
+
+With the addition of UTF-8 support to the kernel it is now possible to
+identify and ignore such BOMs characters even before
+\verb=\documentclass= so that these issues will no longer be showing
+up.
+
+
+
 \section[A general rollback concept]
         {A general rollback concept for packages and classes}
 
@@ -299,6 +317,18 @@ off-chance that code that hooked into internals of \pkg{multicol}
 needs adjustment.
 
 
+\section{Changes to packages in the amsmath category}
+
+With this release of \LaTeX{} a few minor issues with \pkg{amsmath}
+have been corrected.
+
+\subsection{Updated user's guide}
+
+Furthermore, \texttt{amsldoc.pdf}, the AMS user's
+guide for the \pkg{amsmath} package~\cite{amsldoc}, has been updated
+from version~2.0 to~2.1 to incorporate changes and corrections made
+between 2016 and 2018.
+
 
 \begin{thebibliography}{9}
   
@@ -323,6 +353,13 @@ needs adjustment.
   In: TUGboat, 38\#2, 2017.
   \url{https://www.latex-project.org/publications/}
 
+\bibitem{amsldoc} American Mathematical Society and The \LaTeX3 Project:
+  \emph{User's Guide for the \texttt{amsmath} package} (Version 2.1).  
+  April 2018.
+  Available from
+  \url{https://www.ctan.org}
+  and distributed as part of every \LaTeX{} distribution.
+
 \end{thebibliography}
 
 \end{document}