version-doc (2apr11)

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

2 files changed, 104 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/version/version-doc.pdf b/Master/texmf-dist/doc/latex/version/version-doc.pdf
new file mode 100644
index 00000000000..26d9a3abe85
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/version/version-doc.pdf
diff --git a/Master/texmf-dist/doc/latex/version/version-doc.tex b/Master/texmf-dist/doc/latex/version/version-doc.tex
new file mode 100644
index 00000000000..72b53341e2c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/version/version-doc.tex
@@ -0,0 +1,104 @@
+\documentclass[pagesize=auto, fontsize=12pt, DIV=10]{scrartcl}
+
+\usepackage{fixltx2e}
+\usepackage{etex}
+\usepackage{xspace}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\usepackage[svgnames]{xcolor}
+\usepackage{listings}
+\usepackage{microtype}
+\usepackage{hyperref}
+
+\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{#1}}}
+\newcommand*{\pkg}[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*{\meta}[1]{\textlangle\textsl{#1}\textrangle}
+\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}}
+\newcommand*{\oarg}[1]{\texttt{[}\meta{#1}\texttt{]}}
+
+\addtokomafont{title}{\rmfamily}
+
+\lstset{%
+  language=[LaTeX]TeX,%
+  columns=flexible,%
+  upquote=true,%
+  numbers=left,%
+  basicstyle=\ttfamily,%
+  keywordstyle=\color{Navy},%
+  commentstyle=\color{DimGray},%
+  stringstyle=\color{SeaGreen},%
+  numberstyle=\scriptsize\color{SlateGray}%
+}
+
+\title{The \pkg{version} package\thanks{This manual corresponds to \pkg{version.sty}~v2.0, dated~2009/09/15.}}
+\author{Donald Arseneau\thanks{\mail{asnd@triumf.ca}}\and Stephen Bellantoni}
+\date{2009/09/15}
+
+
+\begin{document}
+
+\maketitle
+
+\noindent
+Version control macros. This package lets you define environments whose
+contents will be optionally included in or excluded from the text when
+you run \LaTeX.
+
+Maybe you should be using one of \pkg{versions.sty}, \pkg{comment.sty}, or \pkg{optional.sty}.
+
+
+\section{Usage:}
+
+\begin{description}
+\item[\cmd{\includeversion}\marg{name}] \leavevmode \\
+  After this declaration, contents of the environment \meta{name}, that is,
+  text between \cmd{\begin}\marg{name} and \cmd{\end}\marg{name}, will be processed in the 
+  normal way.  If an environment called \meta{name} is already defined, that
+  definition is retained; if no such environment exists a simple 
+  definition is provided.
+
+\item[\cmd{\excludeversion}\marg{name}] \leavevmode \\
+  This indicates that text between \cmd{\begin}\marg{name} and \cmd{\end}\marg{name} will
+  be totally deleted. Very long sections of excluded text might cause 
+  a `\TeX\ capacity exceeded' error.  Exclusion ends with the first
+  detected \cmd{\end}\marg{name}, even if there are additional \cmd{\begin}\marg{name} 
+  declarations in the skipped text; that is, nesting of environments
+  is not permitted.  Skipped text may have unbalanced braces, if
+  they would also work in the \cmd{\includeversion} case.
+
+\item[\cmd{\excludeversion}\oarg{text}\marg{name}] \leavevmode \\
+  This indicates that text between \cmd{\begin}\marg{name} and \cmd{\end}\marg{name} will
+  be replaced by the specified \meta{text}.
+\end{description}
+
+You can define environments for as many versions as you want.
+A `\env{comment}' environment has already been pre-defined with
+\verb+\excludeversion{comment}+; you can override this by declaring 
+\verb+\includeversion{comment}+.
+
+
+\section{Example:}
+
+\begin{lstlisting}
+\includeversion{abridged}\excludeversion{unabridged}
+\excludeversion[(redacted)]{redact}
+Text for the
+\begin{abridged}
+   short
+\end{abridged}
+\begin{unabridged}
+   long and really longwinded, opaque and boring
+\end{unabridged}
+version of the paper. Punctuation works correctly\begin{unabridged}
+because sphack is used\end{unabridged}.
+\begin{comment} This is deleted by default. \end{comment}
+\begin{redact}This information was withdrawn\end{redact}
+\end{lstlisting}
+
+\end{document}