tcolorbox (9jan15)

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

10 files changed, 222 insertions, 54 deletions

diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 2e04c726bc6..07122cf9d68 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.35 (2015/01/07)
+%% The LaTeX package tcolorbox - version 3.36 (2015/01/09)
 %%
 %% -------------------------------------------------------------------------------------------
 %% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -706,3 +706,19 @@ version 3.35 (2015/01/07)
 - text color implementation changed to fix some color problems
 - new options: 'upperbox', 'visible', 'invisible'
 - documentation complemented
+
+version 3.36 (2015/01/09)
+- bug fix: dimension settings with 'em' or 'ex' units were sometimes converted to 0pt
+- bug fix: 'boxed title' options and some algorithms of the 'fitting' library were not compatible
+- bug fix: 'fit width from' ('fitting' library) may have updated counter too often
+- new option: 'only'
+- library 'fitting': fit process can now also includes the title
+- library 'raster': new option 'raster equal skip'
+- library 'documentation':
+  * new macros and environments:
+    '\docCounter', '\docCounter*', '\docLength', '\docLength*'
+  * new options:
+    'index command', 'index command name' (for imakeidx),
+    'color counter', 'color length',
+    'doclang/counter', 'doclang/counters', 'doclang/length', 'doclang/lengths'
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index 59d783cd45c..30adaaea12d 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.35 (2015/01/07)
+%% The LaTeX package tcolorbox - version 3.36 (2015/01/09)
 %%
 %% -------------------------------------------------------------------------------------------
 %% 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 7ff3efd5b55..10da2a9d6b7 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 bb3b185249d..ee6e83eae74 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.35 (2015/01/07)
+%% The LaTeX package tcolorbox - version 3.36 (2015/01/09)
 %% tcolorbox-example.tex: an example for 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 a4fe72836cf..e8f294be19d 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -3423,3 +3423,41 @@ standard settings of the package are used (v2.40 and above), see
 Section \ref{subsec:everybox} from page \pageref{subsec:everybox}.
 %See \refCom{tcbhighmath} for an example.
 \end{docTcbKey}
+
+\clearpage
+\begin{docTcbKey}[][doc new=2015-01-09]{only}{=\textless\meta{overlay specification}\textgreater\marg{options}}{style, no default, initially unset}
+Sets the given |tcolorbox| \meta{options} in dependency of
+a |beamer| \meta{overlay specification}. Note that this needs the |beamer| class.
+The \meta{options} will only be used on the specified |beamer| frames.
+
+\begin{dispListing}
+\documentclass{beamer}
+\usepackage[many]{tcolorbox}
+\begin{document}
+
+\begin{frame}
+  \begin{tcolorbox}[title=My title,fonttitle=\bfseries,
+      enhanced,colframe=red!50!black,colback=red!10,colbacktitle=red,
+      sidebyside,righthand width=3cm,
+      lowerbox=invisible,lower separated=false,
+      drop lifted shadow,
+      only=<1>{colbacktitle=yellow,coltitle=red!50!black,colframe=red},
+      only=<3>{colback=yellow!50,watermark text={Attention!}},
+      only=<3->{lowerbox=visible}  ]
+    This is a test.
+    \begin{itemize}[<+->]
+      \item One
+      \item Two
+      \item \alert<3>{Three}
+      \item Four
+    \end{itemize}
+  \tcblower
+    \begin{equation*}
+    \int\limits_{1}^{x} \frac{1}{t}~dt = \ln(x).
+    \end{equation*}
+  \end{tcolorbox}
+\end{frame}
+
+\end{document}
+\end{dispListing}
+\end{docTcbKey}
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 0cc49b12c16..27c4e505ded 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
@@ -172,6 +172,29 @@ The key \docAuxKey[foo]{fooaux} holds some interesting data.
 
 
 \clearpage
+\begin{docCommand}[doc new=2015-01-08]{docCounter}{\marg{name}}
+  Documents a counter with given \meta{name}. The counter is automatically indexed.
+\begin{dispExample}
+The counter \docCounter{foocounter} can be used for computation.
+\end{dispExample}
+\end{docCommand}
+
+\begin{docCommand}[doc new=2015-01-08]{docCounter*}{\marg{name}}
+  Identical to \refCom{docCounter}, but without index entry.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2015-01-08]{docLength}{\marg{name}}
+  Documents a counter with given \meta{name}. The counter is automatically indexed.
+\begin{dispExample}
+The length \docLength{foolength} can be used for computation.
+\end{dispExample}
+\end{docCommand}
+
+\begin{docCommand}[doc new=2015-01-08]{docLength*}{\marg{name}}
+  Identical to \refCom{docLength}, but without index entry.
+\end{docCommand}
+
+
 \begin{docCommand}{docColor}{\marg{name}}
   Documents a color with given \meta{name}. The color is automatically indexed.
 \begin{dispExample}
@@ -184,6 +207,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.
@@ -209,7 +233,6 @@ This is a mandatory \marg{argument}.
 \end{dispExample}
 \end{docCommand}
 
-
 \begin{docCommand}{oarg}{\marg{text}}
   Macro from |ltxdoc| \cite{carlisle:2007a} to typeset a \meta{text} with
   square brackets as an optional argument. The library overwrites the original macro.
@@ -487,48 +510,41 @@ with another note.
 \end{docTcbKey}
 
 
-\begin{docTcbKey}{color command}{=\meta{color}}{no default, initially |Definition|}
-  Sets the highlight color used by macro definitions.
-\end{docTcbKey}
-
-\begin{docTcbKey}{color environment}{=\meta{color}}{no default, initially |Definition|}
-  Sets the highlight color used by environment definitions.
-\end{docTcbKey}
-
-\begin{docTcbKey}{color key}{=\meta{color}}{no default, initially |Definition|}
-  Sets the highlight color used by key definitions.
+\begin{docTcbKey}{before example}{=\meta{macros}}{no default, initially \cs{par}\cs{smallskip}}
+  Sets the \meta{macros} which are executed before \refEnv{dispExample} and \refEnv{dispListing}
+  additional to \refKey{/tcb/before}.
 \end{docTcbKey}
 
-\begin{docTcbKey}{color value}{=\meta{color}}{no default, initially |Definition|}
-  Sets the highlight color used by value definitions.
+\begin{docTcbKey}{after example}{=\meta{macros}}{no default, initially empty}
+  Sets the \meta{macros} which are executed after \refEnv{dispExample} and \refEnv{dispListing}
+  additional to \refKey{/tcb/after}.
 \end{docTcbKey}
 
-\begin{docTcbKey}{color color}{=\meta{color}}{no default, initially |Definition|}
-  Sets the highlight color used by color definitions.
-\end{docTcbKey}
 
-\begin{docTcbKey}{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}, and \refKey{/tcb/color color}.
+\clearpage
+\begin{docTcbKey}[][doc new=2015-01-09]{index command}{=\meta{macro}}{no default, initially \cs{index}}
+  Replaces the internally used \cs{index} macro by the given \meta{macro}.
+  The \meta{macro} has to take one mandatory argument like \cs{index}.
+  This option is mutually exclusive with \refKey{/tcb/index command name}.
+\begin{dispListing}
+\tcbset{index command=\myindexcommand}
+\end{dispListing}
 \end{docTcbKey}
 
-\begin{docTcbKey}{color option}{=\meta{color}}{no default, initially |Option|}
-  Sets the color used for optional arguments.
-\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.
+\begin{docTcbKey}[][doc new=2015-01-09]{index command name}{=\meta{name}}{no default, initially unset}
+  Replaces the internally used \cs{index} macro by
+  \mbox{\cs{index}\texttt{[\meta{name}]}}, i.e.\ 
+  \mbox{\cs{index}\texttt{\textbraceleft\ldots\textbraceright}} is replaced by
+  \mbox{\cs{index}\texttt{[\meta{name}]\textbraceleft\ldots\textbraceright}}.
+  This option is intended to be used with |imakeidx| and is
+  mutually exclusive with \refKey{/tcb/index command}.
+\begin{dispListing}
+\tcbset{index command name=mydoc}
+\end{dispListing}
 \end{docTcbKey}
 
-\begin{docTcbKey}{before example}{=\meta{macros}}{no default, initially \cs{par}\cs{smallskip}}
-  Sets the \meta{macros} which are executed before \refEnv{dispExample} and \refEnv{dispListing}
-  additional to \refKey{/tcb/before}.
-\end{docTcbKey}
 
-\begin{docTcbKey}{after example}{=\meta{macros}}{no default, initially empty}
-  Sets the \meta{macros} which are executed after \refEnv{dispExample} and \refEnv{dispListing}
-  additional to \refKey{/tcb/after}.
-\end{docTcbKey}
 
 \begin{docTcbKey}{index format}{=\meta{format}}{no default, initially |pgf|}
   Determines the basic \meta{format} of the generated index.
@@ -540,7 +556,8 @@ with another note.
   \item\docValue{doc}: The index is assumed to be formatted by |doc| or |ltxdoc|. The usage of |makeindex|
     with |-s gind.ist| is assumed. The package |hypdoc| has to be loaded
     \emph{before} |tcolorbox|.
-  \item\docValue{off}: The index is not formatted by |tcolorbox|.
+  \item\docValue{off}: The index is not formatted by |tcolorbox|. Use this, if
+    the index is formatted by other package like |imakeidx|.
   \end{itemize}
 \end{docTcbKey}
 
@@ -573,6 +590,8 @@ with another note.
 \end{dispListing}
 \end{docTcbKey}
 
+\clearpage
+
 \begin{docTcbKey}{index annotate}{\colOpt{=true\textbar false}}{default |true|, initially |true|}
   If set to |true|, the index entries are annotated with short descriptions
   given by \refKey{/tcb/doclang/environment}, \refKey{/tcb/doclang/key},
@@ -585,6 +604,50 @@ with another note.
   and others.
 \end{docTcbKey}
 
+
+\begin{docTcbKey}{color command}{=\meta{color}}{no default, initially |Definition|}
+  Sets the highlight color used by macro definitions.
+\end{docTcbKey}
+
+\begin{docTcbKey}{color environment}{=\meta{color}}{no default, initially |Definition|}
+  Sets the highlight color used by environment definitions.
+\end{docTcbKey}
+
+\begin{docTcbKey}{color key}{=\meta{color}}{no default, initially |Definition|}
+  Sets the highlight color used by key definitions.
+\end{docTcbKey}
+
+\begin{docTcbKey}{color value}{=\meta{color}}{no default, initially |Definition|}
+  Sets the highlight color used by value definitions.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new={2015-01-08}]{color counter}{=\meta{color}}{no default, initially |Definition|}
+  Sets the highlight color used by counter definitions.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new={2015-01-08}]{color length}{=\meta{color}}{no default, initially |Definition|}
+  Sets the highlight color used by length definitions.
+\end{docTcbKey}
+
+\begin{docTcbKey}{color color}{=\meta{color}}{no default, initially |Definition|}
+  Sets the highlight color used by color definitions.
+\end{docTcbKey}
+
+\begin{docTcbKey}{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 length}, and \refKey{/tcb/color color}.
+\end{docTcbKey}
+
+\begin{docTcbKey}{color option}{=\meta{color}}{no default, initially |Option|}
+  Sets the color used for optional arguments.
+\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}
+
+
 \clearpage
 The following keys are provided for language specific settings.
 The English language is predefined.
@@ -601,6 +664,13 @@ The English language is predefined.
   Heading text in the index for colors.
 \end{langTcbKey}
 
+\begin{langTcbKey}[][doc new={2015-01-08}]{counter}{=\meta{text}}{no default, initially |counter|}
+  Text used in the index for counters.
+\end{langTcbKey}
+
+\begin{langTcbKey}[][doc new={2015-01-08}]{counters}{=\meta{text}}{no default, initially |Counters|}
+  Heading text in the index for counters.
+\end{langTcbKey}
 
 \begin{langTcbKey}{environment}{=\meta{text}}{no default, initially |environment|}
   Text used in the index for environments.
@@ -614,6 +684,10 @@ The English language is predefined.
   Text used in \refEnv{docEnvironment}.
 \end{langTcbKey}
 
+\begin{langTcbKey}{index}{=\meta{text}}{no default, initially |Index|}
+  Heading text for the index.
+\end{langTcbKey}
+
 \begin{langTcbKey}{key}{=\meta{text}}{no default, initially |key|}
   Text used in the index for keys.
 \end{langTcbKey}
@@ -622,10 +696,15 @@ 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.
+\begin{langTcbKey}[][doc new={2015-01-08}]{length}{=\meta{text}}{no default, initially |length|}
+  Text used in the index for lengths.
 \end{langTcbKey}
 
+\begin{langTcbKey}[][doc new={2015-01-08}]{lengths}{=\meta{text}}{no default, initially |Lengths|}
+  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}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex
index 642ec9b91f6..0c4b350e3cb 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.fitting.tex
@@ -19,19 +19,19 @@ The library is loaded by a package option or inside the preamble by:
 
 \enlargethispage*{1cm}
 \begin{dispExample}
-% \usepackage{lipsum}
+% \usepackage{lipsum} \tcbuselibrary{raster}
 \tcbset{colframe=blue!50!black,colback=red!10!white,
-        boxsep=0pt,top=1mm,bottom=1mm,left=1mm,right=1mm,
-        nobeforeafter,width=(\linewidth-2mm)/3}
-
-\tcboxfit[height=8cm]{\lipsum[1]}\hfill
-\tcboxfit[height=4cm]{\lipsum[1]}\hfill
-\tcboxfit[height=2cm]{\lipsum[1]}
-
-\medskip
-\tcbset{width=(\linewidth-2mm)/2,colback=green!10!white,boxsep=1mm}
-\tcboxfit[height=4cm]{\lipsum[2]}\hfill
-\tcboxfit[height=4cm,title=With a title]{\lipsum[2]}
+    boxsep=0pt,top=1mm,bottom=1mm,left=1mm,right=1mm,
+    fit algorithm=hybrid*,raster equal skip=1mm}
+\begin{tcbraster}[raster columns=3,raster valign=bottom]
+  \tcboxfit[height=8cm]{\lipsum[1]}
+  \tcboxfit[height=4cm]{\lipsum[1]}
+  \tcboxfit[height=2cm]{\lipsum[1]}
+\end{tcbraster}
+\begin{tcbraster}[colback=green!10!white,boxsep=1mm]
+  \tcboxfit[height=4cm]{\lipsum[2]}
+  \tcboxfit[height=4cm,title=With a title]{\lipsum[2]}
+\end{tcbraster}
 \end{dispExample}
 \end{docCommand}
 
@@ -275,6 +275,19 @@ are also usable without the
 \end{tcolorbox}
 
 \end{dispExample*}
+
+
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\tcbset{size=fbox,colback=red!5!white,
+  colframe=red!75!black}
+
+\tcboxfit[height=5cm,
+  fit fontsize macros,
+  fonttitle=\normalsize\bfseries,
+  title=Adapted title]
+{\lipsum[2]}
+
+\end{dispExample*}
 \end{docTcbKey}
 
 
@@ -331,7 +344,7 @@ This is a tcolorbox.
 
 
 \begin{marker}
-Typically, the optional title of a |tcolorbox| is not part of the fit operation.
+Typically but not necessarily, the optional title of a |tcolorbox| is not part of the fit operation.
 If a \refKey{/tcb/fit width plus} is applied, the title is also adapted to
 the new width. If counters are increased inside the title text, they may be
 increased more than one time.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
index 7a3264583c2..cf39926214d 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
@@ -257,6 +257,25 @@ If \refKey{/tcb/fit} should be used, turn over to \refEnv{tcbraster}.
 \end{docTcbKey}
 
 
+\begin{docTcbKey}[][doc new=2015-01-08]{raster equal skip}{=\meta{length}}{style, no default}
+  Shortcut to set
+  \refKey{/tcb/raster before skip},
+  \refKey{/tcb/raster after skip},
+  \refKey{/tcb/raster column skip}, and
+  \refKey{/tcb/raster row skip}
+  to the same \meta{length} value.
+\begin{dispExample}
+\begin{tcbitemize}[raster equal skip=4mm,
+  size=small,colframe=red!50!black,colback=red!10!white]
+  \tcbitem One
+  \tcbitem Two
+  \tcbitem Three
+  \tcbitem Four
+\end{tcbitemize}
+\end{dispExample}
+\end{docTcbKey}
+
+
 \clearpage
 
 \begin{docTcbKey}[][doc new=2014-11-10]{raster left skip}{=\meta{length}}{no default, initially |0pt|}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index 4f3599d2ba6..b6c11367e9a 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 0387dcb2cb0..29b1323fc0e 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.35 (2015/01/07)
+%% The LaTeX package tcolorbox - version 3.36 (2015/01/09)
 %% tcolorbox.tex: Manual
 %%
 %% -------------------------------------------------------------------------------------------
@@ -78,6 +78,8 @@
   color key=DarkViolet,
   color value=Teal,
   color color=Teal,
+  color counter=Orange!85!black,
+  color length=Orange!85!black,
   index colorize,index annotate}
 \urlstyle{sf}
 
@@ -107,8 +109,8 @@
 \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.35}%
-\def\datum{2015/01/07}%
+\def\version{3.36}%
+\def\datum{2015/01/09}%
 \makeindex
 
 \hypersetup{
@@ -151,6 +153,7 @@
     brackets,
     colDef,colOpt,cs,
     docAuxCommand,docColor,docAuxEnvironment,docAuxKey,
+    docCounter,docLength,
     meta,marg,
     oarg,
     refCom,refEnv,refKey,