[latex3-commits] [git/LaTeX3-latex3-latex2e] gh322+gh319: clarify handling of rule (docu change only) for #319 (11c964b4)

[Frank Mittelbach]

Repository : https://github.com/latex3/latex2e
On branch  : gh322+gh319
Link       : https://github.com/latex3/latex2e/commit/11c964b436ee6f1dc55262cfbb6b6891266aa44d

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

commit 11c964b436ee6f1dc55262cfbb6b6891266aa44d
Author: Frank Mittelbach <frank.mittelbach at latex-project.org>
Date:   Mon Jul 20 23:21:41 2020 +0200

    clarify handling of rule (docu change only) for #319


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

11c964b436ee6f1dc55262cfbb6b6891266aa44d
 required/tools/array.dtx   | 20 ++++++++++++++------
 required/tools/changes.txt |  5 +++++
 2 files changed, 19 insertions(+), 6 deletions(-)

diff --git a/required/tools/array.dtx b/required/tools/array.dtx
index 8b18ac46..ff963d7f 100644
--- a/required/tools/array.dtx
+++ b/required/tools/array.dtx
@@ -552,14 +552,16 @@
 %   \item rules can be placed between columns or rows thereby enlarging
 %   the table.
 % \end{enumerate}
-% \texttt{array.sty} implements the second possibility while the
-% default implementation in the \LaTeX{} kernel implements the first
-% concept. Both concepts have their merits but one has to be aware of
-% the individual implications.
+% For vertical rules \texttt{array.sty} implements the second
+% possibility while the default implementation in the \LaTeX{} kernel
+% implements the first concept.
+% Both concepts have their merits but
+% one has to be aware of the individual implications.
 % \begin{itemize}
 % \item
-%   With standard \LaTeX{} adding rules to a table will not affect the
-%   width or height of the table (unless double rules are used), e.g.,
+%   With standard \LaTeX{} adding vertical rules to a table will
+%   not affect the
+%   width of the table (unless double rules are used), e.g.,
 %   changing a preamble from \verb=lll= to \verb=l|l|l= does not
 %   affect the document other than adding rules to the table. In
 %   contrast, with \texttt{array.sty} a table that just fit the
@@ -602,6 +604,12 @@
 %   \end{center}
 % \end{itemize}
 %
+% Horizontal rules produced with \cs{hline} add to the table height in
+% both implementations but they differ in handling double \cs{hline}s.
+% In contrast a \cs{cline} does not change the table
+% height.\footnote{All a bit inconsistent, but nothing that can be
+% changed after being 30+ years in existence.}
+%
 % \subsection{Comparisons with older versions of \texttt{array.sty}}
 %
 % There are some differences in the way version 2.1 treats incorrect
diff --git a/required/tools/changes.txt b/required/tools/changes.txt
index 6c5d5916..5136d1ba 100644
--- a/required/tools/changes.txt
+++ b/required/tools/changes.txt
@@ -10,6 +10,11 @@ are not part of the distribution.
 	* array.dtx (subsection{Support for \firsthline ...):
 	Ensure that the tabular width isn't changed (gh/322)
 
+2020-07-20  Frank Mittelbach  <Frank.Mittelbach at latex-project.org>
+
+	* array.dtx (subsection{Handling of rules}):
+	Clarified the handling of rules, no code change (gh/319).
+
 2020-06-06  Johannes Braams  <Johannes.Braams at latex-project.org>
 
 	* verbatim.dtx: Save the value if \@filef at und before the call to