From 7be21ce6fd3bee9ec93c44341ea42a5153f3dd97 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 26 Jul 2018 21:47:48 +0000 Subject: tcolorbox (26jul18) git-svn-id: svn://tug.org/texlive/trunk@48282 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/tcolorbox/CHANGES | 12 +++++++- Master/texmf-dist/doc/latex/tcolorbox/README | 4 +-- .../latex/tcolorbox/tcolorbox-example-poster.pdf | Bin 273832 -> 273832 bytes .../latex/tcolorbox/tcolorbox-example-poster.tex | 2 +- .../doc/latex/tcolorbox/tcolorbox-example.pdf | Bin 457474 -> 457478 bytes .../doc/latex/tcolorbox/tcolorbox-example.tex | 2 +- .../latex/tcolorbox/tcolorbox-tutorial-poster.pdf | Bin 442319 -> 442507 bytes .../latex/tcolorbox/tcolorbox-tutorial-poster.tex | 2 +- .../latex/tcolorbox/tcolorbox.doc.breakable.tex | 20 ++++++++++++- .../latex/tcolorbox/tcolorbox.doc.coreoptions.tex | 12 ++++++++ .../doc/latex/tcolorbox/tcolorbox.doc.listings.tex | 11 +++++++- .../latex/tcolorbox/tcolorbox.doc.s_snippet.sty | 2 +- .../doc/latex/tcolorbox/tcolorbox.doc.xparse.tex | 31 ++++++++++++++++++--- .../texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf | Bin 6556959 -> 6566401 bytes .../texmf-dist/doc/latex/tcolorbox/tcolorbox.tex | 9 +++--- 15 files changed, 89 insertions(+), 18 deletions(-) (limited to 'Master/texmf-dist/doc/latex/tcolorbox') 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 @@ -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 +%% Copyright (c) 2006-2018 by Prof. Dr. Dr. Thomas F. Sturm %% ------------------------------------------------------------------------------------------- %% %% 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 Binary files a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf and b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example-poster.pdf 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 Binary files a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf and b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf 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 Binary files a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf and b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-tutorial-poster.pdf 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 Binary files a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf and b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf 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} -- cgit v1.2.3