summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/dtxgallery/conditional-code.dtx
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2018-12-25 22:01:21 +0000
committerKarl Berry <karl@freefriends.org>2018-12-25 22:01:21 +0000
commitd5f1d1813f61536f725c3e5b9c5cc4bc604bfb6c (patch)
treee21b7c0840c8ada993a133c2b3b69086a68e13d8 /Master/texmf-dist/doc/latex/dtxgallery/conditional-code.dtx
parentb8ef34526b49483f65102f6cf35338395db613f1 (diff)
dtxgallery .dtx is doc
git-svn-id: svn://tug.org/texlive/trunk@49504 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/dtxgallery/conditional-code.dtx')
-rw-r--r--Master/texmf-dist/doc/latex/dtxgallery/conditional-code.dtx48
1 files changed, 48 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/dtxgallery/conditional-code.dtx b/Master/texmf-dist/doc/latex/dtxgallery/conditional-code.dtx
new file mode 100644
index 00000000000..658ff48ed18
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/dtxgallery/conditional-code.dtx
@@ -0,0 +1,48 @@
+% \iffalse meta-comment
+%
+% Part of Will Robertson's DTXGALLERY bundle, version 1.
+%
+%<*driver>
+\documentclass{ltxdoc}
+\usepackage{fancyvrb}
+\begin{document}
+ \DocInput{conditional-code.dtx}
+\end{document}
+%</driver>
+% \fi
+%
+% \section{Conditional inclusion of code}
+%
+% From previous examples the |%<*guard>|\dots|%</guard>| syntax should be a little familiar. This example demonstrates conditional extraction of such elements in the source document into multiple files. This technique makes it easy, say, to maintain a `debug' version of a package without polluting the public source with code for testing.
+%
+% \begin{macrocode}
+%<A> code in `A'
+%<B> code in `B'
+%<!A> code not in `A'
+%<!B> code not in `B'
+%<A&B> code in `A' and `B'
+%<A|B> code in `A' or `B'
+%<(A|B)&!(A&B)> code in `A' xor `B'
+% \end{macrocode}
+% Note the change in the typeset source when guards are nested: \\
+% (this is equivalent to \verb|%<A&B>|)
+% \begin{macrocode}
+%<*A>
+%<B> `B' nested inside `A'
+%</A>
+% \end{macrocode}
+%
+% \section{Verbatim files that are produced}
+% \begin{minipage}{0.45\linewidth}
+% \subsection{Generated from `A'}
+% \VerbatimInput[frame=single]{A.txt}
+% \end{minipage}\hfill
+% \begin{minipage}{0.45\linewidth}
+% \subsection{Generated from `B'}
+% \VerbatimInput[frame=single]{B.txt}
+% \end{minipage}
+% \subsection{Generated from `A' and `B'}
+% \VerbatimInput[frame=single]{AB.txt}
+%
+% \Finale
+\endinput