[latex3-commits] [latex3/latex2e] develop: working on ltnews37 (WIP) (12ca79f9)
github at latex-project.org
github at latex-project.org
Wed May 10 21:19:28 CEST 2023
Repository : https://github.com/latex3/latex2e
On branch : develop
Link : https://github.com/latex3/latex2e/commit/12ca79f9508a31a3d0c734b96f08da6d37a9b0d0
>---------------------------------------------------------------
commit 12ca79f9508a31a3d0c734b96f08da6d37a9b0d0
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date: Wed May 10 21:19:28 2023 +0200
working on ltnews37 (WIP)
>---------------------------------------------------------------
12ca79f9508a31a3d0c734b96f08da6d37a9b0d0
base/doc/ltnews37.tex | 193 +++++++++++++--------
.../testfiles-mathtagging/mathcapture-tag-001.tpf | 150 ++++++++--------
2 files changed, 193 insertions(+), 150 deletions(-)
diff --git a/base/doc/ltnews37.tex b/base/doc/ltnews37.tex
index 3bda6478..def6d2b1 100644
--- a/base/doc/ltnews37.tex
+++ b/base/doc/ltnews37.tex
@@ -124,7 +124,8 @@
% \publicationday{01} % change this if it's not released on 1st of a month
\publicationmonth{June}
-\publicationyear{2023 --- DRAFT version for upcoming release}
+%\publicationyear{2023 --- DRAFT version for upcoming release}
+\publicationyear{2023}
\publicationissue{37}
@@ -142,7 +143,8 @@
\medskip
-\section{Introduction}
+%\section{Introduction}
+
\section{New functionality offered as part of the
@@ -168,9 +170,9 @@ alter internals of \LaTeX{}.
Also note that there are still several environments and commands
described in the \LaTeX{} manual that do not have tagging support yet,
-notably tabulars, floats, \texttt{tabbing} and the various math
-environment. They will get this support as part of \texttt{phase-III}
-between now and the June release.
+notably tabulars, \texttt{tabbing}, the various math environment and a
+few others. They will get this support as part of \texttt{phase-III},
+but some of them will be delayed until after the June release.
A prototype for math tagging (including support for the \pkg{amsmath}
environments) is already available, but it is mainly intended for
@@ -194,55 +196,6 @@ be accessed with \verb|texdoc -l latex-lab|.
Feedback is welcome!
Please use \url{https://github.com/latex3/latex2e/discussions/1010}.
-\section{Documentation improvements}
-
-
-\subsection{Displaying the exact release dates for \LaTeX{}}
-
-In some situations it is necessary to find out the exact release dates
-for older version of the \LaTeX{} format, for example, when you need
-to use different code in a package depending on the availablilty of a
-certain feature and you therefore want to use
-\cs{IfFormatAtLeastTF}\texttt\{\meta{date}\texttt\} or the
-rather horrible construction \verb/\@ifl at t@r\fmtversion{/\meta{date}\texttt\},
-if you
-want to cater for formats that are older than 2020.
-
-Or you know that your package is definitely not going to work with a
-format before a certain \meta{date}, in which case you could use
-\verb/\NeedsTeXFormat{LaTeX2e}[/\meta{date}\texttt] to ensure that any
- user is alerted if their format is too old.
-
-The big problem is to know the exact \meta{date} to put into such
-commands and in the past that was not that easy to find. You could have
-looked in the the file \file{changes.txt}, but that is hidden somewhere
-in your installation and if you try
-\verb*/texdoc -l changes.txt/ you get more than thirty results and the %*
-right file is by no means the first.
-
-Yukai Chou (\textsf{@muzimuzhi}) kindly provided a patch for this, so that we now have
-the exact dates for each \LaTeX{} format listed in an easy to remember
-place: in \file{ltnews.pdf} and that file conveniently also contains all major
-features and changes to \LaTeX{} over the years\Dash one of which is
-most likely the reason you need the \meta{date} date in the first
-place.
-
-It is given in parentheses in the newsletter title, thus this
-newsletter tells you that on
-%
-\makeatletter
-\mbox{\expandafter\@gobblenonyear\@year\@nil
- -\@julianmonthtonum\@month-\two at digits\@day}
-\makeatother
-%
-the command
-\cs{NewEnvironmentCopy}, a new \texttt{shipout} hook, etc.\ was made
-available. And looking into \file{ltnews.pdf} you can now easily find
-out that the \LaTeX3 programming layer was added on 2020-02-02
-(because the date was so nice) and not on the first of the month.
-%
-\githubissue{982}
-
\section{New or improved commands}
@@ -382,28 +335,14 @@ not use grouping.
\section{Code improvements}
-\subsection{\pkg{doc}: Index \texttt{\textbackslash\textvisiblespace} correctly}
+\subsection{\pkg{doc}: Handle \texttt{\textbackslash\textvisiblespace} correctly in the index}
-\emph{to write}
+Due to some problems in the code it wasn't possible to prevent
+\verb*=\ = from showing up in the index\Dash \verb=\DoNotIndex{\ }=, etc.\ had no effect. This has now been corrected.
%
\githubissue{943}
-\subsection{Default definition for \cs{do}}
-
-The command \cs{do} with its nice public name is in reality an
-internal command inherited from plain \TeX{} for list
-processing. However, it only got a definition when
-\verb=\begin{document}= was executed, with a result that a user
-definition in the preamble was unconditionally overwritten at this
-point. To properly alert the user that this command is not freely
-available we now already provide a definition in the format so that
-\cs{newcommand} and friends produce a proper error message instead of
-providing a definition that doesn't last.
-%
-\githubissue{975}
-
-
\subsection{\pkg{doc}: Support the \pkg{upquote} package}
The default quote and backquote characters in typewriter fonts are
@@ -439,6 +378,23 @@ desired effect.
\githubissue{953}
+\subsection{Default definition for \cs{do}}
+
+The command \cs{do} with its nice public name is in reality an
+internal command inherited from plain \TeX{} for list
+processing. However, it only got a definition when
+\verb=\begin{document}= was executed, with a result that a user
+definition in the preamble was unconditionally overwritten at this
+point. To properly alert the user that this command is not freely
+available we now already provide a definition in the format so that
+\cs{newcommand} and friends produce a proper error message instead of
+providing a definition that doesn't last.
+%
+\githubissue{975}
+
+
+
+
\subsection{New key for \env{filecontents}}
The \env{filecontents} environment warns on the terminal if a file
@@ -602,8 +558,12 @@ This has been fixed by correctly initializing the hook structure when
%
\githubissue{1052}
+
+
\section{Documentation improvements}
+\subsection{Updates to the guides}
+
When \LaTeXe{} was released, the team provided documentation for both document
authors and package/class developers in the two files \texttt{usrguide} and
\texttt{clsguide}. Over time, the team have augmented these documents as new
@@ -617,20 +577,103 @@ previously now frozen as \texttt{usrguide-historic} and \texttt{clsguide-histori
More material has been carried forward in the class/package guide than in the
user guide, but both are worth a re-read by experienced \LaTeX{} users.
-\section{Changes to packages in the \pkg{amsmath} category}
-\section{Changes to packages in the \pkg{graphics} category}
+
+\subsection{Displaying the exact release dates for \LaTeX{}}
+
+In some situations it is necessary to find out the exact release dates
+for older version of the \LaTeX{} format, for example, when you need
+to use different code in a package depending on the availablilty of a
+certain feature and you therefore want to use
+\cs{IfFormatAtLeastTF}\texttt\{\meta{date}\texttt\} or the
+rather horrible construction \verb/\@ifl at t@r\fmtversion{/\meta{date}\texttt\},
+if you
+want to cater for formats that are older than 2020.
+
+Or you know that your package is definitely not going to work with a
+format before a certain \meta{date}, in which case you could use
+\verb/\NeedsTeXFormat{LaTeX2e}[/\meta{date}\texttt] to ensure that any
+ user is alerted if their format is too old.
+
+The big problem is to know the exact \meta{date} to put into such
+commands and in the past that was not that easy to find. You could have
+looked in the the file \file{changes.txt}, but that is hidden somewhere
+in your installation and if you try
+\verb*/texdoc -l changes.txt/ you get more than thirty results and the %*
+right file is by no means the first.
+
+Yukai Chou (\textsf{@muzimuzhi}) kindly provided a patch for this, so that we now have
+the exact dates for each \LaTeX{} format listed in an easy to remember
+place: in \file{ltnews.pdf} and that file conveniently also contains all major
+features and changes to \LaTeX{} over the years\Dash one of which is
+most likely the reason you need the \meta{date} date in the first
+place.
+
+It is given in parentheses in the newsletter title, thus this
+newsletter tells you that on
+%
+\makeatletter
+\mbox{\expandafter\@gobblenonyear\@year\@nil
+ -\@julianmonthtonum\@month-\two at digits\@day}
+\makeatother
+%
+the command
+\cs{NewEnvironmentCopy}, a new \texttt{shipout} hook, etc.\ was made
+available. And looking into \file{ltnews.pdf} you can now easily find
+out that the \LaTeX3 programming layer was added on 2020-02-02
+(because the date was so nice) and not on the first of the month.
+%
+\githubissue{982}
+
+\subsection{Fresh from the press: \enquote{The \LaTeX{} Companion, third edition} is now in print}
+
+The third edition of \emph{The \LaTeX{} Companion} is now
+available. This is the end of five years of careful work and we hope
+that it will provide our readers with all the information they need to
+successfully navigate the \LaTeX{} ecosystem and efficiently produce
+beautiful documents.
+
+Since the publication of the last edition (2004) a lot has happened in
+the \LaTeX{} world and thus a complete rewrite was necessary. All
+chapters have been thoroughly revised and in many cases largely
+extended to describe new important functionality and features. More
+than 5,000 add-on packages have been analyzed in detail, out of which
+roughly 10\% have been chosen for inclusion in \emph{The \LaTeX{}
+Companion}. All important aspects of these packages are described to
+provide the user once again with a satisfying one-stop–shop experience
+for the decade to come.
+
+To cover what we thought worth describing today, the book nearly
+doubled in size. The print edition is therefore produced as a
+two-volume set and sold as a bundle. Both volumes come as hardcover
+with ribbons to easily mark pages in the book.
+
+To give you an idea of what is covered in the third edition you can
+find some excerpts at
+\begin{quote}
+\url{https://www.latex-project.org/news/2023/03/17/TLC3}
+\end{quote}
+
+The edition is also available as an eBook (Parts I and II combined)
+consisting of PDF and ePub format without DRM. Finally, the publisher
+offers the combination of the printed books and the digital versions at
+a very attractive price not available anywhere else.
+
+
+%\section{Changes to packages in the \pkg{amsmath} category}
+
+%\section{Changes to packages in the \pkg{graphics} category}
\section{Changes to packages in the \pkg{tools} category}
-\subsection{\pkg{multicol}: Fix handling of nested environments}
+\subsection{\pkg{multicol}: Better support for CJK languages}
The default minimum depth of each column in a \env{multicols}
corresponds to the depth of a \enquote{p} in the current font. This
helps to get some uniformity if rules are used between the columns and
makes sense for Latin-based languages. Until now it was hard-wired,
-but for CJK languages it is better to use a zero depth because there
+but for CJK (Chinese/Japanese/Korean) languages it is better to use a zero depth, because there
all characters have the same height and depth. And even with
Latin-based languages one might want to use the depth of a \cs{strut}
or that of a parenthesis. So we now offer a way to adjust this while
diff --git a/required/latex-lab/testfiles-mathtagging/mathcapture-tag-001.tpf b/required/latex-lab/testfiles-mathtagging/mathcapture-tag-001.tpf
index 1336c77a..c90a5e10 100644
--- a/required/latex-lab/testfiles-mathtagging/mathcapture-tag-001.tpf
+++ b/required/latex-lab/testfiles-mathtagging/mathcapture-tag-001.tpf
@@ -9,10 +9,10 @@ endobj
17 0 obj
<<
/Subtype /text#2Fplain/Type /EmbeddedFile /Params<</ModDate (D:20160520) >>
-/Length 217
+/Length 258
>>
stream
-\begin {align} A_1 &= N_0 (\lambda ; \Omega ') - \phi ( \lambda ; \Omega ') \\ A_2 &= \phi (\lambda ; \Omega ') \phi (\lambda ; \Omega ) \\ \intertext {and finally} A_3 &= \mathcal {N} (\lambda ; \omega ) \end {align}
+LaTeX formula starts \begin {align} A_1 &= N_0 (\lambda ; \Omega ') - \phi ( \lambda ; \Omega ') \\ A_2 &= \phi (\lambda ; \Omega ') \phi (\lambda ; \Omega ) \\ \intertext {and finally} A_3 &= \mathcal {N} (\lambda ; \omega ) \end {align} LaTeX formula ends
endstream
endobj
18 0 obj
@@ -398,7 +398,7 @@ endobj
<< /Type /StructElem /S /Formula /P 11 0 R /K <</Type /MCR /Pg 13 0 R/MCID 1>> /Alt <FEFF0041005F003100200026003D0020004E005F003000200028005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020002D0020005C007000680069002000280020005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020005C005C00200041005F003200200026003D0020005C00700068006900200028005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020005C00700068006900200028005C006C0061006D0062006400610020003B0020005C004F006D006500670061002000290020005C005C0020005C0069006E00740065007200740065007800740020007B0061006E0064002000660069006E0061006C006C0079007D00200041005F003300200026003D0020005C006D00610074006800630061006C0020007B004E007D00200028005C006C0061006D0062006400610020003B0020005C006F006D00650067006100200029> /ID (ID.004) >>
endobj
16 0 obj
-<< /Type /StructElem /S /Formula /P 11 0 R /K [19 0 R 24 0 R 29 0 R <</Type /MCR /Pg 13 0 R/MCID 11>> 36 0 R <</Type /MCR /Pg 13 0 R/MCID 13>>] /T <FEFF0061006C00690067006E> /ActualText <FEFF005C0062006500670069006E0020007B0061006C00690067006E007D00200041005F003100200026003D0020004E005F003000200028005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020002D0020005C007000680069002000280020005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020005C005C00200041005F003200200026003D0020005C00700068006900200028005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020005C00700068006900200028005C006C0061006D0062006400610020003B0020005C004F006D006500670061002000290020005C005C0020005C0069006E00740065007200740065007800740020007B0061006E0064002000660069006E0061006C006C0079007D00200041005F003300200026003D0020005C006D00610074006800630061006C0020007B004E007D00200028005C006C0061006D0062006400610020003B0020005C006F006D006500670061002000290020005C0065006E00640020007B0061006C00690067006E007D> /AF [18 0 R] /ID (ID.005) >>
+<< /Type /StructElem /S /Formula /P 11 0 R /K [19 0 R 24 0 R 29 0 R <</Type /MCR /Pg 13 0 R/MCID 11>> 36 0 R <</Type /MCR /Pg 13 0 R/MCID 13>>] /T <FEFF0061006C00690067006E> /ActualText <FEFF004C006100540065005800200066006F0072006D0075006C006100200073007400610072007400730020005C0062006500670069006E0020007B0061006C00690067006E007D00200041005F003100200026003D0020004E005F003000200028005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020002D0020005C007000680069002000280020005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020005C005C00200041005F003200200026003D0020005C00700068006900200028005C006C0061006D0062006400610020003B0020005C004F006D0065006700610020002700290020005C00700068006900200028005C006C0061006D0062006400610020003B0020005C004F006D006500670061002000290020005C005C0020005C0069006E00740065007200740065007800740020007B0061006E0064002000660069006E0061006C006C0079007D00200041005F003300200026003D0020005C006D00610074006800630061006C0020007B004E007D00200028005C006C0061006D0062006400610020003B0020005C006F006D006500670061002000290020005C0065006E00640020007B0061006C00690067006E007D0020004C006100540065005800200066006F0072006D0075006C006100200065006E006400730020> /AF [18 0 R] /ID (ID.005) >>
endobj
19 0 obj
<< /Type /StructElem /S /Formula /P 16 0 R /K [<</Type /MCR /Pg 13 0 R/MCID 2>> 21 0 R <</Type /MCR /Pg 13 0 R/MCID 4>>] /T <FEFF0061006C00690067006E0020002800700061007200740029> /ID (ID.006) >>
@@ -1373,89 +1373,89 @@ endobj
xref
0 79
0000000002 65535 f
-0000015051 00000 n
+0000015092 00000 n
0000000003 00000 f
0000000004 00000 f
0000000008 00000 f
-0000020134 00000 n
-0000015134 00000 n
-0000015571 00000 n
+0000020339 00000 n
+0000015175 00000 n
+0000015612 00000 n
0000000000 00000 f
-0000016150 00000 n
-0000016235 00000 n
-0000016322 00000 n
+0000016191 00000 n
+0000016276 00000 n
+0000016363 00000 n
0000000015 00000 n
-0000014537 00000 n
-0000016459 00000 n
+0000014578 00000 n
+0000016500 00000 n
0000000046 00000 n
-0000017339 00000 n
+0000017380 00000 n
0000000077 00000 n
-0000000429 00000 n
-0000018446 00000 n
-0000000664 00000 n
-0000018658 00000 n
-0000000695 00000 n
-0000000726 00000 n
-0000018766 00000 n
-0000000757 00000 n
-0000019226 00000 n
-0000000788 00000 n
-0000000819 00000 n
-0000019334 00000 n
-0000000850 00000 n
-0000019819 00000 n
-0000019907 00000 n
-0000000881 00000 n
-0000000912 00000 n
-0000000944 00000 n
-0000020025 00000 n
-0000000976 00000 n
-0000001008 00000 n
-0000001040 00000 n
-0000014672 00000 n
-0000012172 00000 n
-0000074301 00000 n
-0000081657 00000 n
-0000072360 00000 n
-0000076237 00000 n
-0000080787 00000 n
-0000078514 00000 n
-0000081821 00000 n
-0000015098 00000 n
-0000015268 00000 n
-0000015534 00000 n
-0000016087 00000 n
-0000020270 00000 n
-0000020723 00000 n
-0000020747 00000 n
-0000020789 00000 n
-0000021113 00000 n
-0000021137 00000 n
-0000021759 00000 n
-0000030204 00000 n
-0000030443 00000 n
-0000043914 00000 n
-0000044211 00000 n
-0000052144 00000 n
-0000052377 00000 n
-0000059991 00000 n
-0000060217 00000 n
-0000067613 00000 n
-0000067836 00000 n
-0000070500 00000 n
-0000070718 00000 n
-0000072518 00000 n
-0000074459 00000 n
-0000076393 00000 n
-0000078671 00000 n
-0000080944 00000 n
-0000081880 00000 n
-0000081998 00000 n
+0000000470 00000 n
+0000018651 00000 n
+0000000705 00000 n
+0000018863 00000 n
+0000000736 00000 n
+0000000767 00000 n
+0000018971 00000 n
+0000000798 00000 n
+0000019431 00000 n
+0000000829 00000 n
+0000000860 00000 n
+0000019539 00000 n
+0000000891 00000 n
+0000020024 00000 n
+0000020112 00000 n
+0000000922 00000 n
+0000000953 00000 n
+0000000985 00000 n
+0000020230 00000 n
+0000001017 00000 n
+0000001049 00000 n
+0000001081 00000 n
+0000014713 00000 n
+0000012213 00000 n
+0000074506 00000 n
+0000081862 00000 n
+0000072565 00000 n
+0000076442 00000 n
+0000080992 00000 n
+0000078719 00000 n
+0000082026 00000 n
+0000015139 00000 n
+0000015309 00000 n
+0000015575 00000 n
+0000016128 00000 n
+0000020475 00000 n
+0000020928 00000 n
+0000020952 00000 n
+0000020994 00000 n
+0000021318 00000 n
+0000021342 00000 n
+0000021964 00000 n
+0000030409 00000 n
+0000030648 00000 n
+0000044119 00000 n
+0000044416 00000 n
+0000052349 00000 n
+0000052582 00000 n
+0000060196 00000 n
+0000060422 00000 n
+0000067818 00000 n
+0000068041 00000 n
+0000070705 00000 n
+0000070923 00000 n
+0000072723 00000 n
+0000074664 00000 n
+0000076598 00000 n
+0000078876 00000 n
+0000081149 00000 n
+0000082085 00000 n
+0000082203 00000 n
trailer
<< /Size 79
/Root 77 0 R
/Info 78 0 R
/ID [<9BD18DF3359C1216B83ADB4AA401CC9A> <9BD18DF3359C1216B83ADB4AA401CC9A>] >>
startxref
-82142
+82347
%%EOF
More information about the latex3-commits
mailing list.