[latex3-commits] [latex3/latex2e] UF-latexlab-toc, defaultT1, develop, gh-1265, tlc3-errata, update-UseTaggingSocket: docu fix for #1385 (5c029f97c)

[github at latex-project.org]

Repository : https://github.com/latex3/latex2e
On branches: UF-latexlab-toc,defaultT1,develop,gh-1265,tlc3-errata,update-UseTaggingSocket
Link       : https://github.com/latex3/latex2e/commit/5c029f97c2a1a316b0aa9539d960a9c018c2051f

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

commit 5c029f97c2a1a316b0aa9539d960a9c018c2051f
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Fri Jun 28 10:05:48 2024 +0200

    docu fix for #1385


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

5c029f97c2a1a316b0aa9539d960a9c018c2051f
 required/tools/changes.txt  |  7 +++++++
 required/tools/multicol.dtx | 25 +++++++++++++++----------
 2 files changed, 22 insertions(+), 10 deletions(-)

diff --git a/required/tools/changes.txt b/required/tools/changes.txt
index b61f93944..d9f713b8a 100644
--- a/required/tools/changes.txt
+++ b/required/tools/changes.txt
@@ -5,6 +5,13 @@ completeness or accuracy and it contains some references to files that
 are not part of the distribution.
 =======================================================================
 
+2024-06-28  Frank Mittelbach  <Frank.Mittelbach at latex-project.org>
+
+	* multicol.dtx:
+	Update documentation to reflect that \sloppy isn't using
+	\tolerance=10000 any longer (it did in the early days of LaTeX)
+	(gh/1385)
+
 ================================================================================
 All changes above are only part of the development branch for the next release.
 ================================================================================
diff --git a/required/tools/multicol.dtx b/required/tools/multicol.dtx
index 4d8644800..15eaab28c 100644
--- a/required/tools/multicol.dtx
+++ b/required/tools/multicol.dtx
@@ -20,7 +20,7 @@
 % \iffalse    This is a METACOMMENT
 %
 %% Package `multicol' to use with LaTeX2e
-%% Copyright 1989-2023 Frank Mittelbach
+%% Copyright 1989-2024 Frank Mittelbach
 %%
 %%  In addition to the terms of LPPL any distributed version
 %%  (unchanged or modified) of multicol has to keep the statement
@@ -98,7 +98,7 @@
 %<driver> \ProvidesFile{multicol.drv}
 % \fi
 %         \ProvidesFile{multicol.dtx}
-          [2024/05/23 v1.9h  multicolumn formatting (FMi)]
+          [2024/06/28 v1.9h  multicolumn formatting (FMi)]
 %
 %
 %
@@ -403,12 +403,17 @@
 % the most important is called |\tolerance|: this controls the
 % allowed `looseness' (i.e.\ the amount of blank space between words).
 % Its default value is 200 (the \LaTeX{} |\fussy|) which is too
-% small for narrow columns. On the other hand the |\sloppy|
-% declaration (which sets |\tolerance| to $10000=\infty$) is too
-% large, allowing really bad spacing.\footnote{Look at the next
-% paragraph, it was set with the \cs{sloppy} declaration.}
-%
-% \begin{sloppypar}
+% small for narrow columns.
+
+% Setting it to \texttt{10000} (a.k.a.\ $\infty$) means arbitrary bad
+% lines are possible.  With that setting \LaTeX{} will make most lines
+% perfect but intermix them with really bad lines. This was the
+% setting originally used by \cs{sloppy} (nowadays it is a bit more
+% cautious and used \texttt{9999} which makes a huge
+% difference).\footnote{Look at the next paragraph, it was set with
+% the \cs{tolerance}\texttt{=10000}.}
+%
+% \begin{sloppypar}\tolerance=10000
 % \DescribeMacro\multicoltolerance \DescribeMacro\multicolpretolerance
 %  We therefore use a |\multicoltolerance| parameter for the
 % |\tolerance| value inside the \mc{} environment.  Its default value
@@ -417,10 +422,10 @@
 % be done outside the \mc{} environment.  Since |\tolerance| is set
 % to |\multicoltolerance| at the beginning of every \textsf{multicols}
 % environment one can locally overwrite this default by assigning
-% \verb*+\tolerance = +\meta{desired value}. There also exists a
+% \cs{tolerance}\texttt{=}\meta{desired value}. There also exists a
 % |\multicolpretolerance| parameter holding the value for
 % |\pretolerance| within a \mc{} environment. Both parameters are
-% usually used only by package designers.
+% usually used only by package  or class designers.
 % \end{sloppypar}
 %
 % Generation of multicolumn output can be divided into two parts.  In