summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-03-31 22:28:56 +0000
committerKarl Berry <karl@freefriends.org>2014-03-31 22:28:56 +0000
commit0b84dfe8877345df35ceb87ec739c298dcc72b92 (patch)
tree5249c2f500210cb8b8d27fbc6fb594a91b5545e7 /Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
parentc17623666aa19d3dda7d2ba547d2a877df300d76 (diff)
tcolorbox (31mar14)
git-svn-id: svn://tug.org/texlive/trunk@33340 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.tex19
1 files changed, 15 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 041e9281896..58d6c7c8a7a 100644
--- a/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
+++ b/Master/texmf-dist/doc/latex/tcolorbox/tcolorbox.doc.listings.tex
@@ -190,9 +190,15 @@ This \textbf{text} is written to a standardized file for later usage.
\clearpage
\begin{marker}
-It is not recommended that a new sort of |tcblisting| environment is created with
-one optional argument only. If there is just one argument, it should be made
-mandatory to avoid content scanning problems.
+See \Vref{subsec:xparse_listing} and \Vref{subsec:xparse_inputlisting} for more
+elaborate methods to create new environments and commands.
+\end{marker}
+\begin{marker}
+If a new sort of |tcblisting| environments should be created with
+one optional argument only, one is highly recommended to use
+\refCom{DeclareTCBListing} or \refCom{NewTCBListing}
+instead of \refCom{newtcblisting} to
+avoid content scanning problems.
\end{marker}
\begin{docCommand}{newtcblisting}{\oarg{init options}\marg{name}\oarg{number}\oarg{default}\marg{options}}
@@ -269,7 +275,7 @@ This is my \LaTeX\ box.
\begin{docCommand}{newtcbinputlisting}{\oarg{init options}\brackets{\texttt{\textbackslash}\rmfamily\meta{name}}\oarg{number}\oarg{default}\marg{options}}
Creates a new macro \texttt{\textbackslash}\meta{name} based on \refCom{tcbinputlisting}.
Basically, |\newtcbinputlisting| operates like |\newcommand|.
- The new macro \texttt{\textbackslash}\meta{name} optionally takes \meta{number}$+1$ arguments, where
+ The new macro \texttt{\textbackslash}\meta{name} optionally takes \meta{number} arguments, where
\meta{default} is the default value for the optional first argument.
The \meta{options} are given to the underlying |tcbinputlisting|.
The \meta{init options} allow setting up automatic numbering,
@@ -404,6 +410,11 @@ cd /usr/lib
See further options in \Vref{sec:commonlistingkeys}.
+\begin{marker}
+For an combined example of using |\lstinline| inside a |tcolorbox|, see
+\refCom{DeclareTotalTCBox}.
+\end{marker}
+
\clearpage
\subsection{Option Keys of the \mylib{listingsutf8} Library}
The \mylib{listingsutf8} library is an extension of the