diff options
author | Karl Berry <karl@freefriends.org> | 2018-12-07 22:51:38 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2018-12-07 22:51:38 +0000 |
commit | b15665291da56772687808588be2d9dee0d24094 (patch) | |
tree | cda65bb78e3a37f5b5d391183afbf80106105fb8 /Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex | |
parent | bb1558cb26ede059918baaf838e0cd0a23415548 (diff) |
tcolorbox (7dec18)
git-svn-id: svn://tug.org/texlive/trunk@49347 c570f23f-e606-0410-a88d-b1316a301751
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.tex | 34 |
1 files changed, 17 insertions, 17 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 4595965f832..4dfec5e94e8 100644 --- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex +++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex @@ -25,12 +25,12 @@ the settings of a previous loaded library. A library is never loaded twice. \subsubsection{Loading \mylib{listings}} -This library uses the package |listings| \cite{heinz:2015a} to typeset +This library uses the package |listings| \cite{hoffmann:2018a} to typeset listings. It is loaded by a package option or inside the preamble by: \begin{dispListing} \tcbuselibrary{listings} \end{dispListing} -This also loads the package |listings| \cite{heinz:2015a}. +This also loads the package |listings| \cite{hoffmann:2018a}. The \refKey{/tcb/listing engine} is set to |listings| by the library. To reactivate this setting, if overwritten by other libraries, use @@ -43,15 +43,15 @@ To reactivate this setting, if overwritten by other libraries, use This library is not needed (and troublesome) when using Xe\LaTeX. \end{marker} To extend |listings| for UTF-8 encoded sources, you can use the support from -the package |listingsutf8| \cite{oberdiek:2011a} by loading the library +the package |listingsutf8| \cite{oberdiek:2016b} by loading the library variant \mylib{listingsutf8}. \begin{dispListing} \tcbuselibrary{listingsutf8} \tcbset{listing utf8=latin1}% optional; 'latin1' is the default. \end{dispListing} This also loads the library \mylib{listings} -and the packages |listings| \cite{heinz:2015a} -and |listingsutf8| \cite{oberdiek:2011a}. +and the packages |listings| \cite{hoffmann:2018a} +and |listingsutf8| \cite{oberdiek:2016b}. The \refKey{/tcb/listing engine} is set to |listings| by the library. To reactivate this setting, if overwritten by other libraries, use @@ -62,19 +62,19 @@ To reactivate this setting, if overwritten by other libraries, use \clearpage \subsubsection{Loading \mylib{minted}} -This library uses the package |minted| \cite{poore:2015a} to typeset +This library uses the package |minted| \cite{poore:minted} to typeset listings. It is loaded by a package option or inside the preamble by: \begin{dispListing} \tcbuselibrary{minted} \end{dispListing} -This also loads the package |minted| \cite{poore:2015a}. +This also loads the package |minted| \cite{poore:minted}. \begin{marker} -The |minted| package uses the external tool |Pygments| \cite{pygments:2013} +The |minted| package uses the external tool |Pygments| \cite{pygments:web} to apply syntax highlighting. It has to be installed and set up, before the -library can be used, see \cite{poore:2015a} and \cite{pygments:2013}. +library can be used, see \cite{poore:minted} and \cite{pygments:web}. The |tcolorbox| library \mylib{minted} does not work, if the package -|minted| \cite{poore:2015a} does not work. +|minted| \cite{poore:minted} does not work. \end{marker} The \refKey{/tcb/listing engine} is set to |minted| by the library. @@ -320,7 +320,7 @@ This is my \LaTeX\ box. \subsection{Option Keys of the \mylib{listings} Library}\label{sec:speclistingkeys} \begin{docTcbKey}{listing options}{=\meta{key list}}{no default, initially |style=tcblatex|} - Sets the options from the package |listings| \cite{heinz:2015a} + Sets the options from the package |listings| \cite{hoffmann:2018a} which are used during typesetting of the listing. For \LaTeX\ listings, there is a predefined |listings| style named |tcblatex| which can be used. @@ -350,7 +350,7 @@ All \textit{listings} options removed. \begin{docTcbKey}{listing style}{=\meta{style}}{no default, initially |tcblatex|} Abbreviation for |listing options={style=...}|. This key sets a \meta{style} - for the |listings| package, see \cite{heinz:2015a}. + for the |listings| package, see \cite{hoffmann:2018a}. For \LaTeX, there is a predefined style named |tcblatex|. \begin{dispExample} \begin{tcblisting}{colback=red!5!white,colframe=red!75!black, @@ -431,10 +431,10 @@ all options from \Vref{sec:speclistingkeys} are applicable. \begin{docTcbKey}{listing utf8}{=\meta{one-byte-encoding}}{style, no default, initially |latin1|} Abbreviation for using \refKey{/tcb/listing inputencoding} - together with UTF-8 support from the package |listingsutf8| \cite{oberdiek:2011a}. + together with UTF-8 support from the package |listingsutf8| \cite{oberdiek:2016b}. 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:2016b}, 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 @@ -452,7 +452,7 @@ See further options in \Vref{sec:commonlistingkeys}. \subsection{Option Keys of the \mylib{minted} Library} \begin{docTcbKey}{minted language}{=\meta{programming language}}{no default, initially |latex|} -Sets a \meta{programming language} known to |Pygments| \cite{pygments:2013}. +Sets a \meta{programming language} known to |Pygments| \cite{pygments:web}. \begin{dispExample} \begin{tcblisting}{listing engine=minted,minted style=trac, minted language=java, @@ -470,7 +470,7 @@ Sets a \meta{programming language} known to |Pygments| \cite{pygments:2013}. \begin{docTcbKey}[][doc updated={2017-07-05}]{minted options}{=\meta{key list}}{no default, initially |tabsize=2,fontsize=\textbackslash small,|\linebreak|breaklines,autogobble|} - Sets the options from the package |minted| \cite{poore:2015a} + Sets the options from the package |minted| \cite{poore:minted} which are used during typesetting of the listing. \begin{dispExample} % \tcbuselibrary{skins} @@ -496,7 +496,7 @@ Sets a \meta{programming language} known to |Pygments| \cite{pygments:2013}. \clearpage \begin{docTcbKey}{minted style}{=\meta{style}}{no default, initially unset} -Sets a \meta{style} known to |Pygments| \cite{pygments:2013}. This is +Sets a \meta{style} known to |Pygments| \cite{pygments:web}. This is independent from \refKey{/tcb/minted options}. Note that styles are always applied globally; all following examples will be set in the given \meta{style} until a new style is set. Also note that |