summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2019-09-19 20:45:10 +0000
committerKarl Berry <karl@freefriends.org>2019-09-19 20:45:10 +0000
commite86345f5dc9769da6df2b57003f79e20506092cd (patch)
tree6af2fa73cd131a3fd307baeb710bb771c56ece8f /Master/texmf-dist/doc/latex/tcolorbox
parent1e31c251270941078ff4874d90758f122a4a51ed (diff)
tcolorbox (19sep19)
git-svn-id: svn://tug.org/texlive/trunk@52128 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES24
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdfbin273214 -> 274152 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin456409 -> 457694 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdfbin440925 -> 442887 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex78
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex152
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex28
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex13
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty1
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex22
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin7938126 -> 7152247 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex10
16 files changed, 282 insertions, 54 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 721d974d1e1..4775a12354d 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.20 (2019/03/02)
+%% The LaTeX package tcolorbox - version 4.21 (2019/09/19)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2019 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -1084,3 +1084,25 @@ version 4.20 (2019/03/02)
* new options: 'beamer hidden', 'beamer alerted', 'hide', 'alert'
* option 'only' moved from package to skins library
- new documentation section '13 Beamer Support'
+
+version 4.21 (2019/09/19)
+- bug fix (#71): 'shield externalize' should be effective on all tcolorbox layers
+- bug fix (#76): 'spread inwards', 'spread outwards', 'spread sidewards' gave
+ wrong results for some document geometry settings
+- new options (#75): 'tabulars', 'tabulars*'
+- library 'extras':
+ * bug fix: all 'extras ...' options from library 'hooks' took code instead of options
+ * new options (#73): 'minted options app', 'minted options pre',
+ 'listing options app', 'listing options pre'
+- library 'xparse':
+ * bug fix: options 'IfNoValueTF', 'IfValueTF', 'IfBooleanTF' failed
+ to recognize arguments in some code line breaks situations
+- library 'documentation':
+ TikZ path operation documentation (#65):
+ * new color name: 'Fade'
+ * new macros and environments: '\colFade', 'docPathOperation',
+ '\refPathOperation', '\refPathOperation*'
+ * new options: 'color fade', 'color path', 'doc label', 'doc head path',
+ 'before doc body path', 'after doc body path'
+ * new language string: 'path', 'paths'
+- documentation: checkerbox for opacity examples was too dark
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index 67e8c16547e..ad3735e6643 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.20 (2019/03/02)
+%% The LaTeX package tcolorbox - version 4.21 (2019/09/19)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2019 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 6745fadb2be..3e10c423608 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf
Binary files differ
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 4cd8461954e..1f67a3c87be 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.20 (2019/03/02)
+%% The LaTeX package tcolorbox - version 4.21 (2019/09/19)
%% 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 ea5dc03ad17..0e99b2a5391 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex
index 64bd2eacedb..5ed9ba9a676 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.20 (2019/03/02)
+%% The LaTeX package tcolorbox - version 4.21 (2019/09/19)
%% 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 67a36b97ebe..b50b13514b5 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf
Binary files differ
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 11d6d47954b..9c52b6c68cc 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.20 (2019/03/02)
+%% The LaTeX package tcolorbox - version 4.21 (2019/09/19)
%% tcolorbox-tutorial-poster.tex: a tutorial for poster creation with tcolorbox
%%
%% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
index b8effa83e99..dfe82a456ea 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -1535,7 +1535,7 @@ skin variants, see \Vref{subsec:skinjigsaw}.
\begin{docTcbKey}{opacityframe}{=\meta{fraction}}{no default, initially \texttt{1.0}}
Sets the frame opacity of the box to the given \meta{fraction}.
-\begin{exdispExample*}{opacityframe}{sbs,lefthand ratio=0.6,segmentation style={pattern=checkerboard light gray}}
+\begin{exdispExample*}{opacityframe}{sbs,lefthand ratio=0.6,segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcolorbox}[opacityframe=0.25,
colframe=red]
This is a \textbf{tcolorbox}.
@@ -1545,7 +1545,7 @@ This is a \textbf{tcolorbox}.
\begin{docTcbKey}{opacityback}{=\meta{fraction}}{no default, initially \texttt{1.0}}
Sets the background opacity of the box to the given \meta{fraction}.
-\begin{exdispExample*}{opacityback}{sbs,lefthand ratio=0.6,segmentation style={pattern=checkerboard light gray}}
+\begin{exdispExample*}{opacityback}{sbs,lefthand ratio=0.6,segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcolorbox}[standard jigsaw,colframe=red,
opacityframe=0.5, opacityback=0.5]
This is a \textbf{tcolorbox}.
@@ -1556,7 +1556,7 @@ This is a \textbf{tcolorbox}.
\begin{docTcbKey}{opacitybacktitle}{=\meta{fraction}}{no default, initially \texttt{1.0}}
Sets the title background opacity of the box to the given \meta{fraction}.
-\begin{exdispExample*}{opacitybacktitle}{sbs,lefthand ratio=0.6,segmentation style={pattern=checkerboard light gray}}
+\begin{exdispExample*}{opacitybacktitle}{sbs,lefthand ratio=0.6,segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcolorbox}[standard jigsaw,colframe=red,
opacityframe=0.5, opacitybacktitle=0.5,
title filled, title=This is a title]
@@ -1569,7 +1569,7 @@ This is a \textbf{tcolorbox}.
\begin{docTcbKey}{opacityfill}{=\meta{fraction}}{style, no default, initially \texttt{1.0}}
Sets the fill opacity for frame, interior and optionally the title background
to the given \meta{fraction}.
-\begin{exdispExample*}{opacityfill}{sbs,lefthand ratio=0.6,segmentation style={pattern=checkerboard light gray}}
+\begin{exdispExample*}{opacityfill}{sbs,lefthand ratio=0.6,segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcolorbox}[standard jigsaw,colframe=red,
opacityfill=0.7, title=This is a title]
This is a \textbf{tcolorbox}.
@@ -1582,7 +1582,7 @@ This is a \textbf{tcolorbox}.
Sets the text opacity of the upper box part to the given \meta{fraction}.
\begin{exdispExample*}{opacityupper}{sbs,lefthand ratio=0.6}
\begin{tcolorbox}[enhanced,opacityupper=0.5,
- interior style={pattern=checkerboard light gray}]
+ interior style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\end{exdispExample*}
@@ -1593,7 +1593,7 @@ This is a \textbf{tcolorbox}.
Sets the text opacity of the lower box part to the given \meta{fraction}.
\begin{exdispExample*}{opacitylower}{sbs,lefthand ratio=0.6}
\begin{tcolorbox}[enhanced,opacitylower=0.5,
- interior style={pattern=checkerboard light gray}]
+ interior style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}]
This is a \textbf{tcolorbox}.
\tcblower
This is the lower part.
@@ -1605,7 +1605,7 @@ This is the lower part.
Sets the text opacity of the upper and the lower box part to the given \meta{fraction}.
\begin{exdispExample*}{opacitytext}{sbs,lefthand ratio=0.6}
\begin{tcolorbox}[enhanced,opacitytext=0.5,
- interior style={pattern=checkerboard light gray}]
+ interior style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}]
This is a \textbf{tcolorbox}.
\tcblower
This is the lower part.
@@ -1620,14 +1620,14 @@ This is the lower part.
\begin{tcolorbox}[enhanced,opacitytitle=0.7,
coltitle=black,
fonttitle=\bfseries,title=This is a title,
- title style={pattern=checkerboard light gray}]
+ title style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}]
This is a \textbf{tcolorbox}.
\end{tcolorbox}
\end{exdispExample*}
\end{docTcbKey}
-\begin{exdispExample*}{opacity_general}{segmentation style={pattern=checkerboard light gray}}
+\begin{exdispExample*}{opacity_general}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcolorbox}[enhanced jigsaw,fonttitle=\bfseries,title=This is a title,
opacityframe=0.5,opacityback=0.25,opacitybacktitle=0.25,opacitytext=0.8,
colback=red!5!white,colframe=red!75!black,colbacktitle=yellow!20!red]
@@ -2336,6 +2336,55 @@ This is the end of my box.
\end{exdispExample}
\end{docTcbKey}
+
+\clearpage
+
+\begin{docTcbKey}[][doc new={2019-09-19}]{tabulars}{=\meta{preamble}}{style}
+ This style sets \refKey{/tcb/before upper} and \refKey{/tcb/after upper}
+ and several geometry keys to support a |tabular*| with the
+ given \meta{preamble}.
+ The packages |array| and |colortbl| have to be loaded separately.
+\begin{exdispExample}{tabulars_1}
+% \usepackage{array}
+% \usepackage{colortbl} - or - \usepackage[table]{xcolor}
+\tcbset{enhanced,fonttitle=\bfseries\large,fontupper=\normalsize\sffamily,
+ colback=yellow!10!white,colframe=red!50!black,colbacktitle=Salmon!30!white,
+ coltitle=black,center title}
+
+\begin{tcolorbox}[tabulars={@{\extracolsep{\fill}\hspace{5mm}}lrrrrr@{\hspace{5mm}}},
+ boxrule=0.5pt,title=My table]
+Group & One & Two & Three & Four & Sum\\\hline\hline
+Red & 1000.00 & 2000.00 & 3000.00 & 4000.00 & 10000.00\\\hline
+Green & 2000.00 & 3000.00 & 4000.00 & 5000.00 & 14000.00\\\hline
+Blue & 3000.00 & 4000.00 & 5000.00 & 6000.00 & 18000.00\\\hline\hline
+Sum & 6000.00 & 9000.00 & 12000.00 & 15000.00 & 42000.00
+\end{tcolorbox}
+\end{exdispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}[][doc new={2019-09-19}]{tabulars*}{=\marg{code}\marg{preamble}}{style}
+ This is a variant of \refKey{/tcb/tabulars} which adds some \meta{code}
+ before the table starts.
+\begin{exdispExample}{tabulars_2}
+% \usepackage{array}
+% \usepackage{colortbl} - or - \usepackage[table]{xcolor}
+\tcbset{enhanced,fonttitle=\bfseries\large,fontupper=\normalsize\sffamily,
+ colback=yellow!10!white,colframe=red!50!black,colbacktitle=Salmon!30!white,
+ coltitle=black,center title}
+
+\begin{tcolorbox}[tabulars*={\arrayrulewidth0.5mm\renewcommand\arraystretch{1.4}}%
+ {@{\extracolsep{\fill}\hspace{20mm}}lll@{\hspace{20mm}}},
+ title=My table]
+One & Two & Three \\\hline\hline
+1000.00 & 2000.00 & 3000.00\\\hline
+2000.00 & 3000.00 & 4000.00
+\end{tcolorbox}
+\end{exdispExample}
+\end{docTcbKey}
+
+
+
\clearpage
\begin{marker}
If \refKey{/tcb/tabularx} or \refKey{/tcb/tabularx*} are used, one cannot
@@ -2386,6 +2435,7 @@ One & Two & Three \\\hline\hline
\end{docTcbKey}
+
\clearpage
\begin{docTcbKey}{tikz upper}{\colOpt{=\meta{options}}}{style}
This style adds a centered |tikzpicture| environment to the start and end
@@ -3547,7 +3597,7 @@ If needed, the number of managed layers can be increased by setting
The following styles have a considerable influence on how layered boxes
are processed. Note especially that nested boxes are getting a
\refKey{/tcb/reset} by default. You can change this, but be prepared for
-suprises if you do.
+surprises if you do.
If the defaults are \emph{not changed}, a |tcolorbox| gets its options
in the following order. Following options overwrite preceding options.
@@ -4287,6 +4337,11 @@ do \emph{not} use |\tikzexternaldisable| in front of the |tcolorbox|.
\refKey{/tcb/shield externalize} is deactivated automatically inside a |tikzpicture|.
\end{marker}
+\begin{marker}
+\refKey{/tcb/shield externalize} is applied for every following |tcolorbox|
+inside the current \TeX\ group and is not affected by \refKey{/tcb/reset}.
+\end{marker}
+
\begin{docTcbKey}{external}{=\meta{file name}}{no default, initially unset}
Convenience option which calls |\tikzsetnextfilename|\marg{file name}. Typically,
it may be used inside the option list of a |tcolorbox| to set the
@@ -4310,7 +4365,8 @@ do \emph{not} use |\tikzexternaldisable| in front of the |tcolorbox|.
\begin{docTcbKey}{reset}{}{no value, initially set}
Sets (nearly) all |tcolorbox| settings (including loaded libraries) back to their default values
\emph{plus} any settings given by \refCom{tcbsetforeverylayer}.
-\refKey{/tcb/savedelimiter} and \refKey{/tcb/capture} keep their values.
+\refKey{/tcb/savedelimiter}, \refKey{/tcb/capture}, and
+\refKey{/tcb/shield externalize} keep their values.
Also, all raster values (see \Vref{sec:raster}) are not resetted.
This option is useful for boxes in boxes where the inner box should not inherit
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
index f8c1c4553cd..cda39d43fad 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
@@ -131,6 +131,36 @@ For |minted| \cite{poore:minted} support, load:
\end{docEnvironment}
+
+
+\begin{docEnvironment}[doclang/environment content=operation description,
+ doc new=2019-09-18]{docPathOperation}{\oarg{options}\marg{name}\marg{parameters}}
+ Documents a \tikzname\ path operation with given \meta{name}.
+ The given \meta{options} are set with \refCom{tcbset}.
+ This \tikzname\ path operation takes mandatory or optional \meta{parameters}.
+ It is automatically indexed and can be referenced with
+ \refCom{refPathOperation}\marg{name}.
+\begin{dispExample}
+\begin{docPathOperation}{fooop}{\oarg{opt}(\meta{name})\colOpt{at(\meta{coord})}}
+ Imaginary path operation for illustration.
+\end{docPathOperation}
+\end{dispExample}
+\end{docEnvironment}
+
+
+\begin{docEnvironment}[doclang/environment content=command description,
+ doc new=2019-09-17]{docPathOperation*}{\oarg{options}\marg{name}\marg{parameters}}
+ Identical to \refEnv{docPathOperation}, but without index entry.
+\end{docEnvironment}
+
+
+
+
+
+
+
+
+
\begin{docCommand}{docValue}{\marg{name}}
Documents a value with given \meta{name}. Typically, this is a value for a key.
This value is automatically indexed.
@@ -144,6 +174,7 @@ A feasible value for \refKey{/foo/footitle} is \docValue{foovalue}.
Identical to \refCom{docValue}, but without index entry.
\end{docCommand}
+\clearpage
\begin{docCommand}[doc updated=2014-10-09]{docAuxCommand}{\marg{name}}
Documents an auxiliary or minor \LaTeX\ macro with given \meta{name}
@@ -170,7 +201,7 @@ The environment \docAuxEnvironment{fooauxenv} holds some interesting data.
Identical to \refCom{docAuxEnvironment}, but without index entry.
\end{docCommand}
-\clearpage
+
\begin{docCommand}{docAuxKey}{\oarg{key path}\marg{name}}
Documents an auxiliary key with given \meta{name} and an optional \meta{key path}.
@@ -208,6 +239,7 @@ The length \docLength{foolength} can be used for computation.
Identical to \refCom{docLength}, but without index entry.
\end{docCommand}
+\clearpage
\begin{docCommand}{docColor}{\marg{name}}
Documents a color with given \meta{name}. The color is automatically indexed.
@@ -221,7 +253,7 @@ The color \docColor{foocolor} is available.
\end{docCommand}
-\clearpage
+
\begin{docCommand}{cs}{\marg{name}}
Macro from |ltxdoc| \cite{carlisle:2007a} to typeset a command word \meta{name}
where the backslash is prefixed. The library overwrites the original macro.
@@ -409,6 +441,24 @@ We have created \refKey*{/foo/footitle} as an example.
\end{docCommand}
+\begin{docCommand}[doc new=2019-09-17]{refPathOperation}{\marg{name}}
+ References a documented \tikzname\ path operation with given \meta{name}.
+ The page reference is suppressed if it links to the same page.
+\begin{dispExample}
+We have created \refPathOperation{fooop} as an example.
+\end{dispExample}
+\end{docCommand}
+
+\begin{docCommand}[doc new=2019-09-17]{refPathOperation*}{\marg{name}}
+ References a documented \tikzname\ path operation with given \meta{name}.
+ There is no page reference.
+\begin{dispExample}
+We have created \refPathOperation*{fooop} as an example.
+\end{dispExample}
+\end{docCommand}
+
+
+
\begin{docCommand}{refAux}{\marg{name}}
References some auxiliary environment, key, value, or color. The hyperlink color is
used, but there is no real link.
@@ -426,8 +476,8 @@ Some pages back, one can see \refAuxcs{fooaux} as an example.
\end{dispExample}
\end{docCommand}
+\clearpage
-%
\begin{docCommand}{colDef}{\marg{text}}
Sets \meta{text} with the command color, see \refKey{/tcb/color command}.
\begin{dispExample}
@@ -442,7 +492,14 @@ This is my \colOpt{text}.
\end{dispExample}
\end{docCommand}
-\clearpage
+
+\begin{docCommand}[doc new=2019-09-18]{colFade}{\marg{text}}
+ Sets \meta{text} with the fade color, see \refKey{/tcb/color fade}.
+\begin{dispExample}
+This is my \colFade{text}.
+\end{dispExample}
+\end{docCommand}
+
\begin{docCommand}[doc new=2014-09-19]{tcbdocmarginnote}{\oarg{options}\marg{text}}
Creates a |tcolorbox| note with the given \meta{text} inside the margin using
@@ -672,6 +729,10 @@ instead. Also see \refKey{/tcb/docexample}.
Sets the highlight color used by key definitions.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new={2019-09-18}]{color path}{=\meta{color}}{no default, initially |Definition|}
+ Sets the highlight color used by \tikzname\ path operation definitions.
+\end{docTcbKey}
+
\begin{docTcbKey}{color value}{=\meta{color}}{no default, initially |Definition|}
Sets the highlight color used by value definitions.
\end{docTcbKey}
@@ -688,9 +749,9 @@ instead. Also see \refKey{/tcb/docexample}.
Sets the highlight color used by color definitions.
\end{docTcbKey}
-\begin{docTcbKey}{color definition}{=\meta{color}}{no default, initially |Definition|}
+\begin{docTcbKey}[][doc updated={2019-09-18}]{color definition}{=\meta{color}}{no default, initially |Definition|}
Sets the highlight color for \refKey{/tcb/color command}, \refKey{/tcb/color environment},
- \refKey{/tcb/color key}, \refKey{/tcb/color value}, \refKey{/tcb/color counter},
+ \refKey{/tcb/color key}, \refKey{/tcb/color path}, \refKey{/tcb/color value}, \refKey{/tcb/color counter},
\refKey{/tcb/color length}, and \refKey{/tcb/color color}.
\end{docTcbKey}
@@ -698,6 +759,12 @@ instead. Also see \refKey{/tcb/docexample}.
Sets the color used for optional arguments.
\end{docTcbKey}
+\begin{docTcbKey}{color fade}{=\meta{color}}{no default, initially |Fade|}
+ Sets the color used for faded text like \colFade{\textbackslash path}
+ in \refEnv{docPathOperation}.
+\end{docTcbKey}
+
+
\begin{docTcbKey}{color hyperlink}{=\meta{color}}{no default, initially |Hyperlink|}
Sets the color for all hyper-links, i.\,e. all internal and external links.
\end{docTcbKey}
@@ -759,11 +826,18 @@ The English language is predefined.
Heading text in the index for lengths.
\end{langTcbKey}
-
\begin{langTcbKey}[][doc new={2014-09-19}]{new}{=\meta{text}}{no default, initially |New|}
Announcement text for new content.
\end{langTcbKey}
+\begin{langTcbKey}[][doc new={2019-09-18}]{path}{=\meta{text}}{no default, initially |path operation|}
+ Text used in the index for path operations.
+\end{langTcbKey}
+
+\begin{langTcbKey}[][doc new={2019-09-18}]{paths}{=\meta{text}}{no default, initially |Path operations|}
+ Heading text in the index for path operations.
+\end{langTcbKey}
+
\begin{langTcbKey}{pageshort}{=\meta{text}}{no default, initially |P.|}
Short text for page references.
\end{langTcbKey}
@@ -872,13 +946,27 @@ Options to these |tcolorbox|es can be given using the following keys.
\end{dispExample}
\end{docTcbKey}
-\begin{docTcbKey}{doc head}{=\meta{options}}{no default, initially empty}
+\clearpage
+\begin{docTcbKey}[][doc new=2019-09-18]{doc head path}{=\meta{options}}{no default, initially empty}
+ Sets \meta{options} for the head line of \refEnv{docPathOperation} and \refEnv{docPathOperation*}.
+\begin{dispExample}
+\tcbset{doc head command={interior style={fill,left color=red!7!white,
+ right color=blue!7!white}}}
+
+\begin{docPathOperation*}{-{}-}{\meta{coordinate or cycle}}
+ This is the documentation of \refPathOperation{-{}-}.
+\end{docPathOperation*}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}[][doc updated=2019-09-18]{doc head}{=\meta{options}}{no default, initially empty}
Shortcut for setting the same \meta{options} for
\refKey{/tcb/doc head command}, \refKey{/tcb/doc head environment},
- and \refKey{/tcb/doc head key}.
+ \refKey{/tcb/doc head key}, and \refKey{/tcb/doc head path}.
\end{docTcbKey}
-\clearpage
+
The description texts of the main documentation environments \refEnv{docCommand},
\refEnv{docEnvironment}, \refEnv{docKey}, etc, are set in a compact form without
indention and |parskip=0pt|. This settings can overruled by using the following
@@ -916,7 +1004,7 @@ keys to insert code before (or after) the description texts.
\end{dispExample}
\end{docTcbKey}
-
+\clearpage
\begin{docTcbKey}[][doc new=2015-10-09]{before doc body environment}{=\meta{code}}{no default, initially empty}
Executes \meta{code} before the description texts
of \refEnv{docEnvironment} and \refEnv{docEnvironment*}.
@@ -938,23 +1026,35 @@ keys to insert code before (or after) the description texts.
of \refEnv{docKey} and \refEnv{docKey*}.
\end{docTcbKey}
-\begin{docTcbKey}[][doc new=2015-10-09]{before doc body}{=\meta{options}}{no default, initially empty}
+\begin{docTcbKey}[][doc new=2019-09-18]{before doc body path}{=\meta{code}}{no default, initially empty}
+ Executes \meta{code} before the description texts
+ of \refEnv{docPathOperation} and \refEnv{docPathOperation*}.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2019-09-18]{after doc body path}{=\meta{code}}{no default, initially empty}
+ Executes \meta{code} after the description texts
+ of \refEnv{docPathOperation} and \refEnv{docPathOperation*}.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}[][doc new and updated={2015-10-09}{2019-09-18}]{before doc body}{=\meta{options}}{no default, initially empty}
Shortcut for setting the same \meta{options} for
\refKey{/tcb/before doc body command}, \refKey{/tcb/before doc body environment},
- and \refKey{/tcb/before doc body key}.
+ \refKey{/tcb/before doc body key}, and \refKey{/tcb/before doc body path}.
\end{docTcbKey}
-\begin{docTcbKey}[][doc new=2015-10-09]{after doc body}{=\meta{options}}{no default, initially empty}
+\begin{docTcbKey}[][doc new and updated={2015-10-09}{2019-09-18}]{after doc body}{=\meta{options}}{no default, initially empty}
Shortcut for setting the same \meta{options} for
\refKey{/tcb/after doc body command}, \refKey{/tcb/after doc body environment},
- and \refKey{/tcb/after doc body key}.
+ \refKey{/tcb/after doc body key}, and \refKey{/tcb/after doc body path}.
\end{docTcbKey}
-\clearpage
+%\clearpage
\begin{docTcbKey}{doc description}{=\meta{text}}{no default, initially empty}
Sets a (short!) additional description \meta{text} for
- \refEnv{docCommand} or \refEnv{docEnvironment}. Such a description is
+ \refEnv{docCommand}, \refEnv{docEnvironment}, or \refEnv{docPathOperation}.
+ Such a description is
mandatory for \refEnv{docKey}.
\begin{dispExample}
\begin{docCommand*}[doc description=my description]{myCommandF}{\marg{argument}}
@@ -968,6 +1068,19 @@ hand side if too long. Linebreaks can be used inside the \meta{text}.
\end{marker}
\end{docTcbKey}
+\clearpage
+\begin{docTcbKey}[][doc new={2019-09-18}]{doc label}{=\meta{text}}{no default, initially unset}
+ If used inside the option list of \refEnv{docCommand}, \refEnv{docEnvironment},
+ \refEnv{docKey}, or \refEnv{docPathOperation}, then \meta{text} is used
+ for labeling instead of the name of the definition.
+\begin{dispExample}
+\begin{docPathOperation*}[doc label=pathline]{-{}-}{\meta{coordinate or cycle}}
+ This is the documentation of \refPathOperation{pathline}.
+\end{docPathOperation*}
+\end{dispExample}
+\end{docTcbKey}
+
+
\begin{docTcbKey}{doc into index}{\colOpt{=true\textbar false}}{default |true|, initially |true|}
If set to |false|, no index entries are written for the main documentation
environments. The same effect is achieved by using e.\,g.\ \refEnv{docCommand*}
@@ -1008,7 +1121,7 @@ Some command for something.
\end{docTcbKey}
-\subsection{Predefined Colors of the Library}
+\subsection{Predefined Colors of the Library}\tcbdocmarginnote{\tcbdocupdated{2019-09-18}}
The following colors are predefined. They are used as default colors
in some library commands.
@@ -1018,6 +1131,7 @@ in some library commands.
\dispColor{Definition},
\dispColor{ExampleFrame},
\dispColor{ExampleBack},
-\dispColor{Hyperlink}.
+\dispColor{Hyperlink},
+\dispColor{Fade}.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex
index b5e37eee984..33782234fe8 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex
@@ -475,8 +475,8 @@ There are no |app| type keys since finishes are stackable by default.
\subsection{Skin Code}
-The following option keys extend the options given in Subsection \ref{subsec:addcodeoptions}
-from page \pageref{subsec:addcodeoptions}.
+The following option keys extend the options given in Subsection~\ref{subsec:addcodeoptions}
+from page~\pageref{subsec:addcodeoptions}.
\begin{docTcbKey}{frame code app}{=\meta{graphical code}}{no default}
Appends the given \meta{graphical code} to \refKey{/tcb/frame code}.
@@ -575,3 +575,27 @@ There are no |app| type keys since extras are stackable by default.
Prepends the given \meta{options} to \refKey{/tcb/extras first and middle}.
\end{docTcbKey}
+
+\subsection{Listings}
+The following option keys extend the options given in
+Section~\ref{sec:listings}
+from page~\pageref{sec:listings}.
+
+
+\begin{docTcbKey}[][doc new=2019-07-11]{listing options app}{=\marg{options}}{no default}
+ Appends the given \meta{options} to \refKey{/tcb/listing options}.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2019-07-11]{listing options pre}{=\marg{options}}{no default}
+ Prepends the given \meta{options} to \refKey{/tcb/listing options}.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2019-07-11]{minted options app}{=\marg{options}}{no default}
+ Appends the given \meta{options} to \refKey{/tcb/minted options}.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2019-07-11]{minted options pre}{=\marg{options}}{no default}
+ Prepends the given \meta{options} to \refKey{/tcb/minted options}.
+\end{docTcbKey}
+
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex
index 75c016fb91c..84510ab7540 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex
@@ -15,6 +15,17 @@ in \Vref{sec:recording-solutions}.
Opens a file denoted by \meta{file name} for writing the records.
The default file name is |\jobname.records|.
See \Vref{sec:recording-exercises} for an example application.
+ \begin{marker}
+ In some situations, a not existing optional parameter may cause parsing
+ problems. If this happens (or just for precaution), use
+\begin{dispListing}
+\tcbstartrecording\relax
+\end{dispListing}
+ or
+\begin{dispListing}
+\tcbstartrecording[\jobname.records]
+\end{dispListing}
+ \end{marker}
\end{docCommand}
\begin{docCommand}[doc new=2014-11-28]{tcbrecord}{\marg{content}}
@@ -66,7 +77,7 @@ has no solution. Finally, the solutions are input in \Vref{sec:recording-solutio
\inputpreamblelisting{L}
\begin{dispListing*}{breakable,before upper=}
-\tcbstartrecording
+\tcbstartrecording\relax
\begin{exercise}
Compute the derivative of the following function:
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
index 9a48d42bb6c..18385877c0c 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty
@@ -54,6 +54,7 @@
\tcbset{skin=enhanced,
doc head={colback=yellow!10!white,interior style=fill},
doc head key={colback=magenta!5!white,interior style=fill},
+ doc head path={colback=blue!50!gray!7!white,interior style=fill},
color key=DarkViolet,
color value=Teal,
color color=Teal,
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
index e357d5b78c6..8c18743cecb 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -596,7 +596,7 @@ The boxed title is shifted by \meta{length} in the vertical direction.
\end{boxTcbKey}
\begin{boxTcbKey}{yshifttext}{=\meta{length}}{no default, initially |0pt|}
-The text inside the main box by \meta{length} to give room for e.\,g.\ a sunken title.
+The text inside the main box is shifted by \meta{length} to give room for e.\,g.\ a sunken title.
\begin{exdispExample*}{yshifttext}{sbs,lefthand ratio=0.66}
\begin{tcolorbox}[enhanced,title=My title,
attach boxed title to top center=
@@ -1303,7 +1303,7 @@ Defines a |Tikz| scope which clips to the frame area path.
\begin{docEnvironment}{tcbinvclipframe}{}
Defines a |Tikz| scope which clips to the \emph{outside} of the frame area path.
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\tcbset{enhanced jigsaw,fonttitle=\bfseries,opacityback=0.35,colback=blue!5!white,
frame style={left color=red!75!black,right color=red!10!yellow}}
@@ -2245,7 +2245,7 @@ but most other skins, e.\,g.\ \refSkin{enhanced}.
applied a second time, the new \meta{tikz option list} is appended to the
current option list.
\begin{dispExample*}{sbs,lefthand ratio=0.66,
- segmentation style={pattern=checkerboard light gray}}
+ segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\tcbset{enhanced,colback=red!5!white,
colframe=red!75!black,fonttitle=\bfseries}
@@ -2837,7 +2837,7 @@ and \refSkin{enhanced}, there are variants called \refSkin{standard jigsaw}
and \refSkin{enhanced jigsaw}.
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\newcommand{\ballexample}{\begin{tikzpicture}
\path[use as bounding box] (0,0.8) rectangle +(0.1,0.1);
\shadedraw [shading=ball] (0,0) circle (1cm);
@@ -2863,7 +2863,7 @@ and \refSkin{enhanced jigsaw}.
\end{dispExample*}
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\tcbset{enhanced,colback=red!10!white,coltitle=black,
frame style={left color=red!75!black,right color=red!10!yellow},
fonttitle=\bfseries,interior hidden,title hidden}
@@ -2879,7 +2879,7 @@ and \refSkin{enhanced jigsaw}.
\end{dispExample*}
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\newtcolorbox{mybox}{skin=enhancedmiddle jigsaw,leftrule=5mm,rightrule=5mm,
boxsep=0mm,top=0mm,bottom=0mm,
frame style={top color=blue,bottom color=red},interior hidden}
@@ -3047,7 +3047,7 @@ This box looks like a box provided by the \texttt{beamer} class.
This is an abbreviation for setting |skin=standard jigsaw|.
\end{docTcbKey}
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcbraster}[standard jigsaw,raster equal height,raster columns=4,
colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen,
opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
@@ -3366,7 +3366,7 @@ Nevertheless, this skin can be applied independently.
This is an abbreviation for setting |skin=enhanced jigsaw|.
\end{docTcbKey}
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcbraster}[enhanced jigsaw,raster equal height,raster columns=4,
colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen,
opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
@@ -3416,7 +3416,7 @@ Nevertheless, this skin can be applied independently.
\end{docSkin}
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcbraster}[skin=enhancedfirst jigsaw,raster equal height,raster columns=4,
colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen,
opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
@@ -3459,7 +3459,7 @@ Nevertheless, this skin can be applied independently.
\end{docSkin}
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcbraster}[skin=enhancedmiddle jigsaw,raster equal height,raster columns=4,
colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen,
opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
@@ -3557,7 +3557,7 @@ Nevertheless, this skin can be applied independently.
\end{docSkin}
-\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}}
+\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}}
\begin{tcbraster}[skin=enhancedlast jigsaw,raster equal height,raster columns=4,
colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen,
opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5,
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index e1e37bfe2cc..4c995dd99f4 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex
index 69d5d409922..8399ca7681b 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.20 (2019/03/02)
+%% The LaTeX package tcolorbox - version 4.21 (2019/09/19)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -43,8 +43,8 @@
\setlength{\bibitemsep}{\smallskipamount}
\addbibresource{tcolorbox.doc.bib}
-\def\version{4.20}%
-\def\datum{2019/03/02}%
+\def\version{4.21}%
+\def\datum{2019/09/19}%
\makeindex
\hypersetup{
@@ -58,11 +58,11 @@
%\tcbset{draftmode}
\tcbset{/tcb/external/-}% for final run
-%\includeonly{tcolorbox.doc.skins}
+%\includeonly{tcolorbox.doc.coreoptions}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}
-\include{tcolorbox.doc.abstract}
+\input{tcolorbox.doc.abstract}
\include{tcolorbox.doc.intro}
\include{tcolorbox.doc.quickref}
\include{tcolorbox.doc.coremacros}