summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2016-07-14 21:41:30 +0000
committerKarl Berry <karl@freefriends.org>2016-07-14 21:41:30 +0000
commit2d5135a3daaa80ca6f8878e7296bd5cbd0041cd5 (patch)
tree07fd3e88c1db56ee4d86fcc7e4d5bd893d9e2341 /Master/texmf-dist/doc/latex/tcolorbox
parent15d8e872670cad2846331dc4843baf948fdac3dd (diff)
tcolorbox (14jul16)
git-svn-id: svn://tug.org/texlive/trunk@41700 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/CHANGES15
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/README4
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.pdfbin458241 -> 458241 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox-example.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.coreoptions.tex21
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.external.tex23
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.graphics.tex2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex62
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.s_main.sty2
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.theorems.tex5
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.pdfbin6811114 -> 6835148 bytes
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.tex22
12 files changed, 135 insertions, 23 deletions
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 <thomas dot sturm at unibw dot de>
@@ -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 <thomas dot sturm at unibw dot de>
@@ -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
--- 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 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
--- 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 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}