summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-12-16 23:10:42 +0000
committerKarl Berry <karl@freefriends.org>2014-12-16 23:10:42 +0000
commitad9e1b89835ba40880b3b5d0c153577ce2b5d1e3 (patch)
tree6cda0f4c755541a22fb2795297e9637e7f4951f8 /Master/texmf-dist/doc/latex/tcolorbox
parenta01f81cc1fa81b449afcf1c77def8688146582d5 (diff)
tcolorbox (16dec14)
git-svn-id: svn://tug.org/texlive/trunk@35843 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES11
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin361340 -> 361345 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex34
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex38
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex8
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin5195793 -> 5200862 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex11
9 files changed, 73 insertions, 33 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 90cbe5be46e..ef960985516 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.33 (2014/12/11)
+%% The LaTeX package tcolorbox - version 3.34 (2014/12/16)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2014 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -691,3 +691,12 @@ version 3.33 (2014/12/11)
unbreakable boxes. Use the new option 'ignore nobreak' to restore the old
behavior.
- vertical skip of two successive tcbraster environments fixed
+
+version 3.34 (2014/12/16)
+- 'height fill' now fills gapless and can be overruled by other height options
+- 'before skip' and 'after skip' accept glue values now
+- library 'breakable':
+ * new option 'compress page':
+ Use the new option 'compress page=none' to restore the old behavior.
+- library 'raster':
+ * 'raster before skip' and 'raster after skip' accept glue values now
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index 04958c4bbfa..71f6f0d7eb8 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.33 (2014/12/11)
+%% The LaTeX package tcolorbox - version 3.34 (2014/12/16)
%%
%% -------------------------------------------------------------------------------------------
%% 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 657c6a12c8a..7c5b9f3993d 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 3826fc0b4f3..404a9c99125 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.33 (2014/12/11)
+%% The LaTeX package tcolorbox - version 3.34 (2014/12/16)
%% tcolorbox-example.tex: an example for tcolorbox
%%
%% -------------------------------------------------------------------------------------------
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 50ff63e5488..792e342bce4 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
@@ -254,6 +254,28 @@ The |break at| option can be used to insert better break points by hand.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-12-15]{compress page}{\colOpt{=\meta{option}}}{default |all|, initially |baselineskip|}
+ This option controls the space management on the page which contains the
+ unbroken box or the first part of a \emph{break sequence}.
+ Feasible \meta{option} values are:
+ \begin{itemize}
+ \item\docValue{all} (default value):
+ All shrinkable glue on the page is potentially used for the
+ unbroken box or the first part of a \emph{break sequence}. Thus, all
+ vertical spaces on the page will potentially be reduced to their
+ minimal values.
+ \item\docValue{baselineskip} (initial value):
+ Shrinkable glue up to one |\baselineskip| on the page is potentially used for the
+ unbroken box or the first part of a \emph{break sequence}.
+ \item\docValue{none}:
+ The break algorithm respects the target size of the given glue values
+ on the page. This was the inital value before version |3.34|.
+ \end{itemize}
+ \begin{marker}
+ Note that the box \emph{content} is not influenced by this option.
+ \end{marker}
+\end{docTcbKey}
+
\begin{docTcbKey}{shrink break goal}{=\meta{length}}{no default, initially |0pt|}
This is an emergency parameter if the break algorithm produces unpleasant
@@ -322,23 +344,23 @@ The |break at| option can be used to insert better break points by hand.
and \refKey{/tcb/pad after break}.
\end{docTcbKey}
+\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{dispListing}
% \usepackage{lipsum} % preamble
\tcbset{colback=red!5!white,colframe=red!75!black,fonttitle=\bfseries}
-\begin{tcolorbox}[enhanced jigsaw,breakable,pad at break=0mm,
+\begin{tcolorbox}[enhanced jigsaw,breakable,pad at break*=0mm,
title={For this box, the pad space at the break point is set to 0mm}]
\lipsum[1-2]
\end{tcolorbox}
\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*}
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 0600d0b753e..100731ddbd9 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -1280,11 +1280,13 @@ This is a \textbf{tcolorbox} where the text area has a height of 2cm.
\end{docTcbKey}
-\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|
+\begin{docTcbKey}[][doc new and updated={2014-09-22}{2014-12-15}]{height fill}{\colOpt{=true\textbar false\textbar maximum}}{default |true|, initially |false|}
+If set to \docValue*{true}, the height of the |tcolorbox| is set to the rest of the
+available vertical space of the current page.
+If set to \docValue{maximum}, the page is compressed as much as possible.
+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.
+%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}
@@ -1988,7 +1990,7 @@ This is the lower part.
\end{docTcbKey}
-\begin{dispListing*}{breakable,before upper={This example demonstrates
+\begin{dispListing*}{breakable,vfill before first,before upper={This example demonstrates
the application of break sequence specific overlay options.
Here, we define an environment |myexample| based
on |tcolorbox| where the visible drawing is done totally by overlay keys.\par
@@ -2012,7 +2014,7 @@ are drawn by the codes given with
([yshift=-1pt]frame.north west)--([yshift=-1pt]frame.north east);}},
coltitle=colexam,fonttitle=\Large\bfseries,
before=\par\medskip\noindent,parbox=false,boxsep=0pt,left=0pt,right=3mm,top=4pt,
- breakable,pad at break=0mm,
+ breakable,pad at break*=0mm,vfill before first,
overlay unbroken={\draw[colexam,line width=1pt]
([yshift=-1pt]title.north east)--([xshift=-0.5pt,yshift=-1pt]title.north-|frame.east)
--([xshift=-0.5pt]frame.south east)--(frame.south west); },
@@ -2403,8 +2405,8 @@ Some text\dotfill
\end{docTcbKey}
-\begin{docTcbKey}[][doc new and updated={2014-10-10}{2014-11-07}]{before skip}{=\meta{length}}{style, no default}
- Inserts some vertical space of the given \meta{length} before the colored box.
+\begin{docTcbKey}[][doc new and updated={2014-10-10}{2014-12-16}]{before skip}{=\meta{glue}}{style, no default}
+ Inserts some vertical space of the given \meta{glue} before the colored box.
This style sets \refKey{/tcb/before}.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
Some text.
@@ -2415,8 +2417,8 @@ Some text.
\end{dispExample*}
\end{docTcbKey}
-\begin{docTcbKey}[][doc new and updated={2014-10-10}{2014-11-07}]{after skip}{=\meta{length}}{style, no default}
- Inserts some vertical space of the given \meta{length} after the colored box.
+\begin{docTcbKey}[][doc new and updated={2014-10-10}{2014-12-16}]{after skip}{=\meta{glue}}{style, no default}
+ Inserts some vertical space of the given \meta{glue} after the colored box.
This style sets \refKey{/tcb/after}.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
\begin{tcolorbox}[after skip=1cm,
@@ -2427,8 +2429,8 @@ Some text.
\end{dispExample*}
\end{docTcbKey}
-\begin{docTcbKey}[][doc new=2014-10-10]{beforeafter skip}{=\meta{length}}{style, no default}
- Inserts some vertical space of the given \meta{length} before \emph{and} after the colored box.
+\begin{docTcbKey}[][doc new=2014-10-10]{beforeafter skip}{=\meta{glue}}{style, no default}
+ Inserts some vertical space of the given \meta{glue} before \emph{and} after the colored box.
This style sets \refKey{/tcb/before} and \refKey{/tcb/after}.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
\tcbset{beforeafter skip=0pt,
@@ -2489,16 +2491,22 @@ Some text.
\begin{docTcbKey}[][doc new=2014-12-11]{ignore nobreak}{\colOpt{=true\textbar false}}{default |true|, initially |false|}
After a heading, \LaTeX\ tries to avoid a break by setting a |nobreak| boolean value.
Starting from version |3.33|, the \refKey{/tcb/before} respectively \refKey{/tcb/before skip}
-settings are not used after a heading, if \refKey{/tcb/ignore nobreak} is
-set to \docValue{false}. Further, a \refKey{/tcb/breakable} box will also try to
+settings are not used after a heading if \refKey{/tcb/ignore nobreak} is
+set to \docValue{false}. For an unbreakable box, \refKey{/tcb/before nobreak} is used instead.
+Further, a \refKey{/tcb/breakable} box will also try to
avoid a break between a heading and a directly following first part of a
break sequence.
Set \refKey{/tcb/ignore nobreak} to \docValue{true}, if |nobreak| should be
-ignored as prior to version |3.33|. Also, this setting may be used locally to
+ignored as prior to version |3.33|. Also, such a setting may be used locally to
enforce the \refKey{/tcb/before} setting.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2014-12-16]{before nobreak}{=\meta{code}}{no default, initially \cs{noindent}}
+ Sets the \meta{code} which is executed before the colored box if it
+ is unbreakable, if \refKey{/tcb/ignore nobreak} is not set, and if
+ the box follows a heading.
+\end{docTcbKey}
\clearpage
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 49a2911da29..7a3264583c2 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
@@ -246,13 +246,13 @@ If \refKey{/tcb/fit} should be used, turn over to \refEnv{tcbraster}.
\end{docTcbKey}
-\begin{docTcbKey}[][doc new=2014-11-10]{raster before skip}{=\meta{length}}{no default, initially |2mm|}
- Space of the given \meta{length} is inserted vertically before the \emph{raster}.
+\begin{docTcbKey}[][doc new and updated={2014-11-10}{2014-12-16}]{raster before skip}{=\meta{glue}}{no default, initially |2mm|}
+ Space of the given \meta{glue} is inserted vertically before the \emph{raster}.
This space is discardable.
\end{docTcbKey}
-\begin{docTcbKey}[][doc new=2014-11-10]{raster after skip}{=\meta{length}}{no default, initially |2mm|}
- Space of the given \meta{length} is inserted vertically after the \emph{raster}.
+\begin{docTcbKey}[][doc new and updated={2014-11-10}{2014-12-16}]{raster after skip}{=\meta{glue}}{no default, initially |2mm|}
+ Space of the given \meta{glue} is inserted vertically after the \emph{raster}.
This space is discardable.
\end{docTcbKey}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index c1a0def7ca9..9dded7a78a4 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 a0594ad9f26..a4a0f181bf4 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.33 (2014/12/11)
+%% The LaTeX package tcolorbox - version 3.34 (2014/12/16)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -34,7 +34,8 @@
\usepackage[a4paper,left=2.5cm,right=2.5cm,top=1.5cm,bottom=1.5cm,
marginparsep=3mm,marginparwidth=18mm,
headheight=0mm,headsep=0cm,
- footskip=1.5cm,includeheadfoot]{geometry}
+ footskip=1.5cm,includeheadfoot%,showframe
+ ]{geometry}
\usepackage{fancyhdr}
\fancyhf{}
\fancyfoot[C]{\thepage}%
@@ -106,8 +107,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.33}%
-\def\datum{2014/12/11}%
+\def\version{3.34}%
+\def\datum{2014/12/16}%
\makeindex
\hypersetup{
@@ -376,7 +377,7 @@
%\tcbset{draftmode}
-%\includeonly{tcolorbox.doc.quickref}
+%\includeonly{tcolorbox.doc.coreoptions}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}