diff options
author | Karl Berry <karl@freefriends.org> | 2014-12-16 23:10:42 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2014-12-16 23:10:42 +0000 |
commit | ad9e1b89835ba40880b3b5d0c153577ce2b5d1e3 (patch) | |
tree | 6cda0f4c755541a22fb2795297e9637e7f4951f8 /Master/texmf-dist/doc/latex/tcolorbox | |
parent | a01f81cc1fa81b449afcf1c77def8688146582d5 (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/CHANGES | 11 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/README | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf | bin | 361340 -> 361345 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex | 2 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex | 34 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex | 38 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex | 8 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf | bin | 5195793 -> 5200862 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex | 11 |
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 Binary files differindex 657c6a12c8a..7c5b9f3993d 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 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 Binary files differindex c1a0def7ca9..9dded7a78a4 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 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} |