summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2017-04-25 22:30:39 +0000
committerKarl Berry <karl@freefriends.org>2017-04-25 22:30:39 +0000
commit9741d3a7175522e2552f723f0b90859d92af3991 (patch)
tree50bed5383f6af14bea61dac0551e780ffafdd63f /Master/texmf-dist/doc/latex/tcolorbox
parent680e000f5a53e51965eb20aab3f3db3a020bac69 (diff)
tcolorbox (25apr17)
git-svn-id: svn://tug.org/texlive/trunk@44046 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.pdfbin457620 -> 457620 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.tex15
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex33
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex64
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex22
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin6208618 -> 6318038 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex8
11 files changed, 148 insertions, 14 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 5ed38de8de0..47bcee9733d 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 4.02 (2017/02/24)
+%% The LaTeX package tcolorbox - version 4.03 (2017/04/25)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2017 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -982,4 +982,14 @@ version 4.02 (2017/02/24)
- bug fix: '/tcb/external/!' and '/tcb/external/-' were not usable inside \tcbset
- documentation optimizations
-
+version 4.03 (2017/04/25)
+- Implementation of 'raster equal height' changed to be more robust e.g. for loops
+- Implementation of several fill options like 'fill stretch image' changed
+ to be more efficient and to be independent from TikZ node positioning options.
+- Bug fix: 'fill plain image' and 'fill plain picture' ignored 'fill image opacity'.
+- new macro: '\tcbsegmentstate'
+- library 'breakable':
+ * new option: 'segmentation at break'
+- library 'documentation':
+ * new options: 'documentation minted language', 'keywords bold'
+- Creation of leaflets documented
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index 4907cd8e363..0906411d94f 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 4.02 (2017/02/24)
+%% The LaTeX package tcolorbox - version 4.03 (2017/04/25)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2017 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 e67688abc10..b547040c107 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 089344ebedb..9102e9f65ed 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 4.02 (2017/02/24)
+%% The LaTeX package tcolorbox - version 4.03 (2017/04/25)
%% 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 3c285d7c411..0f510f40aca 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
@@ -425,6 +425,21 @@ and \refKey{/tcb/enlarge bottom at break by}.
\end{docTcbKey}
+\begin{docTcbKey}[][doc new=2017-03-20]{segmentation at break}{\colOpt{=true\textbar false}}{default |true|, initially |true|}
+ If a breakable box contains an \emph{upper part} and a \emph{lower part} and
+ the break happens at the \emph{segmentation} between both parts, then
+ \begin{itemize}
+ \item the segmenation line (or similar) is drawn as first element of the
+ partial box containing the \emph{lower part}, if \refKey{/tcb/segmentation at break}
+ is set to be |true|.
+ \item the segmenation line (or similar) is not drawn at all, if
+ \refKey{/tcb/segmentation at break} is set to be |false|.
+ This may be preferable for skins like \refSkin{bicolor}, \refSkin{tile},
+ or \refSkin{beamer}.
+ \end{itemize}
+\end{docTcbKey}
+
+
\clearpage
\subsection{Extra Options for Partial Boxes}\label{subsec:extras}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
index 1f1495eedef..44e806d8f07 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex
@@ -512,6 +512,14 @@ with another note.
Used for \refKey{/tcb/listing engine}|=listings| only.
\end{docTcbKey}
+\begin{docTcbKey}{documentation minted options}{=\meta{minted style}}{no default,\\\hspace*{\fill} initially |tabsize=2,fontsize=\textbackslash small|}
+ Sets the options from the package |minted| \cite{poore:2015a}
+ which are used during typesetting of the listing, if used.
+ Note that this is not identical to the key
+ \refKey{/tcb/minted options} which is used for 'normal' listings.\\
+ Used for \refKey{/tcb/listing engine}|=minted| only.
+\end{docTcbKey}
+
\begin{docTcbKey}{documentation minted style}{=\meta{key list}}{no default, initially unset}
Sets a \meta{style} known to |Pygments| \cite{pygments:2013} for
the package |minted| \cite{poore:2015a}, if used.
@@ -520,14 +528,15 @@ with another note.
Used for \refKey{/tcb/listing engine}|=minted| only.
\end{docTcbKey}
-\begin{docTcbKey}{documentation minted options}{=\meta{minted style}}{no default,\\\hspace*{\fill} initially |tabsize=2,fontsize=\textbackslash small|}
- Sets the options from the package |minted| \cite{poore:2015a}
- which are used during typesetting of the listing, if used.
+\begin{docTcbKey}[][doc new=2017-04-24]{documentation minted language}{=\meta{programming language}}{no default, initially |latex|}
+ Sets a \meta{programming language} known to |Pygments| \cite{pygments:2013}
+ for the package |minted| \cite{poore:2015a}, if used.
Note that this is not identical to the key
- \refKey{/tcb/minted options} which is used for 'normal' listings.\\
+ \refKey{/tcb/minted language} which is used for 'normal' listings.\\
Used for \refKey{/tcb/listing engine}|=minted| only.
\end{docTcbKey}
+
\begin{marker}
The following two keys are deprecated and without function (v3.50 and above).
Use \refKey{/tcb/before} and \refKey{/tcb/after} with appropriate values
@@ -549,6 +558,22 @@ instead. Also see \refKey{/tcb/docexample}.
\end{docTcbKey}
\clearpage
+\begin{docTcbKey}[][doc new=2017-04-25]{keywords bold}{\colOpt{=true\textbar false}}{default |true|, initially |true|}
+ Keyword used in \refEnv{docEnvironment}, \refEnv{docCommand}, etc. are printed
+ boldface (or not). Since the typewriter font is used, the effect may be
+ invisible with Computer Modern fonts or similar which do not
+ have a bold variant. Note that references to keywords are not printed boldface at all.
+\begin{dispExample*}{sidebyside}
+\LARGE
+\docAuxCommand{fooaux}, \refCom{tcbset}
+
+\tcbset{keywords bold=false}
+\docAuxCommand{fooaux}, \refCom{tcbset}
+\end{dispExample*}
+\end{docTcbKey}
+
+
+
\begin{docTcbKey}[][doc new=2015-01-09]{index command}{=\meta{macro}}{no default, initially \cs{index}}
Replaces the internally used \cs{index} macro by the given \meta{macro}.
The \meta{macro} has to take one mandatory argument like \cs{index}.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex
index a7ad64842fd..433214c07fa 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.magazine.tex
@@ -432,6 +432,68 @@ Box width: \the\wd\mybox
\end{exdispExample}
\end{docCommand}
-
+\clearpage
+\subsection{Leaflet Example}
+The following full application example can be used to create leaflets.
+Obviously, the code can be adapted and customized in many ways.
+
+\begin{tcblisting}{
+ enhanced jigsaw,lower separated=false,breakable,
+ listing style=mydocumentation,base example,
+ listing and comment,
+ pdf comment,freeze pdf,
+ comment style={raster columns=1},
+ compilable listing,
+ run pdflatex}
+\documentclass[a4paper,landscape]{article}
+\usepackage[noheadfoot,margin=0pt]{geometry}
+\usepackage[skins,raster,magazine]{tcolorbox}
+\usepackage{lipsum}
+
+\newenvironment{leaflet}[1][]{%
+ \begin{tcolorbox}[nobeforeafter,empty,colback=white,
+ sharp corners,size=minimal,left=10mm,right=10mm,top=10mm,bottom=10mm,
+ width=\textwidth/3,
+ breakable,
+ break at=\textheight,
+ height fixed for=all,
+ reset box array,
+ store to box array,#1]}
+ {\end{tcolorbox}%
+ \begin{tcbitemize}[raster columns=3,raster equal skip=0pt,blankest]
+ \tcbitem\consumeboxarray{5}
+ \tcbitem\consumeboxarray{6}
+ \tcbitem\consumeboxarray{1}
+ \tcbitem\consumeboxarray{2}
+ \tcbitem\consumeboxarray{3}
+ \tcbitem\consumeboxarray{4}
+ \end{tcbitemize}%
+ }
+
+\pagestyle{empty}
+\begin{document}
+
+\begin{leaflet}[underlay={\node[above=5mm,font=\footnotesize]
+ at (frame.south) {- \arabic{tcbbreakpart} -};}]
+ \includegraphics[width=\linewidth]{Basilica_5.png}
+ \begin{center}
+ \bfseries\LARGE Example
+ \end{center}
+
+ \section{Introduction}
+ \lipsum[1]
+
+ \section{Main Part A}
+ \lipsum[2-8]
+
+ \section{Main Part B}
+ \lipsum[9-15]
+
+ \section{Conclusion}
+ \lipsum[16-18]
+\end{leaflet}
+
+\end{document}
+\end{tcblisting}
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 578552815ee..33a89411cf0 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.raster.tex
@@ -455,7 +455,7 @@ If \refKey{/tcb/fit} should be used, turn over to \refEnv{tcbraster}.
\clearpage
-\begin{docTcbKey}[][doc new=2014-11-10]{raster equal height}{=\meta{type}}{default \docValue{all}, initially \docValue{none}}
+\begin{docTcbKey}[][doc new and updated={2014-11-10}{2017-02-28}]{raster equal height}{=\meta{type}}{default \docValue{all}, initially \docValue{none}}
Puts the enclosed boxes into a common \refKey{/tcb/equal height group}.
The \meta{id} of the equal height group is chosen automatically, but
it may be set manually by \refKey{/tcb/raster equal height group}.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex
index 783306b6d79..772ef03aaa8 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.technical.tex
@@ -728,3 +728,25 @@ considered to be \textit{read-only} and should never be redefined by the user.
\end{tcolorbox}
\end{dispExample}
\end{docCommand}
+
+
+\begin{docCommand}[doc new=2017-04-25]{tcbsegmentstate}{}
+ This macro contains |0|, |1|, or |2|. Itis set for every unbroken box and every broken partial box
+ with the following meaning:
+ \begin{itemize}
+ \item\docValue{0}: The current (partial) box contains only an upper part.
+ \item\docValue{1}: The current (partial) box contains an upper and a lower part.
+ The segmentation node can be used for positioning.
+ \item\docValue{2}: The current (partial) box contains only a lower part.
+ This can only be true for parts of breakable boxes.
+ \end{itemize}
+ Skins like \refSkin{bicolor} use this property to paint the (partial) boxes.
+\begin{dispExample}
+% \tcbuselibrary{skins,raster}
+\begin{tcbraster}[raster equal height,enhanced,
+ watermark text=\tcbsegmentstate]
+ \begin{tcolorbox}Upper part\end{tcolorbox}
+ \begin{tcolorbox}Upper part\tcblower Lower part\end{tcolorbox}
+\end{tcbraster}
+\end{dispExample}
+\end{docCommand}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index b62fddf32c1..938878c0e39 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 979a4852cee..0dfd55de447 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 4.02 (2017/02/24)
+%% The LaTeX package tcolorbox - version 4.03 (2017/04/25)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -43,8 +43,8 @@
\setlength{\bibitemsep}{\smallskipamount}
\addbibresource{tcolorbox.doc.bib}
-\def\version{4.02}%
-\def\datum{2017/02/24}%
+\def\version{4.03}%
+\def\datum{2017/04/25}%
\makeindex
\hypersetup{
@@ -58,7 +58,7 @@
%\tcbset{draftmode}
\tcbset{/tcb/external/-}% for final run
-%\includeonly{tcolorbox.doc.external}
+%\includeonly{tcolorbox.doc.magazine}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%