excludeonly doc update

git-svn-id: svn://tug.org/texlive/trunk@17262 c570f23f-e606-0410-a88d-b1316a301751

6 files changed, 94 insertions, 2 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
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}
+
+
+
+
+
diff --git a/Master/texmf-dist/tex/latex/ltxmisc/excludeonly.sty b/Master/texmf-dist/tex/latex/excludeonly/excludeonly.sty
index 91c07aef022..91c07aef022 100644
--- a/Master/texmf-dist/tex/latex/ltxmisc/excludeonly.sty
+++ b/Master/texmf-dist/tex/latex/excludeonly/excludeonly.sty
diff --git a/Master/tlpkg/bin/tlpkg-ctan-check b/Master/tlpkg/bin/tlpkg-ctan-check
index 7579842c946..d5648ea5a67 100755
--- a/Master/tlpkg/bin/tlpkg-ctan-check
+++ b/Master/tlpkg/bin/tlpkg-ctan-check
@@ -111,8 +111,8 @@ my @TLP_working = qw(
     ESIEEcv erdc esdiff esint esint-type1 eskd eskdx eso-pic esvect
     estcpmm
     etaremune etex-pkg ethiop ethiop-t1 etoolbox euenc eukdate
-    eulervm euproposal euro europecv eurosans eurosym
-    everypage exam examdesign examplep exercise exp-testopt
+    euler eulervm euproposal euro europecv eurosans eurosym
+    everypage exam examdesign examplep excludeonly exercise exp-testopt
     expdlist expl3 expressg extarrows exteps
     extpfeil extract extsizes
   faktor fancybox fancyhdr fancynum fancyref fancytooltips fancyvrb
diff --git a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
index 4e9be8494c7..46c9a211b5f 100644
--- a/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
+++ b/Master/tlpkg/tlpsrc/collection-latexextra.tlpsrc
@@ -198,6 +198,7 @@ depend everypage
 depend exam
 depend examdesign
 depend examplep
+depend excludeonly
 depend exercise
 depend exp-testopt
 depend expdlist
diff --git a/Master/tlpkg/tlpsrc/excludeonly.tlpsrc b/Master/tlpkg/tlpsrc/excludeonly.tlpsrc
new file mode 100644
index 00000000000..e69de29bb2d
--- /dev/null
+++ b/Master/tlpkg/tlpsrc/excludeonly.tlpsrc