summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-09-22 22:17:46 +0000
committerKarl Berry <karl@freefriends.org>2014-09-22 22:17:46 +0000
commitd618f80f8f62c896392904e75aefd221af6fa9e6 (patch)
tree28777aa698936b11b02d58431345e41e0d3c6655 /Master/texmf-dist/doc/latex/tcolorbox
parent942f0cacc577ae897adcaf7f1705b0a864223002 (diff)
tcolorbox (22sep14)
git-svn-id: svn://tug.org/texlive/trunk@35232 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES28
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin361348 -> 361353 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex4
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex1
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex69
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex106
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex38
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex14
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex50
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex15
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin4415072 -> 4488553 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex19
15 files changed, 315 insertions, 35 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 6acd6031241..192b17cc6d2 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 3.12 (2014/07/29)
+%% The LaTeX package tcolorbox - version 3.20 (2014/09/22)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -566,7 +566,7 @@ version 3.10 (2014/07/23)
for all types of boxes, skins, borders, and shadows:
* new options: 'sharpish corners', 'sharp corners', and 'rounded corners'
- library 'skins':
- * new options: '\tcbline*'
+ * new macros: '\tcbline*'
* bug fix: skin families 'bicolor' and 'beamer' did not respect 'colbacktitle'
- pictures 'blueshade.png', 'crinklepaper.png', 'goldshade.png', 'pink_marble.png'
moved to package folder
@@ -583,3 +583,27 @@ version 3.12 (2014/07/29)
- library 'breakable':
* new option: 'vfill before first'
+version 3.20 (2014/09/22)
+- bug fix: titles set with 'detach' or 'boxed title' options were not considered
+ for lists of tcolorboxes.
+- bug fix: 'extrude left by', 'extrude right by' worked only for '\tcbox' but not for 'tcolorbox'
+- bug fix: 'pad before break*' and 'pad at break*' were always setting to 0pt
+- new options: 'every float', 'list text', 'overlay first and middle',
+ 'height fill'
+- new initialization options:
+ 'use counter*', 'blend into'
+- library 'skins':
+ * new macros: '\tcbsettowidthofnode', '\tcbsetmacrotowidthofnode',
+ '\tcbsettoheightofnode', '\tcbsetmacrotoheightofnode'
+ * new options: 'underlay first and middle', 'finish first and middle'
+- library 'hooks':
+ * new options: 'underlay first and middle pre',
+ 'overlay first and middle app', 'overlay first and middle pre',
+ 'finish first and middle pre'
+- library 'documentation':
+ * new macros: '\tcbdocmarginnote', '\tcbdocnew', '\tcbdocupdated'
+ * The 'docKey' and 'docKey*' environments take tcolorbox options now
+ * new options:
+ 'doclang/new', 'doclang/updated',
+ 'doc marginnote', 'doc updated', 'doc new', 'doc new and updated'
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index aa3167bb975..06bb2a4f501 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 3.12 (2014/07/29)
+%% The LaTeX package tcolorbox - version 3.20 (2014/09/22)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2014 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.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
index 3f6068330cd..0902b99e687 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 1a3fc077aca..082cc44e086 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 3.12 (2014/07/29)
+%% The LaTeX package tcolorbox - version 3.20 (2014/09/22)
%% tcolorbox-example.tex: an example for tcolorbox
%%
%% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
index b447e3530fb..d355b85d922 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
@@ -67,7 +67,8 @@ cover page. Printing the pages starting with page 2 or page 3 should work.
colback=yellow!10!white,colframe=red!50!black,before=\par\bigskip\noindent,
interior style={fill overzoom image=goldshade.png,fill image opacity=0.25},
colbacktitle=red!50!yellow!75!black,
- watermark color=yellow!75!red!25!white,pad at break=3mm,
+ enlargepage flexible=\baselineskip,pad at break*=3mm,
+ watermark color=yellow!75!red!25!white,
watermark text={\bfseries\Large Contents},
attach boxed title to top center={yshift=-0.25mm-\tcboxedtitleheight/2,yshifttext=2mm-\tcboxedtitleheight/2},
boxed title style={enhanced,boxrule=0.5mm,
@@ -78,7 +79,6 @@ cover page. Printing the pages starting with page 2 or page 3 should work.
-- (interior.north west) -- (interior.north east)
-- ([xshift=2mm]interior.east) -- (interior.south east) -- (interior.south west)
-- cycle;} },
- %enlargepage=2\baselineskip,
drop fuzzy shadow]
\makeatletter
\@starttoc{toc}
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 91dbc9a5c76..894db46d014 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
@@ -370,6 +370,7 @@ and \refKey{/tcb/enlarge bottom at break by}.
\begin{marker}
If the box keeps unbroken, this option is not applied.
See \refKey{/tcb/height} for setting a fixed height for unbroken boxes.
+ See \refKey{/tcb/height fill} for giving unbroken boxes maximum height.
\end{marker}
\end{docTcbKey}
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 03569b2014d..3c350f3b655 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -1122,9 +1122,32 @@ This is a tcolorbox. This is a tcolorbox. This is a tcolorbox.
\end{dispExample}
\end{docTcbKey}
+\clearpage
+\begin{docTcbKey}[][doc new=2014-09-22]{height fill}{\colOpt{=true\textbar false}}{default |true|, initially |false|}
+If set to |true|, the height of the |tcolorbox| is set to the rest of the
+available vertical space of the current page. Note that the |tcolorbox|
+is always set as its own paragraph using this option.
+This option overrules \refKey{/tcb/natural height}, \refKey{/tcb/height}, etc.
+\begin{marker}
+Note that the library \mylib{breakable} has to be loaded to use this key!
+\end{marker}
+This height control key is only applicable to unbreakable boxes but it
+uses code from the library \mylib{breakable}.
+The counterpart for breakable boxes is \refKey{/tcb/height fixed for}.
+\begin{dispListing}
+% \usepackage{lipsum}
+% \tcbuselibrary{breakable}
+\begin{tcolorbox}[height fill,
+ colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
+ title=Box which fills the rest of the page]
+\lipsum[1]
+\end{tcolorbox}
+\end{dispListing}
+\end{docTcbKey}
+{\tcbusetemp}
-\clearpage
+%\clearpage
\begin{docTcbKey}{space}{=\meta{fraction}}{no default, initially 0}
If the height of a |tcolorbox| is not the natural height, the space
difference between the forced and the natural size is distributed
@@ -1794,6 +1817,13 @@ This is the lower part.
\refKey{/tcb/overlay} overwrites this key.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{overlay first and middle}{=\meta{graphical code}}{no default, initially unset}
+ This is an optimized abbreviation for setting
+ \refKey{/tcb/overlay first} and
+ \refKey{/tcb/overlay middle} together.
+ \refKey{/tcb/overlay} overwrites this key.
+\end{docTcbKey}
+
\begin{dispListing*}{breakable,before upper={This example demonstrates
the application of break sequence specific overlay options.
@@ -1812,7 +1842,6 @@ are drawn by the codes given with
%\tcbuselibrary{skins,breakable}
%\newcounter{example}
\colorlet{colexam}{red!75!black}
-
\newtcolorbox[use counter=example]{myexample}{%
empty,title={Example \thetcbcounter},attach boxed title to top left,
boxed title style={empty,size=minimal,toprule=2pt,top=4pt,
@@ -1922,6 +1951,24 @@ are drawn by the codes given with
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{every float}{=\meta{code}}{no default, initially empty}
+ For floating objects, the \refKey{/tcb/before} and \refKey{/tcb/after}
+ settings are ignored. Instead, the given \meta{code} is inserted before
+ a floating box. If the box is \refKey{/tcb/breakable}, the given \meta{code} is
+ inserted before every part of the break sequence.
+ The most common use case is |every float=\centering|.
+
+\begin{dispListing}
+\tcbox[float=htb,title={Floating box},every float=\centering,
+ colback=blue!50!black,colframe=blue!50!white,colbacktitle=blue!10!white,
+ coltitle=black,center title]
+ {\includegraphics[height=6cm]{lichtspiel.jpg}}
+\end{dispListing}
+{\tcbset{reset}\tcbusetemp}
+
+\end{docTcbKey}
+
+
\clearpage
\subsection{Side by Side}\label{subsec:sidebyside}
\begin{marker}
@@ -2363,7 +2410,7 @@ Lorem \tcbox{ipsum} dolor sit amet, consectetuer adipiscing elit.
\end{dispExample}
\end{docTcbKey}
-\begin{docTcbKey}{extrude left by}{=\meta{length}}{style, no default, initially unset}
+\begin{docTcbKey}[][doc updated=2014-09-19]{extrude left by}{=\meta{length}}{style, no default, initially unset}
The (upper part of the) colored box is extruded by the given \meta{length} to the left side.
The inner width and the bounding box is kept unchanged and the operation
is additiv!
@@ -2379,7 +2426,7 @@ Nam arcu libero, nonummy eget, consectetuer id, vulputate a, magna.
\end{dispExample}
\end{docTcbKey}
-\begin{docTcbKey}{extrude right by}{=\meta{length}}{style, no default, initially unset}
+\begin{docTcbKey}[][doc updated=2014-09-19]{extrude right by}{=\meta{length}}{style, no default, initially unset}
The (upper part of the) colored box is extruded by the given \meta{length} to the right side.
The inner width and the bounding box is kept unchanged and the operation
is additiv!
@@ -2748,7 +2795,7 @@ Test\dotfill
%page \pageref{sec:skincorekeys}.
\clearpage
-\subsection{Counters, Labels and References}
+\subsection{Counters, Labels, and References}
\begin{docTcbKey}{phantom}{=\meta{code}}{no default, initially unset}
The \meta{code} is put in a box at the upper left corner of the |tcolorbox|.
@@ -2826,6 +2873,18 @@ See Section \ref{listing:exercises} from page \pageref{listing:exercises}
for a complete example.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{list text}{=\meta{text}}{style, no default}
+This is a shortcut for setting \refKey{/tcb/list entry} to\\
+|\protect\numberline{\thetcbcounter}|\meta{text}.
+So, the following settings are identical:
+\begin{dispListing}
+list text={My beautiful Example},
+list entry={\protect\numberline{\thetcbcounter}My beautiful Example}
+\end{dispListing}
+See Section \ref{listing:exercises} from page \pageref{listing:exercises}
+for a complete example.
+\end{docTcbKey}
+
\begin{docTcbKey}{add to list}{=\marg{list}\marg{type}}{no default, initially unset}
If the \flqq list of tcolorbox(es)\frqq\ feature described in Subsection
\ref{sec:listsof} from page \pageref{sec:listsof} is used, list entries are
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 b1fe8a9d02d..52fce65f388 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
@@ -14,8 +14,9 @@ The library is loaded by a package option or inside the preamble by:
\end{dispListing}
This also loads the library \mylib{listings}, see \Vref{sec:listings},
the library \mylib{skins}, see \Vref{sec:skins},
+the library \mylib{xparse}\tcbdocmarginnote{\tcbdocnew{2014-09-19}}, see \Vref{sec:xparse},
and a bunch of packages, namely
-|doc|, |pifont|, |marvosym|, |makeidx|, |refcount|, and |hyperref|.
+|doc|, |pifont|, |marvosym|, |makeidx|, |marginnote|, |refcount|, and |hyperref|.
\begin{marker}
The package |makeidx| is loaded only, if \docAuxCommand*{printindex} is
@@ -96,8 +97,9 @@ For |minted| \cite{rudolph:2011a} support, load:
\end{xdocEnvironment}}
-\begin{docEnvironment}[doclang/environment content=key description]{docKey}{\oarg{key path}\marg{name}\marg{parameters}\marg{description}}
+\begin{docEnvironment}[doclang/environment content=key description,doc updated=2014-09-19]{docKey}{\oarg{key path}\oarg{options}\marg{name}\marg{parameters}\marg{description}}
Documents a key with given \meta{name} and an optional \meta{key path}.
+ The given \meta{options} are set with \refCom{tcbset}.
This key takes mandatory or optional \meta{parameters} as value
with a short \meta{description}.
It is automatically indexed and can be referenced with
@@ -110,7 +112,7 @@ For |minted| \cite{rudolph:2011a} support, load:
\end{docEnvironment}
-\begin{docEnvironment}[doclang/environment content=key description]{docKey*}{\oarg{key path}\marg{name}\marg{parameters}\marg{description}}
+\begin{docEnvironment}[doclang/environment content=key description,doc updated=2014-09-19]{docKey*}{\oarg{key path}\oarg{options}\marg{name}\marg{parameters}\marg{description}}
Identical to \refEnv{docKey}, but without index entry.
\end{docEnvironment}
@@ -402,6 +404,43 @@ This is my \colOpt{text}.
\end{dispExample}
\end{docCommand}
+\clearpage
+
+\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
+ the |marginnote| package. The style of the |tcolorbox| is predefined and can be
+ altered by \refKey{/tcb/doc marginnote} and the given \meta{options}.
+\begin{dispExample}
+Some text\tcbdocmarginnote{Note A}
+which is commented by a note inside the margin.
+Alternatively to |\tcbdocmarginnote|, you can always use
+|\marginnote| with a |tcolorbox| directly.\par
+This is further text%
+\tcbdocmarginnote[colframe=blue!50!white,colback=blue!5!white]{Note B}
+with another note.
+\end{dispExample}
+\end{docCommand}
+
+\begin{docCommand}[doc new=2014-09-19]{tcbdocnew}{\marg{date}}
+ Auxiliary macro which typesets the \refKey{/tcb/doclang/new} text with
+ the given \meta{date}. It may be redefined for customization.
+ \makeatletter\renewcommand*{\tcbdocnew}[1]{\kvtcb@text@new: #1}\makeatother%
+\begin{dispExample*}{sidebyside}
+\tcbdocnew{1981-10-29}.
+% Next one is displayed in the margin:
+\tcbdocmarginnote{\tcbdocnew{1978-02-09}}
+\end{dispExample*}
+\end{docCommand}
+
+\begin{docCommand}[doc new=2014-09-19]{tcbdocupdated}{\marg{date}}
+ Auxiliary macro which typesets the \refKey{/tcb/doclang/updated} text with
+ the given \meta{date}. It may be redefined for customization.
+ \makeatletter\renewcommand*{\tcbdocupdated}[1]{\kvtcb@text@updated: #1}\makeatother%
+\begin{dispExample*}{sidebyside}
+\tcbdocupdated{2014-09-19}.
+\end{dispExample*}
+\end{docCommand}
+
\clearpage
\subsection{Option Keys of the Library}
@@ -561,9 +600,6 @@ The English language is predefined.
Heading text in the index for colors.
\end{langTcbKey}
-\begin{langTcbKey}{environment content}{=\meta{text}}{no default, initially |environment content|}
- Text used in \refEnv{docEnvironment}.
-\end{langTcbKey}
\begin{langTcbKey}{environment}{=\meta{text}}{no default, initially |environment|}
Text used in the index for environments.
@@ -573,6 +609,10 @@ The English language is predefined.
Heading text in the index for environments.
\end{langTcbKey}
+\begin{langTcbKey}{environment content}{=\meta{text}}{no default, initially |environment content|}
+ Text used in \refEnv{docEnvironment}.
+\end{langTcbKey}
+
\begin{langTcbKey}{key}{=\meta{text}}{no default, initially |key|}
Text used in the index for keys.
\end{langTcbKey}
@@ -581,6 +621,22 @@ The English language is predefined.
Heading text used in the index for keys.
\end{langTcbKey}
+\begin{langTcbKey}{index}{=\meta{text}}{no default, initially |Index|}
+ Heading text for the index.
+\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}{pageshort}{=\meta{text}}{no default, initially |P.|}
+ Short text for page references.
+\end{langTcbKey}
+
+\begin{langTcbKey}[][doc new={2014-09-19}]{updated}{=\meta{text}}{no default, initially |Updated|}
+ Announcement text for updated content.
+\end{langTcbKey}
+
\begin{langTcbKey}{value}{=\meta{text}}{no default, initially |value|}
Text used in the index for values.
\end{langTcbKey}
@@ -589,13 +645,7 @@ The English language is predefined.
Heading text in the index for values.
\end{langTcbKey}
-\begin{langTcbKey}{index}{=\meta{text}}{no default, initially |Index|}
- Heading text for the index.
-\end{langTcbKey}
-\begin{langTcbKey}{pageshort}{=\meta{text}}{no default, initially |P.|}
- Short text for page references.
-\end{langTcbKey}
\clearpage
\begin{docTcbKey}{doc left}{=\meta{length}}{no default, initially |2em|}
@@ -716,6 +766,38 @@ hand side if too long. Linebreaks can be used inside the \meta{text}.
instead of \refEnv{docCommand}.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{doc marginnote}{=\meta{options}}{no default, initially empty}
+ Sets style \meta{options} for the displayed box of the \refCom{tcbdocmarginnote} command.
+\begin{dispExample}
+\tcbset{doc marginnote={colframe=blue!50!white,colback=blue!5!white}}%
+This is some text\tcbdocmarginnote{Note A}
+which is commented by a note inside the margin.
+\end{dispExample}
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2014-09-19]{doc new}{=\meta{date}}{style, no default}
+ Adds a a marginnote with a 'New: \meta{data}' message at the beginning of
+ the upper box part. The intended use is inside the option list of
+ \refEnv{docCommand}, \refEnv{docEnvironment}, etc.
+ \makeatletter\renewcommand*{\tcbdocnew}[1]{\kvtcb@text@new: #1}\makeatother%
+\begin{dispExample}
+\begin{docCommand}[doc new=2000-01-01]{foosomething}{\marg{text}}
+Some command for something.
+\end{docCommand}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}[][doc new=2014-09-19]{doc updated}{=\meta{date}}{style, no default}
+ Adds a marginnote with a 'Updated: \meta{data}' message at the beginning of
+ the upper box part. See \refKey{/tcb/doc new}.
+\end{docTcbKey}
+
+
+\begin{docTcbKey}[][doc new=2014-09-19]{doc new and updated}{=\marg{new date}\marg{update date}}{style, no default}
+ Adds a marginnote with 'New: \meta{new date}' and 'Updated: \meta{update data}' messages at the beginning of
+ the upper box part. See \refKey{/tcb/doc new}.
+\end{docTcbKey}
\subsection{Predefined Colors of the Library}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex
index ced3f0ffd01..89e159eba81 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.filling.tex
@@ -1,7 +1,7 @@
% !TeX root = tcolorbox.tex
% include file of tcolorbox.tex (manual of the LaTeX package tcolorbox)
\clearpage
-\section{\tikzname\ Image and Picture Fill Extensions}\label{sec:tikzimagefilling}
+\section{\tikzname\ Image and Picture Fill Extensions; Auxiliary Macros}\label{sec:tikzimagefilling}
The \mylib{skins} library adds some image and picture fill options to the vast option set of
\tikzname\ \cite{tantau:2013a}. These options can be used in any |tikzpicture|.
For the following options, the \mylib{skins} library has to be loaded
@@ -413,3 +413,39 @@ See \Vref{sec:skins} for the documentation of all other options of the \mylib{sk
\end{tikzpicture}
\end{dispExample*}
+
+\clearpage
+\subsection{Extracting Node Dimensions}
+The following auxiliary macros are defined by the \mylib{skins} library.
+They allow to determine the width and height of an arbitrary \tikzname\ node.
+To be more specific, they determine the east-to-west and the north-to-south dimensions
+which may be not the maximal dimensions for a non-rectangular node.
+
+\begin{docCommand}[doc new=2014-09-19]{tcbsettowidthofnode}{\marg{register}\marg{node}}
+ Sets the east-to-west dimension of the given \meta{node}
+ to the \TeX\ \meta{register}.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2014-09-19]{tcbsetmacrotowidthofnode}{\marg{macro}\marg{node}}
+ Defines \meta{macro} as the east-to-west dimension of the given \meta{node}.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2014-09-19]{tcbsettoheightofnode}{\marg{register}\marg{node}}
+ Sets the north-to-south dimension of the given \meta{node}
+ to the \TeX\ \meta{register}.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2014-09-19]{tcbsetmacrotoheightofnode}{\marg{macro}\marg{node}}
+ Defines \meta{macro} as the north-to-south dimension of the given \meta{node}.
+\end{docCommand}
+
+\begin{dispExample}
+\begin{tikzpicture}
+ \node[align=center,draw=red,fill=yellow] (A) {This is my\\example node};
+ \tcbsetmacrotowidthofnode\mywidth{A}
+ \tcbsetmacrotoheightofnode\myheight{A}
+ \path[draw=blue,fill=blue!25!white] ([xshift=2mm]A.south east)
+ rectangle node{Copy} +(\mywidth,\myheight);
+\end{tikzpicture}
+\end{dispExample}
+
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 88d2ba4385d..8dbd52789e2 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex
@@ -275,6 +275,14 @@ Here, we apply a second overlay.
Prepends the given \meta{graphical code} to \refKey{/tcb/overlay unbroken and last}.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{overlay first and middle app}{=\meta{graphical code}}{no default}
+ Appends the given \meta{graphical code} to \refKey{/tcb/overlay first and middle}.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2014-09-19]{overlay first and middle pre}{=\meta{graphical code}}{no default}
+ Prepends the given \meta{graphical code} to \refKey{/tcb/overlay first and middle}.
+\end{docTcbKey}
+
\clearpage
\subsection{Watermarks}
@@ -414,6 +422,9 @@ There are no |app| type keys since underlays are stackable by default.
Prepends the given \meta{graphical code} to \refKey{/tcb/underlay unbroken and last}.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{underlay first and middle pre}{=\meta{graphical code}}{no default}
+ Prepends the given \meta{graphical code} to \refKey{/tcb/underlay first and middle}.
+\end{docTcbKey}
\clearpage
@@ -458,6 +469,9 @@ There are no |app| type keys since finishes are stackable by default.
Prepends the given \meta{graphical code} to \refKey{/tcb/finish unbroken and last}.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{finish first and middle pre}{=\meta{graphical code}}{no default}
+ Prepends the given \meta{graphical code} to \refKey{/tcb/finish first and middle}.
+\end{docTcbKey}
\subsection{Skin Code}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex
index c38f60f8d2c..ab92c631692 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.initoptions.tex
@@ -50,7 +50,7 @@ The real counter name is \texttt{\tcbcounter}.
\clearpage
\begin{newTcbKey}{use counter from}{=\meta{tcolorbox}}{no default, initially unset}
Here, a counter from another \meta{tcolorbox} is reused.
-Note that the setting for \refKey{/tcb/new/number format} and
+Note that the settings for \refKey{/tcb/new/number format} and
\refKey{/tcb/new/number within} are inherited and cannot be changed.
The counter value is referenced by \docAuxCommand{thetcbcounter}.
@@ -70,7 +70,7 @@ The real counter name is \texttt{\tcbcounter}.
\begin{newTcbKey}{use counter}{=\meta{counter}}{no default, initially unset}
-Here, an ordinary existing \LaTeX\ counter is used for numbering.
+Here, an ordinary existing \LaTeX\ \meta{counter} is used for numbering.
With \refKey{/tcb/new/number format} and
\refKey{/tcb/new/number within}, the appearance and behavior of the counter
can be changed. The counter value is referenced by \docAuxCommand{thetcbcounter}.
@@ -91,6 +91,15 @@ The real counter name is \texttt{\tcbcounter}.
\end{newTcbKey}
+\begin{newTcbKey}[][doc new=2014-09-19]{use counter*}{=\meta{counter}}{no default, initially unset}
+An existing \LaTeX\ \meta{counter} is used for numbering. In contrast to
+\refKey{/tcb/new/use counter}, the options \refKey{/tcb/new/number format} and
+\refKey{/tcb/new/number within} are ignored. Use this for counters which
+are already configured outside the |tcolorbox| package, e.\,g.\ the standard
+|figure| counter.
+\end{newTcbKey}
+
+
\begin{newTcbKey}{no counter}{}{no value, initially set}
The created boxes are not numbered. This is the default. The option may
be used to overrule a previous option.
@@ -182,9 +191,46 @@ With \texttt{varioref}:\\
\Vref*{myreference}, \vref*{myreference}.
\end{dispExample}
+\clearpage
+\begin{newTcbKey}[][doc new=2014-09-19]{blend into}{=\meta{name}}{style, no default, initially unset}
+Used to comfortably blend into an existing schema of naming and numbering for
+some selected cases. For example, a |tcolorbox| can be used to display
+and entitle an image pretending to be a standard |figure| environment.
+Here, \refKey{/tcb/title} is used instead of the standard |\caption|
+and \refKey{/tcb/list text} can be used instead of the optional parameter
+of the standard |\caption|.
+Feasible values for \meta{name} are:
+\begin{itemize}
+\item\docValue{figures}: blend into the standard |figure| environment.
+\item\docValue{tables}: blend into the standard |table| environment.
+\item\docValue{listings}: blend into the standard |lstlistings| environment
+ of the package |listings| \cite{heinz:2013a}.
+ \begin{marker}
+ Note that |blend into=listings| can only be used in the document content
+ or, preferably, inside a |\AtBeginDocument| clause! Using it without
+ |\AtBeginDocument| inside the preamble does not work since the |listings|
+ packages initializes its counter also inside |\AtBeginDocument|.
+ \end{marker}
+\end{itemize}
+\end{newTcbKey}
+
+\enlargethispage*{5cm}
+\begin{dispListing}
+\begin{figure}[htb]
+ \centering\includegraphics[height=4cm]{lichtspiel.jpg}
+ \caption{A standard figure}
+\end{figure}
+\newtcolorbox[blend into=figures]{myfigure}[2][]{float=htb,capture=hbox,
+ title={#2},every float=\centering,#1}
+
+\begin{myfigure}{A tcolorbox figure}
+ \includegraphics[height=4cm]{lichtspiel.jpg}
+\end{myfigure}
+\end{dispListing}
+{\tcbusetemp}
\clearpage
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 e3eaa60fd02..e2e319848c3 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -823,6 +823,7 @@ But a mixture is possible with the \mylib{hooks} library, see Section \ref{sec:h
\end{dispExample}
\end{docTcbKey}
+\enlargethispage*{1cm}
\begin{docTcbKey}{watermark text on}{=\meta{part} is \meta{text}}{no default, initially unset}
This option writes some \meta{text} in the center of the interior region of a |tcolorbox|
@@ -838,6 +839,7 @@ But a mixture is possible with the \mylib{hooks} library, see Section \ref{sec:h
\item\docValue{last}: last parts of a break sequence,
\item\docValue{unbroken and first}: unbroken boxes and first parts of a break sequence,
\item\docValue{middle and last}: middle and last parts of a break sequence.
+ \item\docValue{first and middle}: first and middle parts of a break sequence.
\end{itemize}
\end{docTcbKey}
@@ -2125,6 +2127,12 @@ The differences between underlays and overlays are:
\refKey{/tcb/underlay} overwrites this key.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{underlay first and middle}{=\meta{graphical code}}{no default, initially unset}
+ This is an abbreviation for setting
+ \refKey{/tcb/underlay first} and
+ \refKey{/tcb/underlay middle} together.
+ \refKey{/tcb/underlay} overwrites this key.
+\end{docTcbKey}
\clearpage
@@ -2261,6 +2269,13 @@ Finishes are intended for special effects like highlights or glosses or text ove
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-09-19]{finish first and middle}{=\meta{graphical code}}{no default, initially unset}
+ This is an abbreviation for setting
+ \refKey{/tcb/finish first} and
+ \refKey{/tcb/finish middle} together.
+ \refKey{/tcb/finish} overwrites this key.
+\end{docTcbKey}
+
\clearpage
\subsection{Jigsaw Skin Variants}\label{subsec:skinjigsaw}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex
index e0d98e5e927..0a261de187f 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex
@@ -939,7 +939,7 @@ Let's try a more conservative approach:
coltitle=red!50!black,fonttitle=\upshape\bfseries,fontupper=\itshape,
drop fuzzy shadow=blue!50!black!50!white,boxrule=0.4pt}{theo}
-\begin{YetAnotherTheorem}{Mittelwertsatz f\"{u}r $n$ Variable}{mittelwertsatz_n3}%
+\begin{YetAnotherTheorem}{Mittelwertsatz f\"{u}r $n$ Variable}{mittelwertsatz_n4}%
Es sei $n\in\mathbb{N}$, $D\subseteq\mathbb{R}^n$ eine offene Menge und
$f\in C^{1}(D,\mathbb{R})$. Dann gibt es auf jeder Strecke
$[x_0,x]\subset D$ einen Punkt $\xi\in[x_0,x]$, so dass gilt
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index 0260b9a31a6..e491f7bc7d5 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 7a305b322fd..da6e97c717e 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 3.12 (2014/07/29)
+%% The LaTeX package tcolorbox - version 3.20 (2014/09/22)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -32,7 +32,7 @@
\usepackage{varwidth,cleveref,incgraph}
\usepackage[a4paper,left=2.5cm,right=2.5cm,top=1.5cm,bottom=1.5cm,
- marginparsep=5mm,marginparwidth=10mm,
+ marginparsep=3mm,marginparwidth=18mm,
headheight=0mm,headsep=0cm,
footskip=1.5cm,includeheadfoot]{geometry}
\usepackage{fancyhdr}
@@ -103,8 +103,11 @@
\newtcolorbox{marker}[1][]{marker,#1}
-\def\version{3.12}%
-\def\datum{2014/07/29}%
+\renewcommand*{\tcbdocnew}[1]{\textcolor{green!50!black}{\sffamily\bfseries N} #1}
+\renewcommand*{\tcbdocupdated}[1]{\textcolor{blue!75!black}{\sffamily\bfseries U} #1}
+
+\def\version{3.20}%
+\def\datum{2014/09/22}%
\makeindex
\hypersetup{
@@ -147,9 +150,10 @@
meta,marg,
oarg,
refCom,refEnv,refKey,
- tcbmakedocSubKey,
+ tcbmakedocSubKey,tcbdocmarginnote,tcbdocnew,tcbdocupdated,
% skins
tcbline,tcboxedtitleheight,tcboxedtitlewidth,
+ tcbsettowidthofnode,tcbsetmacrotowidthofnode,tcbsettoheightofnode,tcbsetmacrotoheightofnode,
% xparse
DeclareTColorBox,NewTColorBox,RenewTColorBox,ProvideTColorBox,
DeclareTotalTColorBox,NewTotalTColorBox,RenewTotalTColorBox,ProvideTotalTColorBox,
@@ -250,8 +254,7 @@
listing file={\solfile\thetcbcounter},label={exe:#2},
phantom={\writesol{#2}},
title={Exercise \thetcbcounter\hfill\mdseries Solution on page \pageref{sol:#2}},
- list entry={\protect\numberline{\thetcbcounter}Exercise with solution on
- page \pageref{sol:#2}},#1}
+ list text={Exercise with solution on page \pageref{sol:#2}},#1}
\end{tcbverbatimwrite}
\input{\jobname_preamble_E.tex}
@@ -305,7 +308,7 @@
%\tcbset{draftmode}
-%\includeonly{tcolorbox.doc.breakable}
+%\includeonly{tcolorbox.doc.abstract}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%