tcolorbox (9oct20)

git-svn-id: svn://tug.org/texlive/trunk@56610 c570f23f-e606-0410-a88d-b1316a301751

11 files changed, 86 insertions, 16 deletions

diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index f78792d54a0..0b75eb6406f 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
+++ b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
@@ -1,4 +1,4 @@
-%% The LaTeX package tcolorbox - version 4.41 (2020/09/29)
+%% The LaTeX package tcolorbox - version 4.42 (2020/10/09)
 %%
 %% -------------------------------------------------------------------------------------------
 %% Copyright (c) 2006-2020 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -1184,3 +1184,11 @@ version 4.40 (2020/09/25)
 
 version 4.41 (2020/09/29)
 - bug fix (#120): color bleeding for xelatex and breakable boxes (since 4.32)
+
+version 4.42 (2020/10/09)
+- due to several problems with the color algorithm introduced with version 4.32,
+  essentially reversion to the proven pre 4.32 method.
+  * support of luacolor persists (since 4.32)
+  * color stacks (by pdfcol) are not mandatory any more,
+    but are optional now with 'use color stack'. Note that effects of whatsits
+    on the vertical space have to be expected.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index 219c0ae662e..55edf61ca4d 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/README
+++ b/Master/texmf-dist/doc/latex/tcolorbox/README
@@ -1,4 +1,4 @@
-%% The LaTeX package tcolorbox - version 4.41 (2020/09/29)
+%% The LaTeX package tcolorbox - version 4.42 (2020/10/09)
 %%
 %% -------------------------------------------------------------------------------------------
 %% Copyright (c) 2006-2020 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf
index 05ef9686bd5..8df5f0fb63b 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex
index 219b3316612..7561a6fa3d9 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex
@@ -1,4 +1,4 @@
-%% The LaTeX package tcolorbox - version 4.41 (2020/09/29)
+%% The LaTeX package tcolorbox - version 4.42 (2020/10/09)
 %% tcolorbox-example-poster.tex: a poster example for tcolorbox
 %%
 %% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
index 3506915b03c..8d7e1b9e177 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
index 3849a1c2235..0d1cb965bdf 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
@@ -1,4 +1,4 @@
-%% The LaTeX package tcolorbox - version 4.41 (2020/09/29)
+%% The LaTeX package tcolorbox - version 4.42 (2020/10/09)
 %% tcolorbox-example.tex: an example for tcolorbox
 %%
 %% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf
index 71cfb4f99bd..71727a970e8 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex
index b54b5585b22..de4c7d17b92 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex
@@ -1,5 +1,5 @@
 % \LaTeX-Main\
-%% The LaTeX package tcolorbox - version 4.41 (2020/09/29)
+%% The LaTeX package tcolorbox - version 4.42 (2020/10/09)
 %% tcolorbox-tutorial-poster.tex: a tutorial for poster creation with tcolorbox
 %%
 %% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
index b8d678d8d2d..9720be99f06 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
@@ -110,13 +110,9 @@ parameters. The differences are:
   box\footnote{\refKey{/tcb/enforce breakable} acts like \refKey{/tcb/breakable} until |tcolorbox| 3.04.}.
   \textbf{But, a breakable box inside a breakable box will usually give a mess.}
 \item\tcbdocmarginnote{\tcbdocnew{2020-09-17}}
-  Depending on the \LaTeX\ compiler, if your text content contains some text
+  Depending on the \LaTeX\ engine, if your text content contains some text
   color changing commands, your color may not survive the break to the next box.
-  Since |tcolorbox|~4.32, |pdflatex| and |lualatex| should not have that
-  problem. For |xelatex|, with the |fontspec| package,
-  you can use
-  |\addfontfeatures{Color=mycolor}|
-  to add a font color which survives the break.
+  See the documentation for \refKey{/tcb/use color stack} for more information.
 \item\tcbdocmarginnote{\tcbdocnew{2014-10-30}}
   The |perpage| option of the |footmisc| package is deliberately deactivated
   inside a breakable box since all footnotes are placed at the end
@@ -222,7 +218,7 @@ parameters. The differences are:
   \item Setting a \meta{length} to a negative value means that
         the sum of this negative value and the naturally available space is used
         for breaking (boxes will shrink in height).
-        That that before version 4.10 negative values were treated like |0pt|.
+        Note that before version 4.10 negative values were treated like |0pt|.
   \end{itemize}
 \begin{dispExample}
 % \usepackage{multicol,lipsum}
@@ -313,6 +309,72 @@ The |break at| option can be used to insert better break points by hand.
 \end{docTcbKey}
 
 
+
+\begin{docTcbKey}[][doc new=2020-10-09]{use color stack}{\colOpt{=true\textbar false}}{default |true|, initially |false|}
+  Depending on the \LaTeX\ engine and loaded packages, if your text contains some
+  color changing commands, your color may not survive the break to the next box.
+  For some engines, there is support for additional color stacks which
+  allow colors to survive breaks. Such an color stack  can be activated
+  by \refKey{/tcb/use color stack} with help of the |pdfcol| package.
+  This can be done globally or per box.
+  \begin{marker}
+  Note that activating \refKey{/tcb/use color stack} inserts a color command with a \emph{whatsit}
+  at the begin of the upper part and of the lower part of a \refEnv{tcolorbox}.
+  This \emph{may} add additional vertical space, e.g. if your box text starts
+  with a list like \emph{enumerate}!
+  \end{marker}
+  \begin{itemize}
+  \item pdf\TeX: color stacks supported.
+  \item Lua\TeX: color stacks supported, but you should consider loading the
+     |luacolor| package \emph{instead} which avoids the spacing problem.
+  \item Xe\TeX: color stacks not supported (yet?). From hearsay,
+    with the |fontspec| package, you may use |\addfontfeatures{Color=mycolor}|
+    to add a font color which survives the break.
+  \end{itemize}
+  If |pdfcol| cannot initialize an additional color stack for the used engine,
+  \refKey{/tcb/use color stack} is silently ignored.
+
+\clearpage
+\begin{dispExample}
+% \usepackage{multicol,lipsum}
+\begin{multicols}{2}\footnotesize
+Breakable box without color stack.
+\begin{tcolorbox}[enhanced jigsaw,
+  size=small, colframe=gray, colback=yellow!10!white, colupper=blue,
+  enforce breakable,% use only breakable in the real world!
+  vfill before first, pad at break=1mm, break at=3.3cm ]
+    \begin{itemize}\item Some blue text.\end{itemize}
+    {\color{red}\itshape\lipsum[2]}\par
+    More blue text.
+\end{tcolorbox}
+Text after box.
+\end{multicols}
+\end{dispExample}
+
+We do again with \refKey{/tcb/use color stack}. Observe the additional spacing
+at the begin of the box:
+
+\begin{dispExample}
+% \usepackage{multicol,lipsum}
+\begin{multicols}{2}\footnotesize
+Breakable box with color stack.
+\begin{tcolorbox}[enhanced jigsaw, use color stack,
+  size=small, colframe=gray, colback=yellow!10!white, colupper=blue,
+  enforce breakable,% use only breakable in the real world!
+  vfill before first, pad at break=1mm, break at=3.3cm ]
+    \begin{itemize}\item Some blue text.\end{itemize}
+    {\color{red}\itshape\lipsum[2]}\par
+    More blue text.
+\end{tcolorbox}
+Text after box.
+\end{multicols}
+\end{dispExample}
+
+\end{docTcbKey}
+
+
+
+
 \clearpage
 \subsection{Option Keys for the Break Appearance}
 
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index 312bc849e11..f4d99c53ae0 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
index 95be8571497..39dcde9f3b9 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
@@ -1,5 +1,5 @@
 % \LaTeX-Main\
-%% The LaTeX package tcolorbox - version 4.41 (2020/09/29)
+%% The LaTeX package tcolorbox - version 4.42 (2020/10/09)
 %% tcolorbox.tex: Manual
 %%
 %% -------------------------------------------------------------------------------------------
@@ -43,8 +43,8 @@
 \setlength{\bibitemsep}{\smallskipamount}
 \addbibresource{tcolorbox.doc.bib}
 
-\def\version{4.41}%
-\def\datum{2020/09/29}%
+\def\version{4.42}%
+\def\datum{2020/10/09}%
 \makeindex
 
 \hypersetup{
@@ -62,7 +62,7 @@
 %\geometry{showframe}
 %\tcbset{draftmode}
 \tcbset{/tcb/external/-}% for final run
-%\includeonly{tcolorbox.doc.intro,tcolorbox.doc.quickref,tcolorbox.doc.coremacros}
+%\includeonly{tcolorbox.doc.breakable}
 
 %\hypersetup{colorlinks=false}