summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-11-28 23:30:05 +0000
committerKarl Berry <karl@freefriends.org>2014-11-28 23:30:05 +0000
commit33526e1dcce800a5967a3113e832201f73b1124c (patch)
treeae4bdb1d48e811586941ea1b4292cc67e0aab70d /Master/texmf-dist/doc/latex/tcolorbox
parent86773524358dec0e1f056b8dbe80b2459c5ce8cd (diff)
tcolorbox (28nov14)
git-svn-id: svn://tug.org/texlive/trunk@35686 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES14
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin361375 -> 361359 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.tex72
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex48
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex12
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex65
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex24
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex186
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.verbatim.tex1
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin5098840 -> 5189526 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex63
13 files changed, 404 insertions, 85 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index b9b918d9601..f1e300a7db2 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.30 (2014/11/17)
+%% The LaTeX package tcolorbox - version 3.31 (2014/11/28)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -670,3 +670,15 @@ version 3.30 (2014/11/17)
'raster odd column', 'raster even column', 'raster column n', 'raster odd row',
'raster even row', 'raster row m','raster odd number', 'raster even number',
'raster row m column n', 'raster number n'
+
+version 3.31 (2014/11/28)
+- new macros: '\tcbstartrecording', '\tcbrecord', '\tcbstoprecording', '\tcbinputrecords'
+- new option: 'squeezed title', 'squeezed title*', 'phantomlabel',
+ 'record', 'no recording'
+- 'savelowerto' changed to need only one run instead of two
+- library 'skins':
+ * '\imagename' macro can be used in more situations
+ * '\tcbincludegraphics' made aware of 'grffile' package
+- new library 'raster':
+ * tcbraster safeguarded against restricted horizontal mode
+ * new option: 'raster every box'
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index e13acdde5b8..8518a74fcab 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.30 (2014/11/17)
+%% The LaTeX package tcolorbox - version 3.31 (2014/11/28)
%%
%% -------------------------------------------------------------------------------------------
%% 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 c39dcb96838..4fc0a744cb3 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 f6d9ac5733f..23909f20912 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.30 (2014/11/17)
+%% The LaTeX package tcolorbox - version 3.31 (2014/11/28)
%% 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 89327dcde48..b63a1ca9ba1 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.abstract.tex
@@ -4,23 +4,52 @@
% \usepackage{incgraph}
\begin{inctext}
\begin{tikzpicture}
-\definecolorseries{boxcol}{rgb}{last}{red}{blue}
-\resetcolorseries[24]{boxcol}
+\definecolorseries{boxcol}{rgb}{last}{blue}{red}
+\resetcolorseries[28]{boxcol}
\coordinate (A) at (0,0); \coordinate (B) at (21,29.7);
-\path[use as bounding box,top color=Goldenrod!25!white,bottom color=Navy!25!white]
- (A) rectangle coordinate (C) (B);
-\foreach \w in {-15,-30,...,-360}
-{\node[below right,rotate around={\w:(C)}] at ([xshift=1cm]C) {%
- \begin{tcolorbox}[width=8cm,title=tcolorbox \version,
- fontupper=\scriptsize,fonttitle=\small\bfseries,
- colframe=boxcol,colback=boxcol!25!white,colbacktitle=boxcol!!+!50!black,
- enhanced jigsaw,opacityback=0.5,opacitybacktitle=0.75]
- \lipsum[2]
- \end{tcolorbox}};
-}
-\node[font=\Huge\bfseries] at ([yshift=12cm]C) {|tcolorbox|};
-\node[font=\large\bfseries] at ([yshift=-12cm]C)
- {Manual for version \version\ (\datum)};
+\path[use as bounding box] (A) rectangle coordinate (C) (B);
+\node[transform shape,xslant=0.7,rotate=-10,xshift=0cm] at (C) {%
+ \begin{tcbraster}[raster columns=4,title=tcolorbox \version,
+ fonttitle=\small\bfseries,raster width=50cm]
+ \foreach \b in {1,...,28} {\begin{tcolorbox}[enhanced,
+ watermark text=\thetcbrasternum,
+ colframe=boxcol!30!white,
+ colback=boxcol!25!white!30!white,
+ colbacktitle=boxcol!!+!50!black!30!white,
+ colupper=black!30!white]\lipsum[2]\end{tcolorbox}}
+ \end{tcbraster}%
+};
+\node at (C) {%
+ \begin{tcbitemize}[title=tcolorbox \version,fonttitle=\small\bfseries,
+ enhanced jigsaw,opacityback=0.5,opacitybacktitle=0.75,
+ center upper,valign=center,arc=5mm,
+ raster width=16cm,raster column skip=8mm,raster halign=center,
+ raster force size=false,
+ raster row 1/.style={height=6cm},
+ raster row 2/.style={width=6cm,height=4cm},
+ raster column 1/.style={flushright title,
+ frame style={left color=yellow!50!black,right color=green!50!black},
+ title style={left color=yellow!50!blue,right color=blue!50!green!50!black},
+ interior style={left color=yellow!70,right color=green!70},
+ underlay={\draw[line width=6mm,line cap=round,black!60]
+ ([shift={(0.4,-0.15)}]frame.north east)
+ --([shift={(0.4,0.15)}]frame.south east); }},
+ raster column 2/.style={
+ frame style={left color=green!50!black,right color=yellow!50!black},
+ title style={left color=blue!50!green!50!black,right color=yellow!50!blue},
+ interior style={left color=green!70,right color=yellow!70}}]
+ \tcbitem[fontupper=\Huge\bfseries,sharp corners=east,
+ underlay={\draw[line width=6mm,line cap=round,black!60]
+ ([shift={(0.4,0.30)}]frame.north east)-- coordinate(A) +(0,0.2);
+ \draw[line width=1mm,line cap=round,black!60](A) -- +(30:1.5cm);
+ \draw[line width=1mm,line cap=round,black!60](A) -- +(150:1.5cm);}]
+ tcolorbox
+ \tcbitem[fontupper=\large\bfseries,sharp corners=west]
+ Manual for\\ version\\ \version\\(\datum)
+ \tcbitem[sharp corners=northeast]
+ \tcbitem[sharp corners=northwest] Thomas F.~Sturm
+ \end{tcbitemize}%
+};
\end{tikzpicture}
\end{inctext}
\end{tcboutputlisting}
@@ -30,12 +59,11 @@
colbacktitle=Navy!15!ExampleBack,top=0mm,before=\par\smallskip,%
listing style=mydocumentation,listing only}
-\bigskip
-
-\begin{marker}
-If you have trouble printing this document, the reason is quite likely the
-cover page. Printing the pages starting with page 2 or page 3 should work.
-\end{marker}
+%\bigskip
+%\begin{marker}
+%If you have trouble printing this document, the reason is quite likely the
+%cover page. Printing the pages starting with page 2 or page 3 should work.
+%\end{marker}
\clearpage
\begin{center}
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 b1782eb8d16..9af1eaa1d8f 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -53,6 +53,41 @@ Now, we try again with adjusted titles:\\
\clearpage
+\begin{docTcbKey}[][doc new=2014-11-24]{squeezed title}{=\meta{text}}{style, no default, initially unset}
+ Creates a single heading line with \meta{text} as content.
+ If the \meta{text} is longer than the available space, the text is
+ squeezed to fit into the available space.
+\begin{dispExample}
+% \tcbuselibrary{raster}
+\begin{tcbitemize}[raster columns=3,raster equal height,
+ colframe=red!75!black,colback=red!5!white,fonttitle=\bfseries]
+\tcbitem[squeezed title={Short title}]
+ First box
+\tcbitem[squeezed title={This is a very very long title}]
+ Second box
+\tcbitem[squeezed title={This title is clearly to long for this application}]
+ Third box
+\end{tcbitemize}
+\end{dispExample}
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2014-11-24]{squeezed title*}{=\meta{text}}{style, no default, initially unset}
+ This is a combination of \refKey{/tcb/adjusted title} and \refKey{/tcb/squeezed title}.
+\begin{dispExample}
+% \tcbuselibrary{raster}
+\begin{tcbitemize}[raster columns=3,raster equal height,
+ colframe=red!75!black,colback=red!5!white,fonttitle=\bfseries]
+\tcbitem[squeezed title*={Short title}]
+ First box
+\tcbitem[squeezed title*={This is a very very long title}]
+ Second box
+\tcbitem[squeezed title*={This title is clearly to long for this application}]
+ Third box
+\end{tcbitemize}
+\end{dispExample}
+\end{docTcbKey}
+
+\clearpage
\begin{docTcbKey}{detach title}{}{no value}
Detaches the title from its normal position. The text of the title is
stored into \docAuxCommand{tcbtitletext} and the formatted title is
@@ -191,7 +226,7 @@ This is the lower part (but ignored).
\end{docTcbKey}
-\begin{docTcbKey}{savelowerto}{=\meta{file name}}{no default, initially empty}
+\begin{docTcbKey}[][doc updated=2014-11-28]{savelowerto}{=\meta{file name}}{no default, initially empty}
Saves the content of the lower part in a file for an optional later usage.
\begin{dispExample}
\begin{tcolorbox}[lowerbox=invisible,savelowerto=\jobname_bspsave.tex,colback=white]
@@ -1409,6 +1444,11 @@ colframe=red!75!black,colback=white}
\end{dispExample}
\end{docTcbKey}
+\medskip
+\begin{marker}
+See \Vref{sec:raster} for more equal height options.
+\end{marker}
+
\clearpage
\begin{docTcbKey}{minimum for equal height group}{=\meta{id}:\meta{length}}{no default, initially unset}
Plants a \meta{length} into the equal height group with
@@ -3103,6 +3143,12 @@ Typically, this option is used for numbered boxes, see Subsection \ref{sec:numbe
from page \pageref{sec:numberedboxes}, e.\,g.\ \refKey{/tcb/new/auto counter}.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-11-28]{phantomlabel}{=\meta{marker}}{no default, initially unset}
+Equivalent to \refKey{/tcb/label} for an \emph{unnumbered} box.
+A |\phantomsection| from the package |hyperref| is used to set a correct
+hyperlink target. This is not needed for a numbered box.
+\end{docTcbKey}
+
\begin{docTcbKey}{label type}{=\meta{type}}{no default, initially unset}
This option key can be used only in conjunction with the |cleveref| package
\cite{cubitt:2013a} which has to be loaded separately.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex
index 5e3e6e672cb..f6302028a86 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex
@@ -14,7 +14,7 @@ See \Vref{sec:skins} for the documentation of all other options of the \mylib{sk
\subsection{Macros}
-\begin{docCommand}[doc new=2014-11-14]{tcbincludegraphics}{\oarg{options}\marg{file name}}
+\begin{docCommand}[doc new and updated={2014-11-14}{2014-11-24}]{tcbincludegraphics}{\oarg{options}\marg{file name}}
In principle, this macro includes an image file denoted by \meta{file name}
using the standard |\includegraphics| and puts it into a \refEnv{tcolorbox}.
The \meta{options} are |tcolorbox| keys to set up the colored box.
@@ -50,8 +50,8 @@ See \Vref{sec:skins} for the documentation of all other options of the \mylib{sk
\clearpage
The auxiliary macro \docAuxCommand{imagename} may be used inside
\refCom{tcbincludegraphics} to display the name of the file.
-\docAuxCommand{imagename} is already detokenized and is allowed to
-included special characters like the underscore. Note that an appropriate
+\docAuxCommand{imagename} is already partially detokenized and is allowed to
+contain special characters like the underscore. Note that an appropriate
font is required to display such characters.
%\docAuxCommand{imagepath}%
@@ -127,6 +127,12 @@ specify a file system \meta{directory} where the image files are located.
graphics directory={../../pictures},
}
\end{dispListing}
+\smallskip
+\begin{marker}
+The |\graphicspath| macro from the |graphics| package is superior to this option.
+\refKey{/tcb/graphics directory} may be used especially for
+\refCom{tcbincludepdf}.
+\end{marker}
\end{docTcbKey}
\begin{docTcbKey}[][doc new=2014-11-14]{graphics pages}{=\meta{selection}}{no default, initially |1,...,|\cs{pdfpages}}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
index 65a406d2712..86b63b18dbf 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
@@ -1293,31 +1293,19 @@ The following series of examples demonstrate the application of
In the following, a guideline is given for the creation of \LaTeX\ exercises
with solutions. These solutions are saved to disk for application at a place of
choice.
-Therefore, all used exercises are logged to a file |\jobname.sol| for automatic
+Therefore, all used exercises are logged to a file |\jobname.records| for automatic
processing. The solution contents themselves are saved to a subdirectory named
-|solutions|.
-
-\begin{dispListing}
-%\newcounter{texercise} % preamble
-
-\newwrite\solout
-\def\openoutsol{\immediate\openout\solout\jobname.sol}
-\def\solfile#1{solutions/texercise#1.tex}
-\def\writesol#1{\immediate\write\solout{\noexpand\processsol{\thetcbcounter}{#1}}}%
-\def\closeoutsol{\immediate\closeout\solout}
-\def\inputsol{\IfFileExists{\jobname.sol}{\input{\jobname.sol}}{}}
-\end{dispListing}
-\tcbusetemp
+|solutions|. Also see \Vref{sec:recording}.
\begin{itemize}
\item Before the first exercise is given,
- |\openoutsol| has to be called to start logging.
+ \refCom{tcbstartrecording} has to be called to start recording.
\item The solution is given as content of a \refEnv{tcboutputlisting}
environment. Note, that you can use this content also inside the
exercise with \refCom{tcbuselistingtext} in compiled form.
\item After the last exercise is given (and before using the solutions),
- |\closeoutsol| has to be called to stop logging.
-\item The solutions are loaded by |\inputsol|.
+ \refCom{tcbstoprecording} has to be called to stop recording.
+\item The solutions are loaded by \refCom{tcbinputrecords}.
\end{itemize}
Inside the exercise text, there may be text parts which are needed as
@@ -1334,7 +1322,9 @@ and the label |sol:|\meta{marker} is used to mark the solution.
\begin{dispListing}
\tcbset{texercisestyle/.style={arc=0.5mm, colframe=blue!25!yellow!90!white,
colback=blue!25!yellow!5!white, coltitle=blue!25!yellow!40!black,
- fonttitle=\small\sffamily\bfseries, fontupper=\small, fontlower=\small}}
+ fonttitle=\small\sffamily\bfseries, fontupper=\small, fontlower=\small,
+ listing options={style=tcblatex,texcsstyle=*\color{red!40!black}},
+}}
\end{dispListing}
\tcbusetemp
@@ -1343,17 +1333,13 @@ exercises is created quickly:
\inputpreamblelisting{E}
+\clearpage
+The following examples demonstrate the application.
+
\begin{dispListing}
-\newtcolorbox{texercise}[2][]{texercisestyle,
- listing file={\solfile\thetexercise},
- phantom={\refstepcounter{texercise}\label{exe:#2}\writesol{#2}},
- title={Exercise \arabic{texercise}%
- \hfill\mdseries Solution on page \pageref{sol:#2}},#1}
+\tcbstartrecording
\end{dispListing}
-%\tcbusetemp
-
-The following examples demonstrate the application.
-\openoutsol
+\tcbusetemp
\begin{dispExample}
@@ -1448,7 +1434,12 @@ total line width.\par\smallskip
\tcbusetemplisting\par\smallskip\tcbusetemp%
\end{texercise}
\end{dispExample}
-\closeoutsol
+%\closeoutsol
+
+\begin{dispListing}
+\tcbstoprecording
+\end{dispListing}
+\tcbusetemp
\bigskip
@@ -1463,23 +1454,25 @@ Now, we give a list of all exercises with:
\clearpage
\subsection{Solutions for the given \LaTeX\ Exercises}
-For all solutions, a macro |\processsol| was written to the file |\jobname.sol|.
+For all solutions, a macro |\processsol| was written to the file |\jobname.records|.
Now, we need a definition for this macro to use the solutions.
\begin{dispListing}
-% \usepackage{hyperref} % for \phantomsection
-\newcommand{\processsol}[2]{%
- \tcbinputlisting{texercisestyle,listing only,
- phantom={\phantomsection\label{sol:#2}},%
- title={Solution for Exercise \ref{exe:#2} on page \pageref{exe:#2}},
- listing file={\solfile{#1}}}}
+% \usepackage{hyperref} % for phantomlabel
+\newtcbinputlisting{\processsol}[2]{%
+ texercisestyle,
+ listing only,
+ listing file={#1},
+ phantomlabel={sol:#2},%
+ title={Solution for Exercise \ref{exe:#2} on page \pageref{exe:#2}},
+}
\end{dispListing}
\tcbusetemp
The loading of all solutions is done by:
\begin{dispListing}
-\inputsol
+\tcbinputrecords
\end{dispListing}
With this, we get:
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 a28f326e658..49a2911da29 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
@@ -462,7 +462,11 @@ a \emph{raster}. Note that such style definitions are not removed by
\refKey{/tcb/reset} or \refKey{/tcb/raster reset}.
The style definitions are used in the order given below.
-\begin{docTcbKey}{raster odd column}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-24]{raster every box}{}{style}
+This style is used for every box.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2014-11-10]{raster odd column}{}{style}
This style is used for every box in an odd column.
\begin{dispExample}
\begin{tcbitemize}[size=small,colframe=red!50!black,colback=red!10!white,
@@ -475,27 +479,27 @@ This style is used for every box in an odd column.
\end{dispExample}
\end{docTcbKey}
-\begin{docTcbKey}{raster even column}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster even column}{}{style}
This style is used for every box in an even column.
\end{docTcbKey}
-\begin{docTcbKey}{raster column n}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster column n}{}{style}
This style is used for every box in the |n|-th column.
|n| has to be replaced by a number.
\end{docTcbKey}
-\begin{docTcbKey}{raster odd row}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster odd row}{}{style}
This style is used for every box in an odd row.
\end{docTcbKey}
-\begin{docTcbKey}{raster even row}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster even row}{}{style}
This style is used for every box in an even row.
\end{docTcbKey}
-\begin{docTcbKey}{raster row m}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster row m}{}{style}
This style is used for every box in the |m|-th row.
|m| has to be replaced by a number.
\begin{dispExample}
@@ -509,11 +513,11 @@ This style is used for every box in the |m|-th row.
\end{dispExample}
\end{docTcbKey}
-\begin{docTcbKey}{raster odd number}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster odd number}{}{style}
This style is used for every box with an odd number.
\end{docTcbKey}
-\begin{docTcbKey}{raster even number}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster even number}{}{style}
This style is used for every box with an even number.
\begin{dispExample}
\begin{tcbitemize}[size=small,colframe=red!50!black,colback=red!10!white,
@@ -530,14 +534,14 @@ This style is used for every box with an even number.
\end{docTcbKey}
-\begin{docTcbKey}{raster row m column n}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster row m column n}{}{style}
This style is used for the box in the
|m|-th row and |n|-th column.
|m| and |n| have to be replaced by numbers.
\end{docTcbKey}
-\begin{docTcbKey}{raster number n}{}{style}
+\begin{docTcbKey}[][doc new=2014-11-10]{raster number n}{}{style}
This style is used for the box with number |n|.
|n| has to be replaced by a number.
\begin{dispExample}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex
new file mode 100644
index 00000000000..38d5859f0fb
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex
@@ -0,0 +1,186 @@
+% !TeX root = tcolorbox.tex
+% include file of tcolorbox.tex (manual of the LaTeX package tcolorbox)
+\clearpage
+\section{Recording}\label{sec:recording}
+The package provides some macros and options to take \emph{records} during
+compilation. This is done by \LaTeX\ file operations to save some data
+to a file for later usage. The main application scenario is depicted in
+\Vref{sec:recording-exercises} where
+informations about example solutions are recorded and read again
+in \Vref{sec:recording-solutions}.
+
+\subsection{Makros}\label{sec:recording-makros}
+\begin{docCommand}[doc new=2014-11-28]{tcbstartrecording}{\oarg{file name}}
+ 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.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2014-11-28]{tcbrecord}{\marg{content}}
+ Records any \meta{content} to the record file.
+ \refCom{tcbrecord} is implemented as |\immediate\write|.
+ \refCom{tcbstartrecording} has to be called before; otherwise, \refCom{tcbrecord}
+ is silently ignored.
+\begin{dispListing}
+\tcbrecord{\string\solution{\thetcbcounter}{solutions/exercise-\thetcbcounter.tex}}
+\end{dispListing}
+\end{docCommand}
+
+\begin{docCommand}[doc new=2014-11-28]{tcbstoprecording}{}
+ Closes the current record file which was opened by \refCom{tcbstartrecording}
+ before.
+\end{docCommand}
+
+\begin{docCommand}[doc new=2014-11-28]{tcbinputrecords}{\oarg{file name}}
+ Opens a file denoted by \meta{file name} for reading the records via |\input|.
+ The default file name is the name of the last used record file for saving.
+ \refCom{tcbstoprecording} has to be called before.
+\end{docCommand}
+
+
+\subsection{Options}\label{sec:recording-options}
+\begin{docTcbKey}[][doc new=2014-11-28]{record}{=\meta{content}}{style, no default}
+ Records any \meta{content} to the record file, see \refCom{tcbrecord}.
+ This key can be used several times to write several lines.
+ \begin{dispListing}
+ record={\string\solution{\thetcbcounter}{solutions/exercise-\thetcbcounter.tex}}
+ \end{dispListing}
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2014-11-28]{no recording}{}{}
+ Disables \refCom{tcbrecord} and \refKey{/tcb/record} inside the current
+ group.
+\end{docTcbKey}
+
+
+\clearpage
+\subsection{Example: Exercises}\label{sec:recording-exercises}
+The following application example creates exercises and their corresponding
+solutions. Each pair is generated inside a single |tcolorbox| where the
+solution is given below \refCom{tcblower}. For every example, the solution part
+is saved by \refKey{/tcb/savelowerto} to a file. The saving is recorded using
+\refKey{/tcb/record}. To enlighten the possibilities, the second exercise
+has no solution. Finally, the solutions are input in \Vref{sec:recording-solutions}.
+
+\inputpreamblelisting{L}
+
+\begin{dispListing*}{breakable,before upper=}
+\tcbstartrecording
+
+\begin{exercise}
+ Compute the derivative of the following function:
+ \begin{equation*}
+ f(x)=\sin((\sin x)^2)
+ \end{equation*}
+\tcblower
+ The derivative is:
+ \begin{align*}
+ f'(x) &= \left( \sin((\sin x)^2) \right)'
+ =\cos((\sin x)^2) 2\sin x \cos x.
+ \end{align*}
+\end{exercise}
+
+\begin{exercise}[no solution]
+ It holds:
+ \begin{equation*}
+ \frac{d}{dx}\left(\ln|x|\right) = \frac{1}{x}.
+ \end{equation*}
+\end{exercise}
+
+\begin{exercise}
+ Compute the derivative of the following function:
+ \begin{equation*}
+ f(x)=(\sin(\sin x))^2
+ \end{equation*}
+\tcblower
+ The derivative is:
+ \begin{align*}
+ f'(x) &= \left( (\sin(\sin x))^2 \right)'
+ =2\sin(\sin x)\cos(\sin x)\cos x.
+ \end{align*}
+\end{exercise}
+
+\begin{exercise}
+ Compute the derivative of the following function:
+ \begin{equation*}
+ f(x)=\sqrt{x^3-6x^2+2x}
+ \end{equation*}
+\tcblower
+ The derivative is:
+ \begin{align*}
+ f'(x) &= \left( \sqrt{x^3-6x^2+2x} \right)'
+ = \frac{3x^2-12x+2}{2\sqrt{x^3-6x^2+2x}}.
+ \end{align*}
+\end{exercise}
+
+\begin{exercise}
+ Compute the derivative of the following function:
+ \begin{equation*}
+ f(x)=\left(\frac{2+3x}{1-2x}\right)^3
+ \end{equation*}
+\tcblower
+ The derivative is:
+ \begin{align*}
+ f'(x) &= \left( \left(\frac{2+3x}{1-2x}\right)^3 \right)'
+ = 3 \left(\frac{2+3x}{1-2x}\right)^2 \frac{(1-2x)3-(2+3x)(-2)}{(1-2x)^2}
+ = \frac{21(2+3x)^2}{(1-2x)^4}.
+ \end{align*}
+\end{exercise}
+
+\begin{exercise}
+ Compute the derivative of the following function:
+ \begin{equation*}
+ f(x)=\frac{\cos x}{(\tan 2x)^2}
+ \end{equation*}
+\tcblower
+ The derivative is:
+ \begin{align*}
+ f'(x) &= \left( \frac{\cos x}{(\tan 2x)^2} \right)'
+ = \left( \frac{\cos x (\cos 2x)^2}{(\sin 2x)^2} \right)'\\
+ &= \frac{(\sin 2x)^2 [(-\sin x)(\cos 2x)^2+(\cos x)4\cos 2x (-\sin 2x)]
+ - \cos x (\cos 2x)^2 4\sin 2x \cos 2x}{(\sin 2x)^4}\\
+ &= -\frac{\cos(2x) [\sin x \sin 2x \cos 2x+ 4\cos x(\sin 2x)^2
+ + 4 \cos x (\cos 2x)^2]}{(\sin 2x)^3}\\
+ &= -\frac{\cos(2x) [\sin x \sin 2x \cos 2x+ 4\cos x]}{(\sin 2x)^3}.
+ \end{align*}
+\end{exercise}
+
+\begin{exercise}
+ Compute the derivative of the following function:
+ \begin{equation*}
+ f(x)=\cos((2x^2+3)^3)
+ \end{equation*}
+\tcblower
+ The derivative is:
+ \begin{align*}
+ f'(x) &= \left( \cos((2x^2+3)^3) \right)'
+ =-\sin((2x^2+3)^3) 3(2x^2+3)^2 2\cdot 2x\\
+ &=-12x(2x^2+3)^2\sin((2x^2+3)^3).
+ \end{align*}
+\end{exercise}
+
+\begin{exercise}
+ Compute the derivative of the following function:
+ \begin{equation*}
+ f(x)=(x^2+1)\sqrt{x^4+1}
+ \end{equation*}
+\tcblower
+ The derivative is:
+ \begin{align*}
+ f'(x) &= \left( (x^2+1)\sqrt{x^4+1} \right)'
+ = 2x\sqrt{x^4+1} + \frac{2x^3(x^2+1)}{\sqrt{x^4+1}}.
+ \end{align*}
+\end{exercise}
+
+\tcbstoprecording
+\end{dispListing*}
+\tcbusetemp
+
+\subsection{Example: Solutions}\label{sec:recording-solutions}
+This concludes the example given in \Vref{sec:recording-exercises}.
+Now, the saved and recorded solutions are included.
+
+\begin{dispListing*}{breakable,before upper=}
+\tcbinputrecords
+\end{dispListing*}
+\tcbusetemp
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.verbatim.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.verbatim.tex
index 03494e42e1e..7d654d2cebf 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.verbatim.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.verbatim.tex
@@ -54,4 +54,3 @@ Now, we are using the file:\par
\begin{docCommand}{tcbusetemp}{}
Loads the current temporary file which was saved by \refEnv{tcbwritetemp}.
\end{docCommand}
-
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index 91fc5275574..d7f8629d926 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 28008bbb92e..402233df465 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.30 (2014/11/17)
+%% The LaTeX package tcolorbox - version 3.31 (2014/11/28)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -69,6 +69,7 @@
\providecommand{\tcbpkgprefix}{}
\usepackage[all]{\tcbpkgprefix tcolorbox}
+\usepackage[extendedchars,encoding,filenameencoding=utf-8]{grffile}
\tcbset{skin=enhanced,
doc head={colback=yellow!10!white,interior style=fill},
@@ -105,8 +106,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.30}%
-\def\datum{2014/11/17}%
+\def\version{3.31}%
+\def\datum{2014/11/28}%
\makeindex
\hypersetup{
@@ -136,7 +137,7 @@
moretexcs={% core
endtcolorbox,endtcbverbatimwrite,newtcolorbox,newtcbox,newtcboxfit,tcbusetemp,tcbtitle,tcbtitletext,
tcblower,tcbox,tcboxfit,tcbset,tcbuselibrary,tcolorbox,tcbverbatimwrite,tcbsetforeverylayer,tcbsubtitle,
- tcolorboxenvironment,
+ tcolorboxenvironment,tcblistof,tcbstartrecording,tcbrecord,tcbstoprecording,tcbinputrecords,
% listings
endtcblisting,newtcblisting,newtcbinputlisting,
tcblisting,tcbinputlisting,tcbuselistingtext,tcbuselistinglisting,tcbusetemplisting,
@@ -252,10 +253,11 @@
\input{\jobname_preamble_D.tex}
\begin{tcbverbatimwrite}{\jobname_preamble_E.tex}
-\newtcolorbox[auto counter,number within=section,list inside=exam]%
- {texercise}[2][]{texercisestyle,
- listing file={\solfile\thetcbcounter},label={exe:#2},
- phantom={\writesol{#2}},
+\newtcolorbox[auto counter,number within=section,list inside=exam]{texercise}[2][]{%
+ texercisestyle,
+ listing file={solutions/texercise\thetcbcounter.tex},
+ label={exe:#2},
+ record={\string\processsol{solutions/texercise\thetcbcounter.tex}{#2}},
title={Exercise \thetcbcounter\hfill\mdseries Solution on page \pageref{sol:#2}},
list text={Exercise with solution on page \pageref{sol:#2}},#1}
\end{tcbverbatimwrite}
@@ -327,8 +329,50 @@
\input{\jobname_preamble_K.tex}
+\begin{tcbverbatimwrite}{\jobname_preamble_L.tex}
+% \tcbuselibrary{skins,xparse}
+
+\NewTColorBox[auto counter,number within=section]{exercise}{+O{}}{%
+ enhanced,colframe=green!20!black,colback=yellow!10!white,coltitle=green!40!black,
+ fonttitle=\bfseries,
+ underlay={\begin{tcbclipinterior}
+ \shade[inner color=green!80!yellow,outer color=yellow!10!white]
+ (interior.north west) circle (2cm);
+ \draw[help lines,step=5mm,yellow!80!black,shift={(interior.north west)}]
+ (interior.south west) grid (interior.north east);
+ \end{tcbclipinterior}},
+ title={Exercise~\thetcbcounter:},
+ label={exercise@\thetcbcounter},
+ attach title to upper=\quad,
+ after upper={\par\hfill\textcolor{green!40!black}%
+ {\itshape Solution on page~\pageref{solution@\thetcbcounter}}},
+ lowerbox=ignored,
+ savelowerto=solutions/exercise-\thetcbcounter.tex,
+ record={\string\solution{\thetcbcounter}{solutions/exercise-\thetcbcounter.tex}},
+ #1
+}
+
+\NewTotalTColorBox{\solution}{mm}{%
+ enhanced,colframe=red!20!black,colback=yellow!10!white,coltitle=red!40!black,
+ fonttitle=\bfseries,
+ underlay={\begin{tcbclipinterior}
+ \shade[inner color=red!50!yellow,outer color=yellow!10!white]
+ (interior.north west) circle (2cm);
+ \draw[help lines,step=5mm,yellow!80!black,shift={(interior.north west)}]
+ (interior.south west) grid (interior.north east);
+ \end{tcbclipinterior}},
+ title={Solution of Exercise~\ref{exercise@#1} on page~\pageref{exercise@#1}:},
+ phantomlabel={solution@#1},
+ attach title to upper=\par,
+}{\input{#2}}
+
+\tcbset{no solution/.style={no recording,after upper=}}
+\end{tcbverbatimwrite}
+\input{\jobname_preamble_L.tex}
+
+
%\tcbset{draftmode}
-%\includeonly{tcolorbox.doc.quickref}
+%\includeonly{tcolorbox.doc.listings}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}
@@ -339,6 +383,7 @@
\include{tcolorbox.doc.coreoptions}
\include{tcolorbox.doc.initoptions}
\include{tcolorbox.doc.verbatim}
+\include{tcolorbox.doc.recording}
\include{tcolorbox.doc.technical}
\include{tcolorbox.doc.skins}
\include{tcolorbox.doc.graphics}