summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/excludeonly
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-03-01 19:11:26 +0000
committerKarl Berry <karl@freefriends.org>2010-03-01 19:11:26 +0000
commit9f8fd8db30dc93707b8856e6bf3112e90910b59b (patch)
tree0257321c8f0307b1382afc09c8690857fc07a927 /Master/texmf-dist/doc/latex/excludeonly
parenta4ccbaf816abbb1e345ee1b5a849886338322110 (diff)
excludeonly doc update
git-svn-id: svn://tug.org/texlive/trunk@17262 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/excludeonly')
-rw-r--r--Master/texmf-dist/doc/latex/excludeonly/excludeonly.pdfbin0 -> 224457 bytes
-rw-r--r--Master/texmf-dist/doc/latex/excludeonly/excludeonly.tex91
2 files changed, 91 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/excludeonly/excludeonly.pdf b/Master/texmf-dist/doc/latex/excludeonly/excludeonly.pdf
new file mode 100644
index 00000000000..aeaeb0ed3ff
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/excludeonly/excludeonly.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/excludeonly/excludeonly.tex b/Master/texmf-dist/doc/latex/excludeonly/excludeonly.tex
new file mode 100644
index 00000000000..fa13a83f619
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/excludeonly/excludeonly.tex
@@ -0,0 +1,91 @@
+\documentclass[pagesize=auto]{scrartcl}
+
+\usepackage{fixltx2e}
+\usepackage{etex}
+\usepackage{xspace}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\usepackage{booktabs}
+\usepackage{microtype}
+\usepackage[unicode=true]{hyperref}
+
+\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{<#1>}}}
+\newcommand*{\pkg}[1]{\textsf{#1}}
+\newcommand*{\cls}[1]{\textsf{#1}}
+\newcommand*{\cs}[1]{\texttt{\textbackslash#1}}
+\makeatletter
+\newcommand*{\cmd}[1]{\cs{\expandafter\@gobble\string#1}}
+\makeatother
+\newcommand*{\env}[1]{\texttt{#1}}
+\newcommand*{\opt}[1]{\texttt{#1}}
+\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle}
+\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}}
+\newcommand*{\oarg}[1]{\texttt{[}\meta{#1}\texttt{]}}
+\newcommand*{\BibTeX}{Bib\kern-0.08em\TeX\@\xspace}
+\newcommand*{\BigTeX}{Big\kern-0.08em\TeX\@\xspace}
+
+\pdfstringdefDisableCommands{%
+ \def\BibTeX{BibTeX\xspace}%
+ \def\BigTeX{BigTeX\space}%
+}
+
+\addtokomafont{title}{\rmfamily}
+
+\title{The \pkg{excludeonly} package}
+\author{Dan Luecking \mail{luecking@uark.edu}\and Donald Arseneau \mail{asnd@triumf.ca}}
+\date{2003/03/14}
+
+
+\begin{document}
+
+\maketitle
+
+\noindent
+This software is contributed to the public domain.
+
+
+\section{Usage:}
+
+In the document preamble, ``\verb+\excludeonly{+\meta{aaa}\verb+,+\meta{bbb}\verb+}+'' will prevent files
+\texttt{\meta{aaa}.tex} and \texttt{\meta{bbb}.tex} from being typeset by \cmd{\include}\marg{aaa} and \cmd{\include}\marg{bbb}.
+If both \cmd{\includeonly} and \cmd{\excludeonly} are used, then only the files
+permitted by both declarations are used:
+%
+\begin{flushleft}
+\verb+\includeonly{+\meta{aaa}\verb+,+\meta{bbb}\verb+}+\\
+\verb+\excludeonly{+\meta{bbb}\verb+,+\meta{ccc}\verb+}+
+\end{flushleft}
+%
+results in only \meta{aaa} being included.
+This behavior contradicts the name ``exclude only'' but the name is
+desirable anyway to show the relationship with \cmd{\includeonly}.
+
+In case it is actually desireable that \cmd{\excludeonly} lives up
+to its name, and causes \emph{all} parts to be included, except those
+explicitly listed for exclusion, there is an \opt{[only]} package option
+%
+\begin{verbatim}
+\usepackage[only]{excludeonly}
+\end{verbatim}
+%
+The effect of this is to override any \cmd{\includeonly} commands.
+
+
+\section{Conflicts:}
+
+This package redefines the internal \cmd{\@include} command, so it could
+conflict with other redefinitions. Known conflicts are with document
+classes ``\cls{paper.cls}'' and ``\cls{thesis.cls}'' by Wenzel Matiaske.
+
+A different method for implementing \cmd{\excludeonly} would be to
+redefine \cmd{\@setckpt} to compile a file-inclusion list (\cmd{\@partlist})
+that accounts for exclusions. Surprisingly, several packages
+redefine \cmd{\@setckpt}, so this alternative would have more conflicts.
+
+\end{document}
+
+
+
+
+