[latex3-commits] [latex3/latex2e] ltmarks-multicol: more change log entries and preface and draft section in ltnews41 (65a3478a2)
github at latex-project.org
github at latex-project.org
Tue Nov 12 00:59:58 CET 2024
Repository : https://github.com/latex3/latex2e
On branch : ltmarks-multicol
Link : https://github.com/latex3/latex2e/commit/65a3478a275365c1ef77c63ccdf39f2c1c21f0f8
>---------------------------------------------------------------
commit 65a3478a275365c1ef77c63ccdf39f2c1c21f0f8
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date: Tue Nov 12 00:59:58 2024 +0100
more change log entries and preface and draft section in ltnews41
>---------------------------------------------------------------
65a3478a275365c1ef77c63ccdf39f2c1c21f0f8
base/changes.txt | 26 ++++++++------------------
base/doc/ltnews41.tex | 8 +++++++-
required/tools/changes.txt | 3 +++
required/tools/multicol.dtx | 37 +++++++++++++++++++++++++++++--------
4 files changed, 47 insertions(+), 27 deletions(-)
diff --git a/base/changes.txt b/base/changes.txt
index 767571565..63d42e0a4 100644
--- a/base/changes.txt
+++ b/base/changes.txt
@@ -1,3 +1,11 @@
+================================================================================
+This file lists changes to the LaTeX2e files in reverse chronological order
+of publication (therefore the dates might be out of sequence if there are
+hotfixes). It is provided for convenience only. It therefore makes no claims
+to completeness or accuracy and it contains some references to files that are
+not part of the distribution.
+================================================================================
+
2024-11-10 Frank Mittelbach <Frank.Mittelbach at latex-project.org>
* ltmarks.dtx (subsection{Placing and retrieving marks}):
@@ -8,14 +16,6 @@
Added \__mark_clear_structure:n
-================================================================================
-This file lists changes to the LaTeX2e files in reverse chronological order
-of publication (therefore the dates might be out of sequence if there are
-hotfixes). It is provided for convenience only. It therefore makes no claims
-to completeness or accuracy and it contains some references to files that are
-not part of the distribution.
-================================================================================
-
2024-11-06 Joseph Wright <Joseph.Wright at latex-project.org>
* ltoutenc.dtx
Add support for \={i} to OT1 and T1
@@ -476,16 +476,6 @@ All changes above are only part of the development branch for the next release.
* usrguide.tex
Re-introduce \listfiles (extended) description
-2023-11-14 Frank Mittelbach <Frank.Mittelbach at latex-project.org>
-
- * ltmarks.dtx:
- Generalized the support for extracting marks to cover cases like multicols.
-
- Some internal commands renamed and extended.
- Renamed \__mark_update_structure:nn to \__mark_update_structure_from_material:nn
- Added \__mark_get_marks_for_reinsertion:nNN
- Added \ShowMarksAt for debugging (might not stay this way)
-
2023-11-09 Yukai Chou <muzimuzhi at gmail.com>
* clsguide-historic.tex, usrguide.tex:
Replace quotation with quote envs for zero para indent
diff --git a/base/doc/ltnews41.tex b/base/doc/ltnews41.tex
index 0c9751704..b2fc79f90 100644
--- a/base/doc/ltnews41.tex
+++ b/base/doc/ltnews41.tex
@@ -161,7 +161,13 @@
%\section{Changes to packages in the \pkg{graphics} category}
-%\section{Changes to packages in the \pkg{tools} category}
+\section{Changes to packages in the \pkg{tools} category}
+
+\subsection{\pkg{multicol}:\ Full support for extended marks}
+
+\emph{to write}
+
+
%\section{Changes to files in the \pkg{cyrillic} category}
diff --git a/required/tools/changes.txt b/required/tools/changes.txt
index 4b84cfb0e..7765b0950 100644
--- a/required/tools/changes.txt
+++ b/required/tools/changes.txt
@@ -11,6 +11,9 @@ are not part of the distribution.
mechanism throughout.
\usepackage{multicol}[=v1.9] reverts to previous approach.
+ Change the definition of \leftmark and \rightmark to use the new
+ mechanism and not any longer the legacy on.
+
2024-11-03 Ulrike Fischer <Ulrike.Fischer at latex-project.org>
* calc.dtx: suspend tagging in \@settodim (tagging/628)
diff --git a/required/tools/multicol.dtx b/required/tools/multicol.dtx
index 23d5f0e05..ad218c350 100644
--- a/required/tools/multicol.dtx
+++ b/required/tools/multicol.dtx
@@ -182,6 +182,23 @@
% the scope of the environment.
% \end{abstract}
%
+% \begin{multicols}{3}[\section*{Preface to versions 1.9 + 2.0}]
+%
+% Version 1.9 added tagging support and also a number of smaller
+% enhancements, such as as and optional argument to
+% \cs{columnbreak} to allow for conditional breaks instead of
+% forced ones. The min column depth was also made customizable
+% (previously it was hardwired to the depth of \enquote{p}) to support
+% special cases and in particular languages that do not have
+% characters with any noticeable depth such as, for example, Japanese.
+%
+% Verson 2.0 then simplified and improved the mark handling, by
+% fully supporting the new mark mechanism of \LaTeX.
+%
+% \end{multicols}
+%
+%
+%
% \begin{multicols}{3}[\section*{Preface to version 1.8}]
% The 1.8 release improves on the balancing approach. If due to a
% limited number of break points (e.g., due to large objects) the
@@ -994,7 +1011,7 @@
{\c at tracingmulticols\tw@}
% \end{macrocode}
%
-% \changes{v2.0a}{2024/11/10}{}
+% \changes{v2.0a}{2024/11/10}{Add \cs{DebugMarksOn} to the show options}
% \begin{macrocode}
\DeclareOption{markshow}
{\c at tracingmulticols\thr@@
@@ -1765,8 +1782,10 @@
% \begin{macrocode}
\global\setbox\mc at boxedresult\vbox{%
% \end{macrocode}
-%
-% \changes{v2.0a}{2024/11/10}{}
+% We first update the mark structures and collect all marks that
+% need reinsertion once \mc{} has finished. The we output the boxed
+% columns and finally we reinsert the marks.
+% \changes{v2.0a}{2024/11/10}{Use new mark mechanism}
% \begin{macrocode}
\mc at handle@marks at and@reinserts
{in multicol (boxed mode)}%
@@ -2441,8 +2460,9 @@
\setbox\@cclv\vbox
{%
% \end{macrocode}
-%
-% \changes{v2.0a}{2024/11/10}{}
+% If we make a page while still inside the \mc{} environment we
+% have to handle column and page mark structures.
+% \changes{v2.0a}{2024/11/10}{Use new mark mechanism}
% \begin{macrocode}
\mc at handle@col at andpage@marks
{in multicol OR (full page)}%
@@ -2815,9 +2835,10 @@
% \begin{macrocode}
\unvbox\partial at page
% \end{macrocode}
-% Then we return the gathered
-% material to the main vertical list.
-% \changes{v2.0a}{2024/11/10}{}
+% We then handle mark structures of the columns, return the gathered
+% material to the main vertical list and then also reinsert the
+% first and last marks that have been found in the columns.
+% \changes{v2.0a}{2024/11/10}{Use new mark mechanism}
% \begin{macrocode}
\mc at handle@marks at and@reinserts
{in multicol OR (balancing)}%
More information about the latex3-commits
mailing list.