summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-07-26 21:47:48 +0000
committerKarl Berry <karl@freefriends.org>2018-07-26 21:47:48 +0000
commit7be21ce6fd3bee9ec93c44341ea42a5153f3dd97 (patch)
tree2644c5410db0251859418f0ec4376f3a32ab804b /Master/texmf-dist/doc/latex/tcolorbox
parentd7113db1ee00fff3757b7cff7ff4e74a3625402b (diff)
tcolorbox (26jul18)
git-svn-id: svn://tug.org/texlive/trunk@48282 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES12
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README4
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdfbin273832 -> 273832 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin457474 -> 457478 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdfbin442319 -> 442507 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex20
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex12
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex11
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_snippet.sty2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex31
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin6556959 -> 6566401 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex9
15 files changed, 89 insertions, 18 deletions
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES
index 0b36a6eeb03..579884b14f3 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.13 (2018/03/22)
+%% The LaTeX package tcolorbox - version 4.14 (2018/07/26)
%%
%% -------------------------------------------------------------------------------------------
%% Copyright (c) 2006-2018 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
@@ -1050,3 +1050,13 @@ version 4.13 (2018/03/22)
* new option:
'graphics orientation'
+version 4.14 (2018/07/26)
+- bug fix (#40): 'tikzlower' and 'tikzupper' failed to take more than one parameter
+- '\tcblistof' issues a warning if tocdepth is lower than 1 (#42)
+- macro definition of \tcolorbox@label removed from aux file (#47)
+- documentation adapted to the changed argument collection of the xparse package (#43)
+- new options: 'index', 'index*'
+- library 'breakable':
+ * (#41) 'title after break' inherits the title alignment now
+ (may change output of existing documents!)
+ * new options 'extras title after break', 'no extras title after break'
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README
index 81fd2c14561..cae9bedbecf 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/README
+++ b/Master/texmf-dist/doc/latex/tcolorbox/README
@@ -1,7 +1,7 @@
-%% The LaTeX package tcolorbox - version 4.13 (2018/03/22)
+%% The LaTeX package tcolorbox - version 4.14 (2018/07/26)
%%
%% -------------------------------------------------------------------------------------------
-%% Copyright (c) 2006-2017 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
+%% Copyright (c) 2006-2018 by Prof. Dr. Dr. Thomas F. Sturm <thomas dot sturm at unibw dot de>
%% -------------------------------------------------------------------------------------------
%%
%% This work may be distributed and/or modified under the
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf
index b5ae37d231d..a09e161d02b 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex
index fc9eb118619..71d13743d19 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.tex
@@ -1,4 +1,4 @@
-%% The LaTeX package tcolorbox - version 4.13 (2018/03/22)
+%% The LaTeX package tcolorbox - version 4.14 (2018/07/26)
%% tcolorbox-example-poster.tex: a poster example for tcolorbox
%%
%% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf
index 88931956f45..b6464bbed0a 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 fe893e499cd..51a4ddfde0b 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.13 (2018/03/22)
+%% The LaTeX package tcolorbox - version 4.14 (2018/07/26)
%% tcolorbox-example.tex: an example for tcolorbox
%%
%% -------------------------------------------------------------------------------------------
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf
index c294a19d954..05ab9ff45fa 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex
index 9e93a60c607..6207c42d46c 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.tex
@@ -1,5 +1,5 @@
% \LaTeX-Main\
-%% The LaTeX package tcolorbox - version 4.13 (2018/03/22)
+%% The LaTeX package tcolorbox - version 4.14 (2018/07/26)
%% tcolorbox-tutorial-poster.tex: a tutorial for poster creation with 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 43fb1c9c2e7..6517287a37b 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.breakable.tex
@@ -184,10 +184,11 @@ parameters. The differences are:
\end{docTcbKey}
-\begin{docTcbKey}{title after break}{=\meta{text}}{no default, initially empty}
+\begin{docTcbKey}[][doc updated=2018-07-26]{title after break}{=\meta{text}}{no default, initially empty}
The \refKey{/tcb/title} is used only for the \emph{first} part of a
\emph{break sequence}. Use |title after break| to create a heading line
with \meta{text} as content for all following parts.
+ Also see \refKey{/tcb/extras title after break} for formatting the title text.
\end{docTcbKey}
@@ -545,6 +546,23 @@ and \refKey{/tcb/enlarge bottom at break by}.
\end{docTcbKey}
\clearpage
+
+\begin{docTcbKey}[][doc new=2018-07-26]{extras title after break}{=\marg{options}}{no default, initially unset}
+ If the box has a \refKey{/tcb/title after break}, then the \meta{options}
+ are added for all titles after the first break, i.e.\ all middle and last.
+ The color, font, and alignment of titles after break can be adapted choosing
+ \meta{options}, e.g.\ by \refKey{/tcb/coltitle}, \refKey{/tcb/fonttitle},
+ \refKey{/tcb/halign title}.
+ Note that \refKey{/tcb/colbacktitle} has to be placed into
+ \refKey{/tcb/extras middle and last}.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2018-07-26]{no extras title after break}{}{style, no default, initially set}
+ Removes the title after break extras if set before.
+\end{docTcbKey}
+
+\bigskip
+
\begin{exdispExample}{extras}
% \usepackage{lipsum,multicol}
% \usetikzlibrary{decorations.pathmorphing}
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 ebd10ec9d31..9c0f6b992e7 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex
@@ -3995,7 +3995,19 @@ to see the bookmark.
+\begin{docTcbKey}[][doc new=2018-07-26]{index}{=\meta{entry}}{no default, initially unset}
+ Adds an index \meta{entry} for the box. This is a shortcut for
+ setting |\index|\marg{entry} to \refKey{/tcb/phantom}.
+\end{docTcbKey}
+
+\begin{docTcbKey}[][doc new=2018-07-26]{index*}{=\marg{name}\marg{entry}}{no default, initially unset}
+ Adds an \meta{entry} to an index with a specific \meta{name}.
+ This is a shortcut for
+ setting |\index|\oarg{name}\marg{entry} to \refKey{/tcb/phantom}.
+ An index extension package like |imakeidx| has to be loaded to use
+ this option key.
+\end{docTcbKey}
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 22c5023c056..4595965f832 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
@@ -434,7 +434,16 @@ all options from \Vref{sec:speclistingkeys} are applicable.
together with UTF-8 support from the package |listingsutf8| \cite{oberdiek:2011a}.
This option is available only for the library variant \mylib{listingsutf8}.
The \meta{one-byte-encoding} is one of
- the applicable encodings from \cite{oberdiek:2011a}, e.\,g.\ |latin1|.
+ the applicable encodings from \cite{oberdiek:2011a}, e.\,g.\ |latin1|
+ which is the default.\par
+ Be aware that this means restriction to this specific \meta{one-byte-encoding}:
+ e.\,g.\ |latin1| comprises umlauts and other accented characters, but not
+ the Euro sign. If you want to use the |listings| package \emph{and} \flqq real\frqq\
+ UTF-8 source code, then do \emph{not} use \mylib{listingsutf8} but \mylib{listings}
+ with
+ \refKey{/tcb/listing inputencoding}|=utf8|
+ \emph{and} with specific manual hacks for specific UTF-8-encoded characters.
+
\end{docTcbKey}
See further options in \Vref{sec:commonlistingkeys}.
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_snippet.sty b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_snippet.sty
index 95429f41af9..c33f924d01c 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_snippet.sty
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_snippet.sty
@@ -132,7 +132,7 @@
\begin{tcbverbatimwrite}{\jobname_preamble_L.tex}
% \tcbuselibrary{skins,xparse}
-\NewTColorBox[auto counter,number within=section]{exercise}{+O{}}{%
+\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}
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex
index 37e66c35874..24a1cf89c85 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.xparse.tex
@@ -108,7 +108,7 @@ This is a tcolorbox.
\begin{dispExample}
% counter from previous example
-\DeclareTColorBox[use counter from=pabox]{mybox}{ O{red} m d"" O{} }
+\DeclareTColorBox[use counter from=pabox]{mybox}{ O{red} m d"" !O{} }
{enhanced,colframe=#1!75!black,colback=#1!5!white,
fonttitle=\bfseries,title={\thetcbcounter~#2},
IfValueTF={#3}{watermark text={#3}}{},#4}
@@ -266,7 +266,7 @@ This is a tcolorbox.
command with the same name.
\begin{dispExample}
-\DeclareTotalTCBox{\myverb}{ O{red} v O{} }
+\DeclareTotalTCBox{\myverb}{ O{red} v !O{} }
{ fontupper=\ttfamily,nobeforeafter,tcbox raise base,arc=0pt,outer arc=0pt,
top=0pt,bottom=0pt,left=0mm,right=0mm,
leftrule=0pt,rightrule=0pt,toprule=0.3mm,bottomrule=0.3mm,boxsep=0.5mm,
@@ -399,10 +399,33 @@ This is my
The environment \meta{name} is only created if it is not already defined.
\end{docCommand}
+\clearpage
+
+
+\begin{marker}
+With date of 2018-05-12, the |xparse| \cite{latexproject:2015a} package
+changed the argument collection process.
+Now, spaces are ignored which leads to a serious change for listing environments
+ending with an optional argument like \verb+O{}+.
+The former behaviour of respecting spaces can be preserved by adding a \flqq\verb+!+\frqq.
+Note that the following code uses \verb+!O{}+ now.
+\begin{itemize}
+\item For older |xparse| versions, the following code is correct when using \verb+O{}+.
+\item For |xparse| of 2018-05-12, only the first two examples of
+ the following code using \verb+O{}+ are really \flqq good\frqq\ -- all others do not work.
+\item For |xparse| of 2018-05-12, the following code is correct when using \verb+!O{}+.
+\item In the future, |xparse| \emph{may} return to the old behaviour for
+ environments.
+\end{itemize}
+\end{marker}
+
+
+
+
\begin{dispListing*}{title={Caveats of using an environment ending with an
optional argument},fonttitle=\bfseries}
-\DeclareTCBListing{mybox}{ O{} }{listing only,#1}
+\DeclareTCBListing{mybox}{ !O{} }{listing only,#1}
\begin{mybox}[colframe=red]
\good
@@ -493,7 +516,7 @@ The following commands need the \mylib{fitting} library to be included.
\begin{dispExample*}{sbs,lefthand ratio=0.6}
% \usepackage{lipsum}
-\DeclareTCBoxFit{\mybox}{ O{} m o }
+\DeclareTCBoxFit{\mybox}{ O{} m !o }
{colback=red!5!white,
colframe=red!75!black,
width=#2,height=#2/3*2,
diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf
index b0f8140a90d..9a6ee774bd8 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 18f90c3844f..4a9894e37a0 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.13 (2018/03/22)
+%% The LaTeX package tcolorbox - version 4.14 (2018/07/26)
%% tcolorbox.tex: Manual
%%
%% -------------------------------------------------------------------------------------------
@@ -43,8 +43,8 @@
\setlength{\bibitemsep}{\smallskipamount}
\addbibresource{tcolorbox.doc.bib}
-\def\version{4.13}%
-\def\datum{2018/03/22}%
+\def\version{4.14}%
+\def\datum{2018/07/26}%
\makeindex
\hypersetup{
@@ -58,8 +58,7 @@
%\tcbset{draftmode}
\tcbset{/tcb/external/-}% for final run
-%\includeonly{tcolorbox.doc.documentation}
-
+%\includeonly{tcolorbox.doc.listings}
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\begin{document}