summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/excludeonly/excludeonly.tex
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /macros/latex/contrib/excludeonly/excludeonly.tex
Initial commit
Diffstat (limited to 'macros/latex/contrib/excludeonly/excludeonly.tex')
-rw-r--r--macros/latex/contrib/excludeonly/excludeonly.tex91
1 files changed, 91 insertions, 0 deletions
diff --git a/macros/latex/contrib/excludeonly/excludeonly.tex b/macros/latex/contrib/excludeonly/excludeonly.tex
new file mode 100644
index 0000000000..fa13a83f61
--- /dev/null
+++ b/macros/latex/contrib/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}
+
+
+
+
+