From 2d5135a3daaa80ca6f8878e7296bd5cbd0041cd5 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 14 Jul 2016 21:41:30 +0000 Subject: tcolorbox (14jul16) git-svn-id: svn://tug.org/texlive/trunk@41700 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/tcolorbox/CHANGES | 15 ++++- Master/texmf-dist/doc/latex/tcolorbox/README | 4 +- .../doc/latex/tcolorbox/tcolorbox-example.pdf | Bin 458241 -> 458241 bytes .../doc/latex/tcolorbox/tcolorbox-example.tex | 2 +- .../latex/tcolorbox/tcolorbox.doc.coreoptions.tex | 21 +++++++ .../doc/latex/tcolorbox/tcolorbox.doc.external.tex | 23 +++++++- .../doc/latex/tcolorbox/tcolorbox.doc.graphics.tex | 2 +- .../doc/latex/tcolorbox/tcolorbox.doc.listings.tex | 62 +++++++++++++++++++-- .../doc/latex/tcolorbox/tcolorbox.doc.s_main.sty | 2 + .../doc/latex/tcolorbox/tcolorbox.doc.theorems.tex | 5 +- .../texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf | Bin 6811114 -> 6835148 bytes .../texmf-dist/doc/latex/tcolorbox/tcolorbox.tex | 22 ++++---- 12 files changed, 135 insertions(+), 23 deletions(-) (limited to 'Master/texmf-dist/doc/latex') diff --git a/Master/texmf-dist/doc/latex/tcolorbox/CHANGES b/Master/texmf-dist/doc/latex/tcolorbox/CHANGES index ec65b64e3b5..51810f6bce2 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.93 (2016/06/01) +%% The LaTeX package tcolorbox - version 3.94 (2016/07/14) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm @@ -913,3 +913,16 @@ version 3.93 (2016/06/01) - bug fix: compatibility patch for \vsplit in luatex 0.95 was buggy - system commands are now accessed using the 'shellesc' package for compatibility with luatex + +version 3.94 (2016/07/14) +- bug fix: '\tcbincludegraphics' for fixed height boxes was broken since v3.90 (2016/02/29) +- new option 'nameref' +- library 'theorems': + Theorems made nameref-aware +- library 'listings': + * new options: + 'freeze file', 'freeze none', 'freeze extension', + 'freeze pdf', 'freeze png', 'freeze jpg' +- library 'external': + * implementation improved for lualatex and xelatex + * new macro '\tcbiffileprocess' diff --git a/Master/texmf-dist/doc/latex/tcolorbox/README b/Master/texmf-dist/doc/latex/tcolorbox/README index fec7a39af88..bec78a4d6b2 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.93 (2016/06/01) +%% The LaTeX package tcolorbox - version 3.94 (2016/07/14) %% %% ------------------------------------------------------------------------------------------- %% Copyright (c) 2006-2016 by Prof. Dr. Dr. Thomas F. Sturm @@ -39,6 +39,7 @@ Contents of the package 'tcblistingsutf8.code.tex' LaTeX package file (library of tcolorbox) 'tcbmagazine.code.tex' LaTeX package file (library of tcolorbox) 'tcbminted.code.tex' LaTeX package file (library of tcolorbox) + 'tcbprocessing.code.tex' LaTeX package file (library of tcolorbox) 'tcbraster.code.tex' LaTeX package file (library of tcolorbox) 'tcbskins.code.tex' LaTeX package file (library of tcolorbox) 'tcbskinsjigsaw.code.tex' LaTeX package file (library of tcolorbox) @@ -73,6 +74,7 @@ Alternatively, put the files to their respective locations within the TeX instal 'tcblistingsutf8.code.tex' -> /tex/latex/tcolorbox 'tcbmagazine.code.tex' -> /tex/latex/tcolorbox 'tcbminted.code.tex' -> /tex/latex/tcolorbox + 'tcbprocessing.code.tex' -> /tex/latex/tcolorbox 'tcbraster.code.tex' -> /tex/latex/tcolorbox 'tcbskins.code.tex' -> /tex/latex/tcolorbox 'tcbskinsjigsaw.code.tex' -> /tex/latex/tcolorbox diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdf index e897357e8dd..583c0021d80 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 c93016d972d..565e0488b9e 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.93 (2016/06/01) +%% The LaTeX package tcolorbox - version 3.94 (2016/07/14) %% tcolorbox-example.tex: an example for 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 736ec69c11f..713dde66f2e 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex @@ -3662,6 +3662,27 @@ This issues:\\ |\addcontentsline|\marg{list}\marg{type}\marg{entry text} \end{docTcbKey} + +\begin{docTcbKey}[][doc new=2016-06-22]{nameref}{=\meta{text}}{no default, initially unset} +If the |nameref| package is loaded, the given \meta{text} is used for +corresponding |\nameref| makros. Typically, the \meta{text} will be chosen +to be identical or nearly identical to the one for \refKey{/tcb/title}. + +\inputpreamblelisting{A} + +\begin{dispExample} +\begin{pabox}[label={mynamelabel},nameref={Title or anything else}]{Title text} +This is a tcolorbox. +\end{pabox} +This box is automatically numbered with \ref{mynamelabel} on page +\pageref{mynamelabel}. + +The box is titled '\nameref{mynamelabel}'. +\end{dispExample} +\end{docTcbKey} + + +\clearpage \subsection{Even and Odd Pages} \begin{marker} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex index 20e351c0599..a77651f321c 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex @@ -42,7 +42,7 @@ Source snippets are compiled, if their |md5| checksum has changed. They are not compiled automatically, if option settings are changed or anything outside the snippet is changed. Use \refKey{/tcb/external/force remake} to force compilation in this case -or simply delete the externalized snippets. +or simply delete the externalized pdf oder md5 files. \end{marker} \begin{marker} @@ -575,6 +575,27 @@ This is my \LaTeX\ box. \end{docCommand} +\begin{docCommand}[doc new=2016-07-14]{tcbiffileprocess}{\marg{condition}\marg{source}\marg{md5-file}\marg{target}\marg{true}\marg{false}} + This is a low-level macro which is internally used. + The MD5 digest of a \meta{source} file is compared with + a stored MD5 digest from an auxiliary \meta{md5-file}. + If they are not equal, the auxiliary \meta{md5-file} is updated to + store the current MD5 digest. Further, + \begin{itemize} + \item if \meta{condition} equals |0|, \meta{true} is executed. + \item if \meta{condition} equals |1|:\\ + If the current and stored MD5 digests were different, \meta{true} is executed.\\ + Otherwise, if the \meta{target} file is not existing, \meta{true} is executed.\\ + Otherwise, if the \meta{target} file is older than the \meta{md5-file}, \meta{true} is executed.\\ + Otherwise, \meta{false} is executed. + \item if \meta{condition} equals |2|, \meta{false} is executed. + \end{itemize} + The intended processing purpose of the \meta{true} code is to produce a \meta{target} + file from the given \meta{source} file. +\end{docCommand} + + +\clearpage \subsection{Troubleshooting and FAQ}\label{subsec:external_troubleshooting} \begin{itemize} diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex index 925cb4f1691..4035e9c45ca 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex @@ -15,7 +15,7 @@ See \Vref{sec:skins} for the documentation of all other options of the \mylib{sk \subsection{Macros} -\begin{docCommand}[doc new and updated={2014-11-14}{2016-02-19}]{tcbincludegraphics}{\oarg{options}\marg{file name}} +\begin{docCommand}[doc new and updated={2014-11-14}{2016-07-13}]{tcbincludegraphics}{\oarg{options}\marg{file name}} In principle, this macro includes an image file denoted by \meta{file name} using the standard |\includegraphics| and puts it into a \refEnv{tcolorbox}. The \meta{options} are |tcolorbox| keys to set up the colored box. 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 a2a07810ce7..1cb2ee50bd7 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex @@ -943,6 +943,8 @@ There already is a file |tcolorbox-example.tex| and a PDF file The processing result can be used inside a \refKey{/tcb/comment}. Several \refKey{/tcb/process code} options can be given which are processed in the given order. + Typically, \meta{code} is added by using the following styles + \refKey{/tcb/run system command}, \refKey{/tcb/run pdflatex}, etc. \end{docTcbKey} \begin{marker} @@ -957,6 +959,7 @@ shown in the previous pages. Runs a \meta{system command}, if the document is compiled with the |-shell-escape| permission. The current listing file can be accessed as |\filename@area\filename@base\filename@ext|. +This \meta{system command} is added to \refKey{/tcb/process code}. \end{docTcbKey} @@ -988,7 +991,7 @@ Issues a |pdflatex| compilation of the listing with the given \meta{arguments}. colframe=red!50!black,colback=yellow!10!white, listing options={style=tcblatex,texcsstyle=*\color{red!70!black}}, listing and comment, - pdf comment, + pdf comment,freeze pdf, compilable listing, run pdflatex } @@ -1050,6 +1053,7 @@ Issues a |latex| compilation of the listing with the given \meta{arguments}. Issues a |dvips| compilation of the listing with the given \meta{arguments}. \end{docTcbKey} +\enlargethispage*{1cm} \begin{docTcbKey}[][doc new=2014-11-14]{run ps2pdf}{\colOpt{=\meta{arguments}}}{style, no default, initially unset} Issues a |ps2pdf| compilation of the listing with the given \meta{arguments}. \end{docTcbKey} @@ -1060,11 +1064,12 @@ Issues a |ps2pdf| compilation of the listing with the given \meta{arguments}. colframe=red!50!black,colback=yellow!10!white, listing options={style=tcblatex,texcsstyle=*\color{red!70!black}}, lower separated=false,middle=0pt, - listing side comment,righthand width=4.5cm, + listing side comment,righthand width=4cm, compilable listing, run latex,run dvips,run ps2pdf, - pdf comment, - comment style={raster columns=1,graphics options={viewport=0in 8in 4in 11.5in,clip}}, + pdf comment,freeze pdf, + comment style={raster columns=1, + graphics options={viewport=0.5in 7.7in 3.5in 10.5in,clip}}, } \documentclass{article} \usepackage{pstricks,multido} @@ -1078,6 +1083,55 @@ Issues a |ps2pdf| compilation of the listing with the given \meta{arguments}. \end{dispListing*} {\tcbusetemp} +\clearpage + +\begin{marker} + For most applications, you will like to add \refKey{/tcb/freeze pdf} as option, + since the included |pdf| file is only refreshed, if the source for this file + has changed. +\end{marker} + +\begin{docTcbKey}[][doc new=2016-07-14]{freeze file}{=\meta{file}}{no default, initially unset} + Observes some \meta{file}, usually the final file produced by \refKey{/tcb/process code}, + \refKey{/tcb/run system command}, \refKey{/tcb/run pdflatex}, etc. + If the MD5 checksum of the current \refKey{/tcb/listing file} is unchanged + and \meta{file} exists, the processing is skipped and + the \meta{file} is kept (frozen). + Typically, the style \refKey{/tcb/freeze pdf} can be used for + convenience. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2016-07-14]{freeze none}{}{no default, initially set} + Freeze no file and always execute the given process commands. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2016-07-14]{freeze extension}{=\meta{text}}{style, no default} + Calls \refKey{/tcb/freeze file} with the current \refKey{/tcb/listing file} + stripped with its extension plus \meta{text} as new extension. +\begin{dispListing} + ... + listing file=myfile.tex, + freeze extension=-modified.pdf, % -> myfile-modified.pdf is observed + ... +\end{dispListing} +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2016-07-14]{freeze pdf}{}{no value} + Calls \refKey{/tcb/freeze file} with the current \refKey{/tcb/listing file} + stripped with its extension plus |.pdf| as new extension. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2016-07-14]{freeze png}{}{no value} + Calls \refKey{/tcb/freeze file} with the current \refKey{/tcb/listing file} + stripped with its extension plus |.png| as new extension. + See the examples for \refKey{/tcb/run pdflatex} and \refKey{/tcb/run ps2pdf}. +\end{docTcbKey} + +\begin{docTcbKey}[][doc new=2016-07-14]{freeze jpg}{}{no value} + Calls \refKey{/tcb/freeze file} with the current \refKey{/tcb/listing file} + stripped with its extension plus |.jpg| as new extension. +\end{docTcbKey} + 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 0fbf2d64a0b..4b351a587e3 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 @@ -11,6 +11,7 @@ \RequirePackage[svgnames,table,hyperref]{xcolor} \RequirePackage{tikz} \RequirePackage{varioref} +\RequirePackage[makeindex]{imakeidx} \RequirePackage[pdftex,bookmarks,raiselinks,pageanchor,hyperindex,colorlinks]{hyperref} \RequirePackage{varwidth,cleveref,incgraph} @@ -171,6 +172,7 @@ tcbEXTERNALIZE,tcbifexternal,newtcbexternalizeenvironment, renewtcbexternalizeenvironment,extcolorbox,extikzpicture, newtcbexternalizetcolorbox,renewtcbexternalizetcolorbox, + tcbiffileprocess, % box array newboxarray,boxarraygetsize,boxarrayreset,boxarrayclear, boxarraygetbox,boxarraygetwidth,boxarraygetheight,boxarraygetdepth, diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex index 0ef0f86af09..a1f98a9f666 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex @@ -11,7 +11,7 @@ This also loads the package |amsmath|. \subsection{Macros of the Library} -\begin{docCommand}{newtcbtheorem}{\oarg{init options}\marg{name}\marg{display name}\marg{options}\marg{prefix}} +\begin{docCommand}[doc updated=2016-06-22]{newtcbtheorem}{\oarg{init options}\marg{name}\marg{display name}\marg{options}\marg{prefix}} Creates new environments \meta{name} and \meta{name}|*| based on |tcolorbox| to frame a (mathematical) theorem. The \meta{display name} is used in the title line with a number, e.\,g. \mbox{\flqq Theorem 5.1\frqq}. @@ -24,7 +24,8 @@ This also loads the package |amsmath|. parameters. The optional parameter supplements the options and should be used only in rare cases. The first mandatory parameter is the title text for the theorem and - the second mandatory parameter is a \meta{marker}. The theorem is + is also set as \refKey{/tcb/nameref} identifier. + The second mandatory parameter is a \meta{marker}. The theorem is automatically labeled with \meta{prefix}\meta{separator}\meta{marker} where \meta{separator} is predefined as '|:|', see \refKey{/tcb/label separator}.\par The new environment \meta{name}|*| takes one optional and one mandatory diff --git a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdf index 791afce372e..62f93aa83c8 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 f53bbc715d0..4f9238d2115 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.93 (2016/06/01) +%% The LaTeX package tcolorbox - version 3.94 (2016/07/14) %% tcolorbox.tex: Manual %% %% ------------------------------------------------------------------------------------------- @@ -18,6 +18,12 @@ %% %% This work consists of all files listed in README %% +% arara: pdflatex: { shell: yes } +% arara: biber +% arara: pdflatex: { shell: yes } +% arara: pdflatex: { shell: yes } +% arara: pdflatex: { shell: yes, synctex: yes } +% \documentclass[a4paper,11pt]{ltxdoc} \usepackage{tcolorbox.doc.s_main} @@ -36,8 +42,8 @@ \setlength{\bibitemsep}{\smallskipamount} \addbibresource{tcolorbox.doc.bib} -\def\version{3.93}% -\def\datum{2016/06/01}% +\def\version{3.94}% +\def\datum{2016/07/14}% \makeindex \hypersetup{ @@ -49,18 +55,10 @@ \usepackage{pgfplots} -%\nocite{*} - -% intermediate hack to compensate a biblatex error (3.4) -%\makeatletter -%\def\ifempty#1{% -% \protected@edef\z{#1}% -% \expandafter\ifblank\expandafter{\z}} -%\makeatother - %\tcbset{draftmode} %\includeonly{tcolorbox.doc.listings} + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \begin{document} \include{tcolorbox.doc.abstract} -- cgit v1.2.3