From e86345f5dc9769da6df2b57003f79e20506092cd Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 19 Sep 2019 20:45:10 +0000 Subject: tcolorbox (19sep19) git-svn-id: svn://tug.org/texlive/trunk@52128 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/tcolorbox/CHANGES | 24 +++- Master/texmf-dist/doc/latex/tcolorbox/README | 2 +- .../latex/tcolorbox/tcolorbox-example-poster.pdf | Bin 273214 -> 274152 bytes .../latex/tcolorbox/tcolorbox-example-poster.tex | 2 +- .../doc/latex/tcolorbox/tcolorbox-example.pdf | Bin 456409 -> 457694 bytes .../doc/latex/tcolorbox/tcolorbox-example.tex | 2 +- .../latex/tcolorbox/tcolorbox-tutorial-poster.pdf | Bin 440925 -> 442887 bytes .../latex/tcolorbox/tcolorbox-tutorial-poster.tex | 2 +- .../latex/tcolorbox/tcolorbox.doc.coreoptions.tex | 78 +++++++++-- .../tcolorbox/tcolorbox.doc.documentation.tex | 152 ++++++++++++++++++--- .../doc/latex/tcolorbox/tcolorbox.doc.hooks.tex | 28 +++- .../latex/tcolorbox/tcolorbox.doc.recording.tex | 13 +- .../doc/latex/tcolorbox/tcolorbox.doc.s_main.sty | 1 + .../doc/latex/tcolorbox/tcolorbox.doc.skins.tex | 22 +-- .../texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf | Bin 7938126 -> 7152247 bytes .../texmf-dist/doc/latex/tcolorbox/tcolorbox.tex | 10 +- 16 files changed, 282 insertions(+), 54 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 721d974d1e1..4775a12354d 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.20 (2019/03/02) +%% The LaTeX package tcolorbox - version 4.21 (2019/09/19) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2019 by Prof. Dr. Dr. Thomas F. Sturm @@ -1084,3 +1084,25 @@ version 4.20 (2019/03/02) * new options: 'beamer hidden', 'beamer alerted', 'hide', 'alert' * option 'only' moved from package to skins library - new documentation section '13 Beamer Support' + +version 4.21 (2019/09/19) +- bug fix (#71): 'shield externalize' should be effective on all tcolorbox layers +- bug fix (#76): 'spread inwards', 'spread outwards', 'spread sidewards' gave + wrong results for some document geometry settings +- new options (#75): 'tabulars', 'tabulars*' +- library 'extras': + * bug fix: all 'extras ...' options from library 'hooks' took code instead of options + * new options (#73): 'minted options app', 'minted options pre', + 'listing options app', 'listing options pre' +- library 'xparse': + * bug fix: options 'IfNoValueTF', 'IfValueTF', 'IfBooleanTF' failed + to recognize arguments in some code line breaks situations +- library 'documentation': + TikZ path operation documentation (#65): + * new color name: 'Fade' + * new macros and environments: '\colFade', 'docPathOperation', + '\refPathOperation', '\refPathOperation*' + * new options: 'color fade', 'color path', 'doc label', 'doc head path', + 'before doc body path', 'after doc body path' + * new language string: 'path', 'paths' +- documentation: checkerbox for opacity examples was too dark diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index 67e8c16547e..ad3735e6643 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.20 (2019/03/02) +%% The LaTeX package tcolorbox - version 4.21 (2019/09/19) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2019 by Prof. Dr. Dr. Thomas F. Sturm 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 6745fadb2be..3e10c423608 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 4cd8461954e..1f67a3c87be 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.20 (2019/03/02) +%% The LaTeX package tcolorbox - version 4.21 (2019/09/19) %% 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 ea5dc03ad17..0e99b2a5391 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 64bd2eacedb..5ed9ba9a676 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.20 (2019/03/02) +%% The LaTeX package tcolorbox - version 4.21 (2019/09/19) %% 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 67a36b97ebe..b50b13514b5 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 11d6d47954b..9c52b6c68cc 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.20 (2019/03/02) +%% The LaTeX package tcolorbox - version 4.21 (2019/09/19) %% tcolorbox-tutorial-poster.tex: a tutorial for poster creation with tcolorbox %% %% ------------------------------------------------------------------------------------------- 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 b8effa83e99..dfe82a456ea 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex @@ -1535,7 +1535,7 @@ skin variants, see \Vref{subsec:skinjigsaw}. \begin{docTcbKey}{opacityframe}{=\meta{fraction}}{no default, initially \texttt{1.0}} Sets the frame opacity of the box to the given \meta{fraction}. -\begin{exdispExample*}{opacityframe}{sbs,lefthand ratio=0.6,segmentation style={pattern=checkerboard light gray}} +\begin{exdispExample*}{opacityframe}{sbs,lefthand ratio=0.6,segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcolorbox}[opacityframe=0.25, colframe=red] This is a \textbf{tcolorbox}. @@ -1545,7 +1545,7 @@ This is a \textbf{tcolorbox}. \begin{docTcbKey}{opacityback}{=\meta{fraction}}{no default, initially \texttt{1.0}} Sets the background opacity of the box to the given \meta{fraction}. -\begin{exdispExample*}{opacityback}{sbs,lefthand ratio=0.6,segmentation style={pattern=checkerboard light gray}} +\begin{exdispExample*}{opacityback}{sbs,lefthand ratio=0.6,segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcolorbox}[standard jigsaw,colframe=red, opacityframe=0.5, opacityback=0.5] This is a \textbf{tcolorbox}. @@ -1556,7 +1556,7 @@ This is a \textbf{tcolorbox}. \begin{docTcbKey}{opacitybacktitle}{=\meta{fraction}}{no default, initially \texttt{1.0}} Sets the title background opacity of the box to the given \meta{fraction}. -\begin{exdispExample*}{opacitybacktitle}{sbs,lefthand ratio=0.6,segmentation style={pattern=checkerboard light gray}} +\begin{exdispExample*}{opacitybacktitle}{sbs,lefthand ratio=0.6,segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcolorbox}[standard jigsaw,colframe=red, opacityframe=0.5, opacitybacktitle=0.5, title filled, title=This is a title] @@ -1569,7 +1569,7 @@ This is a \textbf{tcolorbox}. \begin{docTcbKey}{opacityfill}{=\meta{fraction}}{style, no default, initially \texttt{1.0}} Sets the fill opacity for frame, interior and optionally the title background to the given \meta{fraction}. -\begin{exdispExample*}{opacityfill}{sbs,lefthand ratio=0.6,segmentation style={pattern=checkerboard light gray}} +\begin{exdispExample*}{opacityfill}{sbs,lefthand ratio=0.6,segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcolorbox}[standard jigsaw,colframe=red, opacityfill=0.7, title=This is a title] This is a \textbf{tcolorbox}. @@ -1582,7 +1582,7 @@ This is a \textbf{tcolorbox}. Sets the text opacity of the upper box part to the given \meta{fraction}. \begin{exdispExample*}{opacityupper}{sbs,lefthand ratio=0.6} \begin{tcolorbox}[enhanced,opacityupper=0.5, - interior style={pattern=checkerboard light gray}] + interior style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}] This is a \textbf{tcolorbox}. \end{tcolorbox} \end{exdispExample*} @@ -1593,7 +1593,7 @@ This is a \textbf{tcolorbox}. Sets the text opacity of the lower box part to the given \meta{fraction}. \begin{exdispExample*}{opacitylower}{sbs,lefthand ratio=0.6} \begin{tcolorbox}[enhanced,opacitylower=0.5, - interior style={pattern=checkerboard light gray}] + interior style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}] This is a \textbf{tcolorbox}. \tcblower This is the lower part. @@ -1605,7 +1605,7 @@ This is the lower part. Sets the text opacity of the upper and the lower box part to the given \meta{fraction}. \begin{exdispExample*}{opacitytext}{sbs,lefthand ratio=0.6} \begin{tcolorbox}[enhanced,opacitytext=0.5, - interior style={pattern=checkerboard light gray}] + interior style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}] This is a \textbf{tcolorbox}. \tcblower This is the lower part. @@ -1620,14 +1620,14 @@ This is the lower part. \begin{tcolorbox}[enhanced,opacitytitle=0.7, coltitle=black, fonttitle=\bfseries,title=This is a title, - title style={pattern=checkerboard light gray}] + title style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}] This is a \textbf{tcolorbox}. \end{tcolorbox} \end{exdispExample*} \end{docTcbKey} -\begin{exdispExample*}{opacity_general}{segmentation style={pattern=checkerboard light gray}} +\begin{exdispExample*}{opacity_general}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcolorbox}[enhanced jigsaw,fonttitle=\bfseries,title=This is a title, opacityframe=0.5,opacityback=0.25,opacitybacktitle=0.25,opacitytext=0.8, colback=red!5!white,colframe=red!75!black,colbacktitle=yellow!20!red] @@ -2336,6 +2336,55 @@ This is the end of my box. \end{exdispExample} \end{docTcbKey} + +\clearpage + +\begin{docTcbKey}[][doc new={2019-09-19}]{tabulars}{=\meta{preamble}}{style} + This style sets \refKey{/tcb/before upper} and \refKey{/tcb/after upper} + and several geometry keys to support a |tabular*| with the + given \meta{preamble}. + The packages |array| and |colortbl| have to be loaded separately. +\begin{exdispExample}{tabulars_1} +% \usepackage{array} +% \usepackage{colortbl} - or - \usepackage[table]{xcolor} +\tcbset{enhanced,fonttitle=\bfseries\large,fontupper=\normalsize\sffamily, + colback=yellow!10!white,colframe=red!50!black,colbacktitle=Salmon!30!white, + coltitle=black,center title} + +\begin{tcolorbox}[tabulars={@{\extracolsep{\fill}\hspace{5mm}}lrrrrr@{\hspace{5mm}}}, + boxrule=0.5pt,title=My table] +Group & One & Two & Three & Four & Sum\\\hline\hline +Red & 1000.00 & 2000.00 & 3000.00 & 4000.00 & 10000.00\\\hline +Green & 2000.00 & 3000.00 & 4000.00 & 5000.00 & 14000.00\\\hline +Blue & 3000.00 & 4000.00 & 5000.00 & 6000.00 & 18000.00\\\hline\hline +Sum & 6000.00 & 9000.00 & 12000.00 & 15000.00 & 42000.00 +\end{tcolorbox} +\end{exdispExample} +\end{docTcbKey} + + +\begin{docTcbKey}[][doc new={2019-09-19}]{tabulars*}{=\marg{code}\marg{preamble}}{style} + This is a variant of \refKey{/tcb/tabulars} which adds some \meta{code} + before the table starts. +\begin{exdispExample}{tabulars_2} +% \usepackage{array} +% \usepackage{colortbl} - or - \usepackage[table]{xcolor} +\tcbset{enhanced,fonttitle=\bfseries\large,fontupper=\normalsize\sffamily, + colback=yellow!10!white,colframe=red!50!black,colbacktitle=Salmon!30!white, + coltitle=black,center title} + +\begin{tcolorbox}[tabulars*={\arrayrulewidth0.5mm\renewcommand\arraystretch{1.4}}% + {@{\extracolsep{\fill}\hspace{20mm}}lll@{\hspace{20mm}}}, + title=My table] +One & Two & Three \\\hline\hline +1000.00 & 2000.00 & 3000.00\\\hline +2000.00 & 3000.00 & 4000.00 +\end{tcolorbox} +\end{exdispExample} +\end{docTcbKey} + + + \clearpage \begin{marker} If \refKey{/tcb/tabularx} or \refKey{/tcb/tabularx*} are used, one cannot @@ -2386,6 +2435,7 @@ One & Two & Three \\\hline\hline \end{docTcbKey} + \clearpage \begin{docTcbKey}{tikz upper}{\colOpt{=\meta{options}}}{style} This style adds a centered |tikzpicture| environment to the start and end @@ -3547,7 +3597,7 @@ If needed, the number of managed layers can be increased by setting The following styles have a considerable influence on how layered boxes are processed. Note especially that nested boxes are getting a \refKey{/tcb/reset} by default. You can change this, but be prepared for -suprises if you do. +surprises if you do. If the defaults are \emph{not changed}, a |tcolorbox| gets its options in the following order. Following options overwrite preceding options. @@ -4287,6 +4337,11 @@ do \emph{not} use |\tikzexternaldisable| in front of the |tcolorbox|. \refKey{/tcb/shield externalize} is deactivated automatically inside a |tikzpicture|. \end{marker} +\begin{marker} +\refKey{/tcb/shield externalize} is applied for every following |tcolorbox| +inside the current \TeX\ group and is not affected by \refKey{/tcb/reset}. +\end{marker} + \begin{docTcbKey}{external}{=\meta{file name}}{no default, initially unset} Convenience option which calls |\tikzsetnextfilename|\marg{file name}. Typically, it may be used inside the option list of a |tcolorbox| to set the @@ -4310,7 +4365,8 @@ do \emph{not} use |\tikzexternaldisable| in front of the |tcolorbox|. \begin{docTcbKey}{reset}{}{no value, initially set} Sets (nearly) all |tcolorbox| settings (including loaded libraries) back to their default values \emph{plus} any settings given by \refCom{tcbsetforeverylayer}. -\refKey{/tcb/savedelimiter} and \refKey{/tcb/capture} keep their values. +\refKey{/tcb/savedelimiter}, \refKey{/tcb/capture}, and +\refKey{/tcb/shield externalize} keep their values. Also, all raster values (see \Vref{sec:raster}) are not resetted. This option is useful for boxes in boxes where the inner box should not inherit 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 f8c1c4553cd..cda39d43fad 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.documentation.tex @@ -131,6 +131,36 @@ For |minted| \cite{poore:minted} support, load: \end{docEnvironment} + + +\begin{docEnvironment}[doclang/environment content=operation description, + doc new=2019-09-18]{docPathOperation}{\oarg{options}\marg{name}\marg{parameters}} + Documents a \tikzname\ path operation with given \meta{name}. + The given \meta{options} are set with \refCom{tcbset}. + This \tikzname\ path operation takes mandatory or optional \meta{parameters}. + It is automatically indexed and can be referenced with + \refCom{refPathOperation}\marg{name}. +\begin{dispExample} +\begin{docPathOperation}{fooop}{\oarg{opt}(\meta{name})\colOpt{at(\meta{coord})}} + Imaginary path operation for illustration. +\end{docPathOperation} +\end{dispExample} +\end{docEnvironment} + + +\begin{docEnvironment}[doclang/environment content=command description, + doc new=2019-09-17]{docPathOperation*}{\oarg{options}\marg{name}\marg{parameters}} + Identical to \refEnv{docPathOperation}, but without index entry. +\end{docEnvironment} + + + + + + + + + \begin{docCommand}{docValue}{\marg{name}} Documents a value with given \meta{name}. Typically, this is a value for a key. This value is automatically indexed. @@ -144,6 +174,7 @@ A feasible value for \refKey{/foo/footitle} is \docValue{foovalue}. Identical to \refCom{docValue}, but without index entry. \end{docCommand} +\clearpage \begin{docCommand}[doc updated=2014-10-09]{docAuxCommand}{\marg{name}} Documents an auxiliary or minor \LaTeX\ macro with given \meta{name} @@ -170,7 +201,7 @@ The environment \docAuxEnvironment{fooauxenv} holds some interesting data. Identical to \refCom{docAuxEnvironment}, but without index entry. \end{docCommand} -\clearpage + \begin{docCommand}{docAuxKey}{\oarg{key path}\marg{name}} Documents an auxiliary key with given \meta{name} and an optional \meta{key path}. @@ -208,6 +239,7 @@ The length \docLength{foolength} can be used for computation. Identical to \refCom{docLength}, but without index entry. \end{docCommand} +\clearpage \begin{docCommand}{docColor}{\marg{name}} Documents a color with given \meta{name}. The color is automatically indexed. @@ -221,7 +253,7 @@ The color \docColor{foocolor} is available. \end{docCommand} -\clearpage + \begin{docCommand}{cs}{\marg{name}} Macro from |ltxdoc| \cite{carlisle:2007a} to typeset a command word \meta{name} where the backslash is prefixed. The library overwrites the original macro. @@ -409,6 +441,24 @@ We have created \refKey*{/foo/footitle} as an example. \end{docCommand} +\begin{docCommand}[doc new=2019-09-17]{refPathOperation}{\marg{name}} + References a documented \tikzname\ path operation with given \meta{name}. + The page reference is suppressed if it links to the same page. +\begin{dispExample} +We have created \refPathOperation{fooop} as an example. +\end{dispExample} +\end{docCommand} + +\begin{docCommand}[doc new=2019-09-17]{refPathOperation*}{\marg{name}} + References a documented \tikzname\ path operation with given \meta{name}. + There is no page reference. +\begin{dispExample} +We have created \refPathOperation*{fooop} as an example. +\end{dispExample} +\end{docCommand} + + + \begin{docCommand}{refAux}{\marg{name}} References some auxiliary environment, key, value, or color. The hyperlink color is used, but there is no real link. @@ -426,8 +476,8 @@ Some pages back, one can see \refAuxcs{fooaux} as an example. \end{dispExample} \end{docCommand} +\clearpage -% \begin{docCommand}{colDef}{\marg{text}} Sets \meta{text} with the command color, see \refKey{/tcb/color command}. \begin{dispExample} @@ -442,7 +492,14 @@ This is my \colOpt{text}. \end{dispExample} \end{docCommand} -\clearpage + +\begin{docCommand}[doc new=2019-09-18]{colFade}{\marg{text}} + Sets \meta{text} with the fade color, see \refKey{/tcb/color fade}. +\begin{dispExample} +This is my \colFade{text}. +\end{dispExample} +\end{docCommand} + \begin{docCommand}[doc new=2014-09-19]{tcbdocmarginnote}{\oarg{options}\marg{text}} Creates a |tcolorbox| note with the given \meta{text} inside the margin using @@ -672,6 +729,10 @@ instead. Also see \refKey{/tcb/docexample}. Sets the highlight color used by key definitions. \end{docTcbKey} +\begin{docTcbKey}[][doc new={2019-09-18}]{color path}{=\meta{color}}{no default, initially |Definition|} + Sets the highlight color used by \tikzname\ path operation definitions. +\end{docTcbKey} + \begin{docTcbKey}{color value}{=\meta{color}}{no default, initially |Definition|} Sets the highlight color used by value definitions. \end{docTcbKey} @@ -688,9 +749,9 @@ instead. Also see \refKey{/tcb/docexample}. Sets the highlight color used by color definitions. \end{docTcbKey} -\begin{docTcbKey}{color definition}{=\meta{color}}{no default, initially |Definition|} +\begin{docTcbKey}[][doc updated={2019-09-18}]{color definition}{=\meta{color}}{no default, initially |Definition|} Sets the highlight color for \refKey{/tcb/color command}, \refKey{/tcb/color environment}, - \refKey{/tcb/color key}, \refKey{/tcb/color value}, \refKey{/tcb/color counter}, + \refKey{/tcb/color key}, \refKey{/tcb/color path}, \refKey{/tcb/color value}, \refKey{/tcb/color counter}, \refKey{/tcb/color length}, and \refKey{/tcb/color color}. \end{docTcbKey} @@ -698,6 +759,12 @@ instead. Also see \refKey{/tcb/docexample}. Sets the color used for optional arguments. \end{docTcbKey} +\begin{docTcbKey}{color fade}{=\meta{color}}{no default, initially |Fade|} + Sets the color used for faded text like \colFade{\textbackslash path} + in \refEnv{docPathOperation}. +\end{docTcbKey} + + \begin{docTcbKey}{color hyperlink}{=\meta{color}}{no default, initially |Hyperlink|} Sets the color for all hyper-links, i.\,e. all internal and external links. \end{docTcbKey} @@ -759,11 +826,18 @@ The English language is predefined. Heading text in the index for lengths. \end{langTcbKey} - \begin{langTcbKey}[][doc new={2014-09-19}]{new}{=\meta{text}}{no default, initially |New|} Announcement text for new content. \end{langTcbKey} +\begin{langTcbKey}[][doc new={2019-09-18}]{path}{=\meta{text}}{no default, initially |path operation|} + Text used in the index for path operations. +\end{langTcbKey} + +\begin{langTcbKey}[][doc new={2019-09-18}]{paths}{=\meta{text}}{no default, initially |Path operations|} + Heading text in the index for path operations. +\end{langTcbKey} + \begin{langTcbKey}{pageshort}{=\meta{text}}{no default, initially |P.|} Short text for page references. \end{langTcbKey} @@ -872,13 +946,27 @@ Options to these |tcolorbox|es can be given using the following keys. \end{dispExample} \end{docTcbKey} -\begin{docTcbKey}{doc head}{=\meta{options}}{no default, initially empty} +\clearpage +\begin{docTcbKey}[][doc new=2019-09-18]{doc head path}{=\meta{options}}{no default, initially empty} + Sets \meta{options} for the head line of \refEnv{docPathOperation} and \refEnv{docPathOperation*}. +\begin{dispExample} +\tcbset{doc head command={interior style={fill,left color=red!7!white, + right color=blue!7!white}}} + +\begin{docPathOperation*}{-{}-}{\meta{coordinate or cycle}} + This is the documentation of \refPathOperation{-{}-}. +\end{docPathOperation*} +\end{dispExample} +\end{docTcbKey} + + +\begin{docTcbKey}[][doc updated=2019-09-18]{doc head}{=\meta{options}}{no default, initially empty} Shortcut for setting the same \meta{options} for \refKey{/tcb/doc head command}, \refKey{/tcb/doc head environment}, - and \refKey{/tcb/doc head key}. + \refKey{/tcb/doc head key}, and \refKey{/tcb/doc head path}. \end{docTcbKey} -\clearpage + The description texts of the main documentation environments \refEnv{docCommand}, \refEnv{docEnvironment}, \refEnv{docKey}, etc, are set in a compact form without indention and |parskip=0pt|. This settings can overruled by using the following @@ -916,7 +1004,7 @@ keys to insert code before (or after) the description texts. \end{dispExample} \end{docTcbKey} - +\clearpage \begin{docTcbKey}[][doc new=2015-10-09]{before doc body environment}{=\meta{code}}{no default, initially empty} Executes \meta{code} before the description texts of \refEnv{docEnvironment} and \refEnv{docEnvironment*}. @@ -938,23 +1026,35 @@ keys to insert code before (or after) the description texts. of \refEnv{docKey} and \refEnv{docKey*}. \end{docTcbKey} -\begin{docTcbKey}[][doc new=2015-10-09]{before doc body}{=\meta{options}}{no default, initially empty} +\begin{docTcbKey}[][doc new=2019-09-18]{before doc body path}{=\meta{code}}{no default, initially empty} + Executes \meta{code} before the description texts + of \refEnv{docPathOperation} and \refEnv{docPathOperation*}. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2019-09-18]{after doc body path}{=\meta{code}}{no default, initially empty} + Executes \meta{code} after the description texts + of \refEnv{docPathOperation} and \refEnv{docPathOperation*}. +\end{docTcbKey} + + +\begin{docTcbKey}[][doc new and updated={2015-10-09}{2019-09-18}]{before doc body}{=\meta{options}}{no default, initially empty} Shortcut for setting the same \meta{options} for \refKey{/tcb/before doc body command}, \refKey{/tcb/before doc body environment}, - and \refKey{/tcb/before doc body key}. + \refKey{/tcb/before doc body key}, and \refKey{/tcb/before doc body path}. \end{docTcbKey} -\begin{docTcbKey}[][doc new=2015-10-09]{after doc body}{=\meta{options}}{no default, initially empty} +\begin{docTcbKey}[][doc new and updated={2015-10-09}{2019-09-18}]{after doc body}{=\meta{options}}{no default, initially empty} Shortcut for setting the same \meta{options} for \refKey{/tcb/after doc body command}, \refKey{/tcb/after doc body environment}, - and \refKey{/tcb/after doc body key}. + \refKey{/tcb/after doc body key}, and \refKey{/tcb/after doc body path}. \end{docTcbKey} -\clearpage +%\clearpage \begin{docTcbKey}{doc description}{=\meta{text}}{no default, initially empty} Sets a (short!) additional description \meta{text} for - \refEnv{docCommand} or \refEnv{docEnvironment}. Such a description is + \refEnv{docCommand}, \refEnv{docEnvironment}, or \refEnv{docPathOperation}. + Such a description is mandatory for \refEnv{docKey}. \begin{dispExample} \begin{docCommand*}[doc description=my description]{myCommandF}{\marg{argument}} @@ -968,6 +1068,19 @@ hand side if too long. Linebreaks can be used inside the \meta{text}. \end{marker} \end{docTcbKey} +\clearpage +\begin{docTcbKey}[][doc new={2019-09-18}]{doc label}{=\meta{text}}{no default, initially unset} + If used inside the option list of \refEnv{docCommand}, \refEnv{docEnvironment}, + \refEnv{docKey}, or \refEnv{docPathOperation}, then \meta{text} is used + for labeling instead of the name of the definition. +\begin{dispExample} +\begin{docPathOperation*}[doc label=pathline]{-{}-}{\meta{coordinate or cycle}} + This is the documentation of \refPathOperation{pathline}. +\end{docPathOperation*} +\end{dispExample} +\end{docTcbKey} + + \begin{docTcbKey}{doc into index}{\colOpt{=true\textbar false}}{default |true|, initially |true|} If set to |false|, no index entries are written for the main documentation environments. The same effect is achieved by using e.\,g.\ \refEnv{docCommand*} @@ -1008,7 +1121,7 @@ Some command for something. \end{docTcbKey} -\subsection{Predefined Colors of the Library} +\subsection{Predefined Colors of the Library}\tcbdocmarginnote{\tcbdocupdated{2019-09-18}} The following colors are predefined. They are used as default colors in some library commands. @@ -1018,6 +1131,7 @@ in some library commands. \dispColor{Definition}, \dispColor{ExampleFrame}, \dispColor{ExampleBack}, -\dispColor{Hyperlink}. +\dispColor{Hyperlink}, +\dispColor{Fade}. diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex index b5e37eee984..33782234fe8 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.hooks.tex @@ -475,8 +475,8 @@ There are no |app| type keys since finishes are stackable by default. \subsection{Skin Code} -The following option keys extend the options given in Subsection \ref{subsec:addcodeoptions} -from page \pageref{subsec:addcodeoptions}. +The following option keys extend the options given in Subsection~\ref{subsec:addcodeoptions} +from page~\pageref{subsec:addcodeoptions}. \begin{docTcbKey}{frame code app}{=\meta{graphical code}}{no default} Appends the given \meta{graphical code} to \refKey{/tcb/frame code}. @@ -575,3 +575,27 @@ There are no |app| type keys since extras are stackable by default. Prepends the given \meta{options} to \refKey{/tcb/extras first and middle}. \end{docTcbKey} + +\subsection{Listings} +The following option keys extend the options given in +Section~\ref{sec:listings} +from page~\pageref{sec:listings}. + + +\begin{docTcbKey}[][doc new=2019-07-11]{listing options app}{=\marg{options}}{no default} + Appends the given \meta{options} to \refKey{/tcb/listing options}. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2019-07-11]{listing options pre}{=\marg{options}}{no default} + Prepends the given \meta{options} to \refKey{/tcb/listing options}. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2019-07-11]{minted options app}{=\marg{options}}{no default} + Appends the given \meta{options} to \refKey{/tcb/minted options}. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2019-07-11]{minted options pre}{=\marg{options}}{no default} + Prepends the given \meta{options} to \refKey{/tcb/minted options}. +\end{docTcbKey} + + diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex index 75c016fb91c..84510ab7540 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.recording.tex @@ -15,6 +15,17 @@ in \Vref{sec:recording-solutions}. Opens a file denoted by \meta{file name} for writing the records. The default file name is |\jobname.records|. See \Vref{sec:recording-exercises} for an example application. + \begin{marker} + In some situations, a not existing optional parameter may cause parsing + problems. If this happens (or just for precaution), use +\begin{dispListing} +\tcbstartrecording\relax +\end{dispListing} + or +\begin{dispListing} +\tcbstartrecording[\jobname.records] +\end{dispListing} + \end{marker} \end{docCommand} \begin{docCommand}[doc new=2014-11-28]{tcbrecord}{\marg{content}} @@ -66,7 +77,7 @@ has no solution. Finally, the solutions are input in \Vref{sec:recording-solutio \inputpreamblelisting{L} \begin{dispListing*}{breakable,before upper=} -\tcbstartrecording +\tcbstartrecording\relax \begin{exercise} Compute the derivative of the following function: diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty index 9a48d42bb6c..18385877c0c 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty @@ -54,6 +54,7 @@ \tcbset{skin=enhanced, doc head={colback=yellow!10!white,interior style=fill}, doc head key={colback=magenta!5!white,interior style=fill}, + doc head path={colback=blue!50!gray!7!white,interior style=fill}, color key=DarkViolet, color value=Teal, color color=Teal, diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex index e357d5b78c6..8c18743cecb 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.skins.tex @@ -596,7 +596,7 @@ The boxed title is shifted by \meta{length} in the vertical direction. \end{boxTcbKey} \begin{boxTcbKey}{yshifttext}{=\meta{length}}{no default, initially |0pt|} -The text inside the main box by \meta{length} to give room for e.\,g.\ a sunken title. +The text inside the main box is shifted by \meta{length} to give room for e.\,g.\ a sunken title. \begin{exdispExample*}{yshifttext}{sbs,lefthand ratio=0.66} \begin{tcolorbox}[enhanced,title=My title, attach boxed title to top center= @@ -1303,7 +1303,7 @@ Defines a |Tikz| scope which clips to the frame area path. \begin{docEnvironment}{tcbinvclipframe}{} Defines a |Tikz| scope which clips to the \emph{outside} of the frame area path. -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \tcbset{enhanced jigsaw,fonttitle=\bfseries,opacityback=0.35,colback=blue!5!white, frame style={left color=red!75!black,right color=red!10!yellow}} @@ -2245,7 +2245,7 @@ but most other skins, e.\,g.\ \refSkin{enhanced}. applied a second time, the new \meta{tikz option list} is appended to the current option list. \begin{dispExample*}{sbs,lefthand ratio=0.66, - segmentation style={pattern=checkerboard light gray}} + segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \tcbset{enhanced,colback=red!5!white, colframe=red!75!black,fonttitle=\bfseries} @@ -2837,7 +2837,7 @@ and \refSkin{enhanced}, there are variants called \refSkin{standard jigsaw} and \refSkin{enhanced jigsaw}. -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \newcommand{\ballexample}{\begin{tikzpicture} \path[use as bounding box] (0,0.8) rectangle +(0.1,0.1); \shadedraw [shading=ball] (0,0) circle (1cm); @@ -2863,7 +2863,7 @@ and \refSkin{enhanced jigsaw}. \end{dispExample*} -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \tcbset{enhanced,colback=red!10!white,coltitle=black, frame style={left color=red!75!black,right color=red!10!yellow}, fonttitle=\bfseries,interior hidden,title hidden} @@ -2879,7 +2879,7 @@ and \refSkin{enhanced jigsaw}. \end{dispExample*} -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \newtcolorbox{mybox}{skin=enhancedmiddle jigsaw,leftrule=5mm,rightrule=5mm, boxsep=0mm,top=0mm,bottom=0mm, frame style={top color=blue,bottom color=red},interior hidden} @@ -3047,7 +3047,7 @@ This box looks like a box provided by the \texttt{beamer} class. This is an abbreviation for setting |skin=standard jigsaw|. \end{docTcbKey} -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcbraster}[standard jigsaw,raster equal height,raster columns=4, colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen, opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5, @@ -3366,7 +3366,7 @@ Nevertheless, this skin can be applied independently. This is an abbreviation for setting |skin=enhanced jigsaw|. \end{docTcbKey} -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcbraster}[enhanced jigsaw,raster equal height,raster columns=4, colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen, opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5, @@ -3416,7 +3416,7 @@ Nevertheless, this skin can be applied independently. \end{docSkin} -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcbraster}[skin=enhancedfirst jigsaw,raster equal height,raster columns=4, colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen, opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5, @@ -3459,7 +3459,7 @@ Nevertheless, this skin can be applied independently. \end{docSkin} -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcbraster}[skin=enhancedmiddle jigsaw,raster equal height,raster columns=4, colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen, opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5, @@ -3557,7 +3557,7 @@ Nevertheless, this skin can be applied independently. \end{docSkin} -\begin{dispExample*}{segmentation style={pattern=checkerboard light gray}} +\begin{dispExample*}{segmentation style={preaction={fill=white},pattern=checkerboard,pattern color=gray!40}} \begin{tcbraster}[skin=enhancedlast jigsaw,raster equal height,raster columns=4, colback=LightGreen,colframe=DarkGreen,colbacktitle=LimeGreen!75!DarkGreen, opacityframe=0.5,opacityback=0.5,opacitybacktitle=0.5, diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf index e1e37bfe2cc..4c995dd99f4 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 69d5d409922..8399ca7681b 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.20 (2019/03/02) +%% The LaTeX package tcolorbox - version 4.21 (2019/09/19) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -43,8 +43,8 @@ \setlength{\bibitemsep}{\smallskipamount} \addbibresource{tcolorbox.doc.bib} -\def\version{4.20}% -\def\datum{2019/03/02}% +\def\version{4.21}% +\def\datum{2019/09/19}% \makeindex \hypersetup{ @@ -58,11 +58,11 @@ %\tcbset{draftmode} \tcbset{/tcb/external/-}% for final run -%\includeonly{tcolorbox.doc.skins} +%\includeonly{tcolorbox.doc.coreoptions} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{document} -\include{tcolorbox.doc.abstract} +\input{tcolorbox.doc.abstract} \include{tcolorbox.doc.intro} \include{tcolorbox.doc.quickref} \include{tcolorbox.doc.coremacros} -- cgit v1.2.3