summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex')
-rw-r--r--Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex62
1 files changed, 58 insertions, 4 deletions
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}
+