summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-07-23 22:04:50 +0000
committerKarl Berry <karl@freefriends.org>2014-07-23 22:04:50 +0000
commitf3e14f60640da99c60f8a344d2ce48d6cab12b8c (patch)
tree1ae1ae4fb8f333f8874192c446fc426e8dafb61a /Master/texmf-dist/doc/latex/tcolorbox
parent858d2c9bc2f38514b4e7e4ab15d64291bd4e2e85 (diff)
tcolorbox (22jul14)
git-svn-id: svn://tug.org/texlive/trunk@34701 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/README14
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/blueshade.pngbin62882 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.pngbin21663 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/goldshade.pngbin76829 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/pink_marble.pngbin15166 -> 0 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin361329 -> 361338 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib12
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex229
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex105
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex20
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin4326972 -> 4415449 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex9
14 files changed, 383 insertions, 36 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 520bd9032f7..3df400c361b 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.05 (2014/05/28)
+%% The LaTeX package tcolorbox - version 3.10 (2014/07/23)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -545,3 +545,29 @@ version 3.05 (2014/05/28)
* new options:
'lifted shadow', 'drop small lifted shadow', 'drop lifted shadow', 'drop large lifted shadow'
+version 3.10 (2014/07/23)
+- box breaking algorithm revised:
+ * breakable boxes now always have \noindent
+ * distance to preceeding text corrected
+ * interaction with floating objects fixed
+ * dimensioning of partial boxes improved
+ * splitting of an empty closing frame can now be avoided (depending on 'pad at break*')
+ * The upper total height limit for breakable boxes is extended from
+ about 16384pt to about 65536pt
+ * experimental code added (breakable=unlimited) for breakable boxes
+ without height limit besides memory
+ * splitting boxes inside multicols environments supported (to a certain degree)
+ * limited orphan control added ('enlargepage flexible')
+- library 'breakable':
+ * new options:
+ 'break at', 'height fixed for', 'enlargepage flexible',
+ 'pad before break*', 'pad at break*'
+- Corners can be set individually now to be 'rounded' or 'sharp'
+ for all types of boxes, skins, borders, and shadows:
+ * new options: 'sharpish corners', 'sharp corners', and 'rounded corners'
+- library 'skins':
+ * new options: '\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
+
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index 0eb00c4bbde..f5ce25658ab 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.05 (2014/05/28)
+%% The LaTeX package tcolorbox - version 3.10 (2014/07/23)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -41,6 +41,10 @@ Contents of the package
'tcbskinsjigsaw.code.tex' LaTeX package file (library of tcolorbox)
'tcbtheorems.code.tex' LaTeX package file (library of tcolorbox)
'tcbxparse.code.tex' LaTeX package file (library of tcolorbox)
+ 'blueshade.png' Picture (package)
+ 'crinklepaper.png' Picture (package)
+ 'goldshade.png' Picture (package)
+ 'pink_marble.png' Picture (package)
'tcolorbox.pdf' Documentation for tcolorbox
'tcolorbox.tex' Source code of the documentation (main file)
'*.doc.*' Source code of the documentation (include files)
@@ -48,10 +52,6 @@ Contents of the package
'tcolorbox-example.pdf' Compiled example
'Basilica_5.png' Example picture
'lichtspiel.jpg' Example picture
- 'blueshade.png' Example picture
- 'crinklepaper.png' Example picture
- 'goldshade.png' Example picture
- 'pink_marble.png' Example picture
Installation
============
@@ -71,4 +71,8 @@ Alternatively, put the files to their respective locations within the TeX instal
'tcbskins.code.tex' -> /tex/latex/tcolorbox
'tcbskinsjigsaw.code.tex' -> /tex/latex/tcolorbox
'tcbxparse.code.tex' -> /tex/latex/tcolorbox
+ 'blueshade.png' -> /tex/latex/tcolorbox
+ 'crinklepaper.png' -> /tex/latex/tcolorbox
+ 'goldshade.png' -> /tex/latex/tcolorbox
+ 'pink_marble.png' -> /tex/latex/tcolorbox
all other files -> /doc/latex/tcolorbox
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png b/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png
deleted file mode 100644
index 4b1713e657c..00000000000
--- a/Master/texmf-dist/doc/latex/tcolorbox/blueshade.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png b/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png
deleted file mode 100644
index c030edf7656..00000000000
--- a/Master/texmf-dist/doc/latex/tcolorbox/crinklepaper.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png b/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png
deleted file mode 100644
index 7e082640532..00000000000
--- a/Master/texmf-dist/doc/latex/tcolorbox/goldshade.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png b/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png
deleted file mode 100644
index d3279dff5cf..00000000000
--- a/Master/texmf-dist/doc/latex/tcolorbox/pink_marble.png
+++ /dev/null
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
index 77df64b9536..b89f20d0ce0 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 18a1561d335..ec44e30328d 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.05 (2014/05/28)
+%% The LaTeX package tcolorbox - version 3.10 (2014/07/23)
%% tcolorbox-example.tex: an example for tcolorbox
%%
%% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib
index 181e662040b..32fa8379ece 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.bib
@@ -177,3 +177,15 @@
}
+@manual{mittelbach:2014a,
+ author = {Frank Mittelbach},
+ title = {An environment for multicolumn output},
+ url = {http://mirror.ctan.org/macros/latex/required/tools/multicol.pdf},
+ Xnote = {},
+ day = 21,
+ month = jun,
+ year = 2014,
+ language = {english}
+}
+
+
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 ba0467b34c1..baf13947484 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
@@ -83,9 +83,19 @@ parameters. The differences are:
\subsection{Limitations and Known Bugs}
\begin{itemize}
-\item The box content is a \TeX\ |\vbox| register which has a
- restricted capacity. Therefore, you cannot place hundreds of pages
- inside a |tcolorbox|.
+\item The maximal total height of the upper and of the lower part
+ of normal breakable |tcolorbox|es is about 65536pt (ca.\,2300cm)
+ apiece. If such a part gets longer, the output will get buggy
+ without warning.
+ For very oversized boxes which are longer than 65536pt, use
+ the \docValue{unlimited} value for \refKey{/tcb/breakable}.
+ With the \docValue{unlimited} setting,
+ the applied algorithm has (virtually) no height limit for boxes, but
+ very likely the compiler memory will have to be increased for boxes longer
+ than 300 pages (depending on compiler settings and box content).
+ But it is recommended to use \docValue{unlimited} for critical large boxes only,
+ since there \emph{may} be a single interline space deviation (lost glue) around
+ every 2300cm, e.\,g.\ a \refCom{tcbline*} \emph{may} get lost.
\item You can nest an unbreakable |tcolorbox| inside another |tcolorbox|,
even inside a breakable one.
But you cannot not nest a breakable box inside a breakable box.
@@ -105,7 +115,7 @@ parameters. The differences are:
\clearpage
\subsection{Main Option Keys}
-\begin{docTcbKey}{breakable}{\colOpt{=true\textbar false}}{default |true|, initially |false|}
+\begin{docTcbKey}{breakable}{\colOpt{=true\textbar false\textbar unlimited}}{default |true|, initially |false|}
Allows the |tcolorbox| to be breakable. If the box is larger than the
available space at the current page, the box is automatically broken
and continued to the next next page. All sorts of |tcolorbox| can be made
@@ -113,16 +123,27 @@ parameters. The differences are:
If you do not know better, use \refKey{/tcb/enhanced} for breaking a box.
The parts of the \emph{break sequence} are numbered
by the counter |tcbbreakpart|.
- \begin{dispListing}
- % \usepackage{lipsum} % preamble
- \tcbset{enhanced jigsaw,colback=red!5!white,colframe=red!75!black,
- watermark color=yellow!25!white,watermark text=\arabic{tcbbreakpart},
- fonttitle=\bfseries}
-
- \begin{tcolorbox}[breakable,title=My breakable box]
- \lipsum[1-6]
- \end{tcolorbox}
- \end{dispListing}
+ \begin{itemize}
+ \item\docValue{false}: Sets the |tcolorbox| to be unbreakable.
+ \item\docValue{true}: Breaks the |tcolorbox| from one page to another.
+ The maximal total height of the upper and of the lower part is
+ about 65536pt (ca.\,2300cm or ca.\,90 pages) apiece.
+ \item\docValue{unlimited}: Experimental code for unlimited total height of
+ breakable boxes. There \emph{may} be a single interline space deviation (lost glue) around
+ every 2300cm. For boxes longer than 300 pages (or even shorter ones) the
+ compiler memory will have to be increased.
+ \end{itemize}
+
+\begin{dispListing}
+% \usepackage{lipsum} % preamble
+\tcbset{enhanced jigsaw,colback=red!5!white,colframe=red!75!black,
+ watermark color=yellow!25!white,watermark text=\arabic{tcbbreakpart},
+ fonttitle=\bfseries}
+
+\begin{tcolorbox}[breakable,title=My breakable box]
+\lipsum[1-6]
+\end{tcolorbox}
+\end{dispListing}
\end{docTcbKey}
{\tcbusetemp}
@@ -166,7 +187,34 @@ parameters. The differences are:
\end{docTcbKey}
\clearpage
-\begin{docTcbKey}{enlargepage}{=\meta{length}\colOpt{/\meta{length}\ldots/\meta{length}}}{no default, initially |0pt|}
+\begin{docTcbKey}{break at}{=\meta{length}\colOpt{/\meta{length}/\ldots/\meta{length}}}{no default, initially |0pt|}
+ Defines break points at the given \meta{length} values.
+ The first \meta{length} defines the (maximal) height of the first partial box,
+ the second \meta{length} defines the (maximal) height of the second partial box,
+ and so on. The last \meta{length} value is applied to all following partial boxes if any.
+ Setting a length to |0pt| means that the naturally available space is used
+ for breaking.
+\begin{dispExample}
+% \usepackage{multicol,lipsum}
+\begin{multicols}{3}\footnotesize
+Breakable boxes inside a |multicols| environment need special attendance.
+They are broken by default at |\textheight|.
+The |break at| option can be used to insert better break points by hand.
+\par\medskip
+\begin{tcolorbox}[enhanced jigsaw,size=small,before=\noindent,
+ colframe=red,colback=yellow!10!white,before title=\raggedright,
+ title={Broken box inside a |multicols| environment},fonttitle=\bfseries,
+ enforce breakable,% use only breakable in the real world!
+ pad at break=1mm,break at=3cm/6.3cm ]
+\lipsum[1]
+\end{tcolorbox}
+\refKey{/tcb/height fixed for} may also be considered for |multicols| environments.
+\end{multicols}
+\end{dispExample}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{enlargepage}{=\meta{length}\colOpt{/\meta{length}/\ldots/\meta{length}}}{no default, initially |0pt|}
Inserts a |\enlargethispage|\marg{length} to the pages of the break sequence,
i.\,e.\ allows one to enlarge (or shrink) partial boxes. The first \meta{length} is applied
to the first partial box, the second \meta{length} is applied
@@ -186,11 +234,30 @@ parameters. The differences are:
\end{marker}
\end{docTcbKey}
+\clearpage
+\begin{docTcbKey}{enlargepage flexible}{=\meta{length}}{no default, initially |0pt|}
+ This allows an automated page enlargement for up to \meta{length}.
+ The algorithm can use this to avoid breaking a box, if there is anough room
+ after enlargement. Also, the \emph{last} partial box of a break sequence
+ may be enlarged to avoid further breaking.\\
+ Note that this potential enlargement is \emph{additive} to settings of
+ \refKey{/tcb/enlargepage}.
+ But \refKey{/tcb/enlargepage flexible} overwrites settings of
+ \refKey{/tcb/pad before break*} or \refKey{/tcb/pad at break*}.
+\begin{dispListing}
+% The following setting hinders orphan lines for the last partial box
+\tcbset{enlargepage flexible=\baselineskip}
+\end{dispListing}
+\end{docTcbKey}
+
+
\begin{docTcbKey}{shrink break goal}{=\meta{length}}{no default, initially |0pt|}
This is an emergency parameter if the break algorithm produces unpleasant
- breaks. It shrinks the goal height of the current box part by \meta{length}
+ breaks.
+ It shrinks the goal height of the current box part by \meta{length}
which may result in smaller boxes. Never use negative values.
+ \emph{Usually, this option will never be needed at all.}
\end{docTcbKey}
@@ -213,8 +280,6 @@ parameters. The differences are:
\end{docTcbKey}
-
-
\begin{docTcbKey}{topsep at break}{=\meta{length}}{no default, initially \texttt{0mm}}
Additional vertical space of \meta{length} which is added at the top of
\emph{middle} and \emph{last} parts in a break sequence. In general,
@@ -235,6 +300,12 @@ parameters. The differences are:
\emph{middle} and \emph{last} parts in a break sequence start with a rule or a title.
\end{docTcbKey}
+\begin{docTcbKey}{pad before break*}{=\meta{length}}{style, no default}
+ Sets \refKey{/tcb/pad before break} to \meta{length} and
+ \refKey{/tcb/enlargepage flexible} to an appropriate value such that
+ empty closing frames are avoided.
+\end{docTcbKey}
+
\begin{docTcbKey}{pad after break}{=\meta{length}}{style, no default, initially \texttt{3.5mm}}
Sets the total amount of vertical space after the break point and before the
text content to \meta{length}. This style sets \refKey{/tcb/bottomrule at break} to |0pt|
@@ -260,6 +331,18 @@ parameters. The differences are:
\end{dispListing}
{\tcbusetemp}
+\begin{docTcbKey}{pad at break*}{=\meta{length}}{style, no default}
+ Sets \refKey{/tcb/pad at break} to \meta{length} and
+ \refKey{/tcb/enlargepage flexible} to an appropriate value such that
+ empty closing frames are avoided.
+\end{docTcbKey}
+
+\begin{marker}
+\refKey{/tcb/pad at break} or \refKey{/tcb/pad at break*}
+should be used as very last option in an option list, because
+they adapt other settings.
+\end{marker}
+
\begin{marker}
Also see \refKey{/tcb/enlarge top at break by}
@@ -267,6 +350,109 @@ and \refKey{/tcb/enlarge bottom at break by}.
\end{marker}
+\begin{docTcbKey}{height fixed for}{=\meta{part}}{no default, initially |none|}
+ When certain amount of space is available for a partial box of a
+ break sequence, the partial box typically is smaller than this space
+ (depending on the box content). For given \meta{part}(s), the height can be
+ set to all available space.
+ \begin{itemize}
+ \item\docValue{none}: Every partial |tcolorbox| is set with its natural height.
+ \item\docValue{first}: The \emph{first} partial box is set to a height which matches the available space.
+ \item\docValue{middle}: All \emph{middle} partial boxes are set to a height which matches the available space.
+ \item\docValue{last}: The \emph{last} partial box is set to a height which matches
+ the available space.
+ \item\docValue{first and middle}: The \emph{first} and
+ all \emph{middle} partial boxes are set to a height which matches the available space.
+ \item\docValue{middle and last}: All \emph{middle} partial boxes and the \emph{last} partial box
+ are set to a height which matches the available space.
+ \item\docValue{all}: All partial boxes are set to a height which matches the available space.
+ \end{itemize}
+\begin{marker}
+ If the box keeps unbroken, this option is not applied.
+ See \refKey{/tcb/height} for setting a fixed height for unbroken boxes.
+\end{marker}
+\end{docTcbKey}
+
+
+\clearpage
+\subsection{Breakable boxes and the \texttt{multicol} package}\label{subsec:multicol}
+\begin{multicols}{2}
+\begin{tcolorbox}[enhanced jigsaw,size=small,breakable,colback=yellow!10!white,
+ colframe=red!50!white,break at=3cm,height fixed for=all]
+Unbreakable |tcolorbox|es can be used without special care inside a
+|multicols| environment from the |multicol| package \cite{mittelbach:2014a}.
+
+Since version 3.10, a breakable |tcolorbox| detects, if it is used inside
+a |multicols| environment. But choosing break points for a breakable box
+cannot be done by the balancing routine of |multicols|. By default, boxes
+will break at |\textheight|. To get pleasant results, use the
+\refKey{/tcb/break at} and \refKey{/tcb/height fixed for} options.
+\end{tcolorbox}
+\end{multicols}
+
+\enlargethispage{\baselineskip}
+\begin{dispListing}
+% \usepackage{lipsum,multicol} % preamble
+\small
+\begin{multicols}{2}
+ \lipsum[1]
+ \begin{tcolorbox}[enhanced jigsaw,breakable,size=title,
+ colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
+ title=My breakable box,pad at break=1mm, break at=7.5cm/0pt ]
+ \lipsum[2-4]
+ \end{tcolorbox}
+ \lipsum[4]
+\end{multicols}
+\end{dispListing}
+{\tcbusetemp}
+
+\clearpage
+
+\begin{multicols}{2}
+\small
+This example is already set inside a |multicols| environment.
+This time, a \emph{middle} part has full |\textheight|.
+\refKey{/tcb/height fixed for} is used to spread this box part over the full
+height toi align with neighboring columns.
+\begin{dispListing}
+% \usepackage{lipsum,multicol}
+\lipsum[1]
+\begin{tcolorbox}[enhanced jigsaw,breakable,
+ size=title,
+ colback=red!5!white,
+ colframe=red!75!black,
+ fonttitle=\bfseries,
+ title=My breakable box,
+ pad at break=2mm,
+ break at=8.2cm/0pt,
+ height fixed for=middle ]
+\lipsum[2-7]
+\end{tcolorbox}
+\lipsum[8]
+\end{dispListing}
+{\tcbusetemp}
+\end{multicols}
+
+
+The following example has a |\tcolorbox| which fills the |\multicols|
+environment completely. Here, \refKey{/tcb/height fixed for} is used
+to give all three columns the full height.
+Note that the appropriate \refKey{/tcb/break at} value is not computed
+automatically but set manually.
+
+\begin{dispListing}
+% \usepackage{lipsum,multicol} % preamble
+\small
+\begin{multicols}{3}
+ \begin{tcolorbox}[enhanced jigsaw,breakable,size=small,
+ colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries,
+ title=My breakable box,pad at break=2mm,drop fuzzy shadow,
+ height fixed for=all, break at=11.4cm ]
+ \lipsum[1-3]
+ \end{tcolorbox}
+\end{multicols}
+\end{dispListing}
+{\tcbusetemp}
\clearpage
@@ -338,8 +524,15 @@ the \emph{break sequence} parts are displayed.
\tcbbreakskininto{freelancelast}{freelancemiddle}{freelancemiddle}{freelancelast}{}
+
+
\clearpage
\subsection{Break by Hand (Faked Break)}
+
+\begin{marker}
+See \Vref{subsec:multicol} for \emph{real} column breaks.
+\end{marker}
+
Since the appearance of broken boxes is done by skins, it is quite easy
to 'fake a break'. For this, you actually don't need the
\mylib{breakable} library at
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 1c818f96b02..7b27f9d791f 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -824,6 +824,111 @@ with help of an overlay.
\tcbusetemp
\end{docTcbKey}
+\clearpage
+\subsection{Corners}\label{subsec:corners}
+
+The four corners of any |tcolorbox| can be set individually as
+\refKey{/tcb/sharp corners} or as \refKey{/tcb/rounded corners}.
+These settings are also reflected in the behavior of \refKey{/tcb/borderline}
+and \refKey{/tcb/shadow} as one would expect.
+
+By default, all four corners are \emph{rounded}. So, only the
+\refKey{/tcb/sharp corners} option will be necessary for most use cases.
+The \refKey{/tcb/rounded corners} option can be used to revert a \refKey{/tcb/sharp corners}
+setting.
+
+\begin{docTcbKey}{sharp corners}{=\meta{position}}{default |all|, initially unset}
+The \meta{position} denotes one or more of the four box corners to be set as
+\emph{sharp} corners. The not assigned corners will retain their mode.
+Feasible values for \meta{position} are:
+\begin{itemize}
+\foreach \p in {northwest,northeast,southwest,southeast,north,south,east,west,downhill,uphill,all}
+{
+\item\tcbox[on line,size=title,arc=2mm,colframe=red!75!black,colback=red!5!white,
+ enlarge top by=0.5mm,enlarge bottom by=0.5mm,sharp corners=\p]{\docValue{\p}}
+}
+\end{itemize}
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[colback=red!5!white,
+ colframe=red!75!black,
+ sharp corners=northwest ]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[colback=red!5!white,
+ colframe=red!75!black,
+ sharp corners ]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\clearpage
+\begin{docTcbKey}{rounded corners}{=\meta{position}}{default |all|, initially |all|}
+The \refKey{/tcb/rounded corners} can be used to revert a \refKey{/tcb/sharp corners}
+setting. The \meta{position} denotes one or more of the four box corners to be set as
+\emph{rounded} corners. The not assigned corners will retain their mode.
+Feasible values for \meta{position} are\footnote{The graphical examples assume
+ that the boxes where set to have sharp corners before.}:
+\begin{itemize}
+\foreach \p in {northwest,northeast,southwest,southeast,north,south,east,west,downhill,uphill,all}
+{
+\item\tcbox[on line,size=title,arc=2mm,colframe=red!75!black,colback=red!5!white,
+ enlarge top by=0.5mm,enlarge bottom by=0.5mm,sharp corners,rounded corners=\p]{\docValue{\p}}
+}
+\end{itemize}
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[colback=red!5!white,
+ colframe=red!75!black,sharp corners,
+ rounded corners=northwest ]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+\begin{docTcbKey}{sharpish corners}{}{style, no value}
+ Shortcut for setting \refKey{/tcb/arc} and \refKey{/tcb/outer arc}
+ to |0pt|. With this setting, rounded corners will appear als quasi-sharp,
+ but e.\,g.\ the shadow will be somewhat rounder than the shadow
+ of really sharp corners.
+ \begin{marker}
+ Corners are still of type \emph{rounded} with this option, but appear
+ \emph{sharp}. To switch back to rounded corners, one has to adapt
+ \refKey{/tcb/arc} and \refKey{/tcb/outer arc}.
+ \end{marker}
+\begin{dispExample*}{sbs,lefthand ratio=0.6}
+\begin{tcolorbox}[colback=red!5!white,
+ colframe=red!75!black,
+ sharpish corners ]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{dispExample*}
+\end{docTcbKey}
+
+\clearpage
+
+The following examples will show the differences between
+\refKey{/tcb/rounded corners}, \refKey{/tcb/sharpish corners}, and \refKey{/tcb/sharp corners}.
+The later two give the same core box, but \refKey{/tcb/borderline}
+and \refKey{/tcb/shadow} settings are slightly different.
+The following examples use \refKey{/tcb/drop fuzzy shadow}.
+
+\foreach \n in {rounded corners,sharpish corners,sharp corners}{
+\begin{tcolorbox}[enhanced jigsaw,frame empty,interior empty,fuzzy halo,center upper]
+\begin{tcolorbox}[enhanced,drop fuzzy shadow,width=\linewidth-1cm,
+ colback=red!5!white, colframe=red!75!black, fonttitle=\bfseries,
+ title=My title,\n,
+ tikz={spy using outlines={circle, magnification=8, size=2cm, connect spies}},
+ overlay={\spy [blue, size=4cm] on (frame.south east)
+ in node at ([xshift=-2.5cm,yshift=-2.5cm]frame.south east);
+ \node[right] at ([xshift=2cm,yshift=-1cm]frame.south west) {\textbf{\Large\ttfamily\n}};
+ }]
+This is a \textbf{tcolorbox}.
+\end{tcolorbox}
+\end{tcolorbox}}
+
\clearpage
\subsection{Transparency}
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 c7830b43597..e3eaa60fd02 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex
@@ -1229,21 +1229,21 @@ This can be used to apply different effects.
Note that the \tikzname\ |line width| option should not be used here.\\
The border lines adapt to the rounded corners of the |tcolorbox|. An inside border
line will switch to sharp corners if necessary, an outside border line will
- always be rounded if not set to |sharp corners|.
+ always be rounded except for \refKey{/tcb/sharp corners}.
\begin{dispExample}
\begin{tcolorbox}[enhanced,title=Rounded corners,fonttitle=\bfseries,boxsep=5pt,
arc=8pt,
borderline={0.5pt}{0pt}{red},
borderline={0.5pt}{5pt}{blue,dotted},
- borderline={0.5pt}{-5pt}{green,dashed} ]
+ borderline={0.5pt}{-5pt}{green} ]
This is a tcolorbox.
\end{tcolorbox}
\bigskip
\begin{tcolorbox}[enhanced,title=Sharp corners,fonttitle=\bfseries,boxsep=5pt,
- arc=0pt,outer arc=0pt,
+ arc=8pt,sharp corners=downhill,
borderline={0.5pt}{0pt}{red},
borderline={0.5pt}{5pt}{blue,dotted},
- borderline={0.5pt}{-5pt}{green,dashed,sharp corners} ]
+ borderline={0.5pt}{-5pt}{green} ]
This is a tcolorbox.
\end{tcolorbox}
\end{dispExample}
@@ -1352,7 +1352,8 @@ used on the same |tcolorbox|. They are drawn \emph{before} the box frame is draw
The shadow is filled along a \tikzname\ path with the given \tikzname\ \meta{options}.\\
The shadows adapt to the rounded corners of the |tcolorbox|. An shrinked shadow
will switch to sharp corners if necessary, an enlarged shadow may become
- more rounded depending on several factors.
+ more rounded depending on several factors. But \refKey{/tcb/sharp corners}
+ have sharp shadows.
\begin{marker}
Shadows are not considered for the bounding box computation by default.
Large shadows may be overlaped by the following content. But, the
@@ -1784,7 +1785,7 @@ This is a tcolorbox.
Optionally, the \meta{color} for the shadow can be changed.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
\tcbset{enhanced,colback=red!5!white,
- boxrule=0.4pt,arc=0pt,outer arc=0pt,
+ boxrule=0.4pt,sharp corners,
colframe=red!75!black,fonttitle=\bfseries}
\begin{tcolorbox}[drop lifted shadow]
@@ -1803,7 +1804,7 @@ This is a tcolorbox.
Optionally, the \meta{color} for the shadow can be changed.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
\tcbset{enhanced,colback=red!5!white,
- boxrule=0.4pt,arc=0pt,outer arc=0pt,
+ boxrule=0.4pt,sharp corners,
colframe=red!75!black,fonttitle=\bfseries}
\tcbox[drop small lifted shadow,size=fbox]
@@ -2652,6 +2653,11 @@ Of course, skins can be used for listings also.
\end{dispExample}
\end{docCommand}
+\begin{docCommand}{tcbline*}{}
+ Equivalent to \refCom{tcbline}, but in a breakable box, \refCom{tcbline*}
+ is removed if at a page/box break. Also, it is removed at the end
+ of a box.
+\end{docCommand}
\clearpage
\begin{docSkin}{enhancedfirst}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index 298363bc1a5..734b420dbdc 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 dfb3185c97b..a9863570323 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.05 (2014/05/28)
+%% The LaTeX package tcolorbox - version 3.10 (2014/07/23)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -55,6 +55,7 @@
\usetikzlibrary{shadings,shadows}
\usetikzlibrary{decorations.pathmorphing}
\usetikzlibrary{patterns}
+\usetikzlibrary{spy}
\usepackage{array,tabularx}
\usepackage{amsmath}
@@ -102,8 +103,8 @@
\newtcolorbox{marker}[1][]{marker,#1}
-\def\version{3.05}%
-\def\datum{2014/05/28}%
+\def\version{3.10}%
+\def\datum{2014/07/23}%
\makeindex
\hypersetup{
@@ -304,7 +305,7 @@
%\tcbset{draftmode}
-%\includeonly{tcolorbox.doc.abstract}
+%\includeonly{tcolorbox.doc.theorems}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%