From 9f8fd8db30dc93707b8856e6bf3112e90910b59b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 1 Mar 2010 19:11:26 +0000 Subject: excludeonly doc update git-svn-id: svn://tug.org/texlive/trunk@17262 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/excludeonly/excludeonly.pdf | Bin 0 -> 224457 bytes .../doc/latex/excludeonly/excludeonly.tex | 91 +++++++++++++++++++++ 2 files changed, 91 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/excludeonly/excludeonly.pdf create mode 100644 Master/texmf-dist/doc/latex/excludeonly/excludeonly.tex (limited to 'Master/texmf-dist/doc/latex/excludeonly') 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/excludeonly/excludeonly.pdf 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} + + + + + -- cgit v1.2.3