trunk/Master/texmf-dist/source/latex/tocvsec2

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

3 files changed, 584 insertions, 0 deletions

diff --git a/Master/texmf-dist/source/latex/tocvsec2/README b/Master/texmf-dist/source/latex/tocvsec2/README
new file mode 100644
index 00000000000..25d1e4c572e
--- /dev/null
+++ b/Master/texmf-dist/source/latex/tocvsec2/README
@@ -0,0 +1,24 @@
+    The tocvsec2 package provides control over sectional numbering and/or the
+entries in the Table of Contents on a section by section basis. It is a
+replacement for the tocvsec package.
+NB. The tocvsec2 package also requires the stdclsdv and ifthen packages.
+
+    The distribution consists of the following files:
+README (this file)
+tocvsec2.ins
+tocvsec2.dtx
+
+    The distribution is provided under the terms of the LaTeX
+Project Public License (LPPL).
+
+    To install the package:
+o run: latex tocvsec2.ins (which will generate tocvsec2.sty)
+o run: latex tocvsec2.dtx
+o run: makeindex -s gind.ist tocvsec2
+o run: latex tocvsec2.dtx
+o Print tocvsec2.dvi for a hardcopy of the package manual 
+o Move tocvsec2.sty to a location where LaTeX will find it.
+
+1999/01/17
+Peter Wilson
+peter.r.wilson@boeing.com
diff --git a/Master/texmf-dist/source/latex/tocvsec2/tocvsec2.dtx b/Master/texmf-dist/source/latex/tocvsec2/tocvsec2.dtx
new file mode 100644
index 00000000000..cae5db10a1d
--- /dev/null
+++ b/Master/texmf-dist/source/latex/tocvsec2/tocvsec2.dtx
@@ -0,0 +1,500 @@
+% \iffalse meta-comment
+%
+% tocvsec2.dtx
+% Copyright 1999 Peter R. Wilson
+%
+% This program is provided under the terms of the
+% LaTeX Project Public License distributed from CTAN
+% archives in directory macros/latex/base/lppl.txt.
+%
+% Author: Peter Wilson (CUA and NIST) (now at: peter.r.wilson@boeing.com)
+% 
+% 
+%<*driver>
+\documentclass{ltxdoc}
+\EnableCrossrefs
+\CodelineIndex
+\setcounter{StandardModuleDepth}{1}
+\begin{document}
+  \DocInput{tocvsec2.dtx}
+\end{document}
+%</driver>
+%
+% \fi
+%
+% \CheckSum{147}
+%
+% \DoNotIndex{\',\.,\@M,\@@input,\@addtoreset,\@arabic,\@badmath}
+% \DoNotIndex{\@centercr,\@cite}
+% \DoNotIndex{\@dotsep,\@empty,\@float,\@gobble,\@gobbletwo,\@ignoretrue}
+% \DoNotIndex{\@input,\@ixpt,\@m}
+% \DoNotIndex{\@minus,\@mkboth,\@ne,\@nil,\@nomath,\@plus,\@set@topoint}
+% \DoNotIndex{\@tempboxa,\@tempcnta,\@tempdima,\@tempdimb}
+% \DoNotIndex{\@tempswafalse,\@tempswatrue,\@viipt,\@viiipt,\@vipt}
+% \DoNotIndex{\@vpt,\@warning,\@xiipt,\@xipt,\@xivpt,\@xpt,\@xviipt}
+% \DoNotIndex{\@xxpt,\@xxvpt,\\,\ ,\addpenalty,\addtolength,\addvspace}
+% \DoNotIndex{\advance,\Alph,\alph}
+% \DoNotIndex{\arabic,\ast,\begin,\begingroup,\bfseries,\bgroup,\box}
+% \DoNotIndex{\bullet}
+% \DoNotIndex{\cdot,\cite,\CodelineIndex,\cr,\day,\DeclareOption}
+% \DoNotIndex{\def,\DisableCrossrefs,\divide,\DocInput,\documentclass}
+% \DoNotIndex{\DoNotIndex,\egroup,\ifdim,\else,\fi,\em,\endtrivlist}
+% \DoNotIndex{\EnableCrossrefs,\end,\end@dblfloat,\end@float,\endgroup}
+% \DoNotIndex{\endlist,\everycr,\everypar,\ExecuteOptions,\expandafter}
+% \DoNotIndex{\fbox}
+% \DoNotIndex{\filedate,\filename,\fileversion,\fontsize,\framebox,\gdef}
+% \DoNotIndex{\global,\halign,\hangindent,\hbox,\hfil,\hfill,\hrule}
+% \DoNotIndex{\hsize,\hskip,\hspace,\hss,\if@tempswa,\ifcase,\or,\fi,\fi}
+% \DoNotIndex{\ifhmode,\ifvmode,\ifnum,\iftrue,\ifx,\fi,\fi,\fi,\fi,\fi}
+% \DoNotIndex{\input}
+% \DoNotIndex{\jobname,\kern,\leavevmode,\let,\leftmark}
+% \DoNotIndex{\list,\llap,\long,\m@ne,\m@th,\mark,\markboth,\markright}
+% \DoNotIndex{\month,\newcommand,\newcounter,\newenvironment}
+% \DoNotIndex{\NeedsTeXFormat,\newdimen}
+% \DoNotIndex{\newlength,\newpage,\nobreak,\noindent,\null,\number}
+% \DoNotIndex{\numberline,\OldMakeindex,\OnlyDescription,\p@}
+% \DoNotIndex{\pagestyle,\par,\paragraph,\paragraphmark,\parfillskip}
+% \DoNotIndex{\penalty,\PrintChanges,\PrintIndex,\ProcessOptions}
+% \DoNotIndex{\protect,\ProvidesClass,\raggedbottom,\raggedright}
+% \DoNotIndex{\refstepcounter,\relax,\renewcommand,\reset@font}
+% \DoNotIndex{\rightmargin,\rightmark,\rightskip,\rlap,\rmfamily,\roman}
+% \DoNotIndex{\roman,\secdef,\selectfont,\setbox,\setcounter,\setlength}
+% \DoNotIndex{\settowidth,\sfcode,\skip,\sloppy,\slshape,\space}
+% \DoNotIndex{\symbol,\the,\trivlist,\typeout,\tw@,\undefined,\uppercase}
+% \DoNotIndex{\usecounter,\usefont,\usepackage,\vfil,\vfill,\viiipt}
+% \DoNotIndex{\viipt,\vipt,\vskip,\vspace}
+% \DoNotIndex{\wd,\xiipt,\year,\z@}
+%
+% \changes{v1.0}{1999/01/17}{First public release}
+% \changes{v1.1}{1999/01/24}{Added none and all `sections'}
+% \changes{v1.1}{1999/01/24}{Added maxsecnumdepth command}
+%
+% \def\fileversion{v1.1}
+% \def\filedate{1999/01/24}
+% \newcommand*{\Lpack}[1]{\textsf {#1}}           ^^A typeset a package
+% \newcommand*{\Lopt}[1]{\textsf {#1}}            ^^A typeset an option
+% \newcommand*{\file}[1]{\texttt {#1}}            ^^A typeset a file
+% \newcommand*{\Lcount}[1]{\textsl {\small#1}}    ^^A typeset a counter
+% \newcommand*{\pstyle}[1]{\textsl {#1}}          ^^A typeset a pagestyle
+% \newcommand*{\Lenv}[1]{\texttt {#1}}            ^^A typeset an environment
+%
+% \title{The \Lpack{tocvsec2} package\thanks{This
+%        file has version number \fileversion, last revised
+%        \filedate.}}
+%
+% \author{%
+% Peter Wilson\\
+% Catholic University of America\thanks{This work was originally
+% performed as
+% a Guest Researcher at the National Institute of Standards and Technology.} \\
+% Now at {\tt peter.r.wilson@boeing.com}
+% }
+% \date{\filedate}
+% \maketitle
+% \begin{abstract}
+%    The \Lpack{tocvsec2} package provides means of controlling the sectional 
+% numbering and/or the entries
+% in the Table of Contents on a section by section basis.
+% It is a replacement for the \Lpack{tocvsec} package, which should 
+% not be used.
+% Use of the
+% package requires the \Lpack{stdclsdv} and \Lpack{ifthen} packages to be available.
+% \end{abstract}
+% \tableofcontents
+%
+% \StopEventually{}
+%
+% 
+%
+% \section{Introduction}
+%
+% In the standard classes two commands are used to control the numbering
+% of sectional divisions in a document, and which level of sectional
+% headings will be included in the Table of Contents (the ToC). Sometimes
+% finer control of these aspects of \LaTeX{} is required. The \Lpack{tocvsec2}
+% provides for control over the entries into the ToC on a section by section
+% basis. It also provides a means of locally controlling sectional numbering
+% without having to resort to the starred version of the sectional commands.
+% The package requires the \Lpack{stdclsdv} and \Lpack{ifthen} packages 
+% to be available.
+% 
+% 
+% Portions of the package were developed as part of a class
+% and package bundle for typesetting ISO standards~\cite{PRW96i}.
+% This manual is typeset according to the conventions of the
+% \LaTeX{} \textsc{docstrip} utility which enables the automatic
+% extraction of the \LaTeX{} macro source files~\cite{GOOSSENS94}.
+%
+%    Section~\ref{sec:usc} describes the usage of the package.
+% Commented source code for the package is in Section~\ref{sec:code}.
+%
+% \DescribeMacro{secnumdepth}
+% The \LaTeX{} \Lcount{secnumdepth} counter specifies the level number
+% for the least significant
+% sectional heading that will be numbered. In all the standard classes
+% |\section| has a level number of 1, |\subsection| has a level number
+% of 2, and so on. In the \Lpack{article} class (and its derivatives), 
+% |\part| has a level number of 0. In the \Lpack{book} and \Lpack{report}
+% classes, |\chapter| is level number 0 and |\part| has level number -1.
+%
+% The \Lcount{secnumdepth} counter is normally set in the preamble and
+% remains constant thereafter. For example:
+% \begin{verbatim}
+% \setcounter{secnumdepth}{2}
+% \end{verbatim}
+% specifies that |\subsection|s and above should be numbered and
+% |\subsubsections| and below should not be numbered. It turns out
+% that \Lcount{secnumdepth} can be changed at any point in a document, not
+% just in the preamble, to make a (temporary) change to the section numbering
+% level. This is possible because the heading commands check the value
+% of \Lcount{secnumdepth} to decide whether or not to number the heading.
+%
+% \DescribeMacro{tocdepth}
+% The \Lcount{tocdepth} counter specifies the level number of the least 
+% significant sectional unit that will be listed in the printed Table of
+% Contents (ToC). For example:
+% \begin{verbatim}
+% \setcounter{tocdepth}{1}
+% \end{verbatim}
+% specifies that the printed ToC should only list sectional headings down
+% to the |\section| level. The value of \Lcount{tocdepth} has to be set
+% before the |\tableofcontents| command is used. Each sectioning command 
+% puts an entry into the \file{.toc} file, irrespective of the \Lcount{tocdepth}
+% value. The code implementing the typesetting of the ToC uses 
+% \Lcount{tocdepth} to determine whether or not an entry should be printed.
+% Thus, unlike \Lcount{secnumdepth} which can be altered at any time and have
+% an effect, it is only the value of \Lcount{tocdepth} at the time of 
+% printing the entries in the |\tableofcontents| that is used --- 
+% any subsequent changes to 
+% \Lcount{tocdepth} are immaterial.
+%
+% Note that \Lcount{tocdepth} only controls what appears in the ToC,
+% and \Lcount{secnumdepth} only controls which sectional headings are
+% numbered. The effect of changing one has no bearing on the other.
+%
+% \section{The \Lpack{tocvsec2} package} \label{sec:usc}
+%
+% The \Lpack{tocvsec} package changed the way in which entries were written
+% to the \file{.toc} file, enabling effective changes to be made to
+% \Lcount{tocdepth} at any point in a document.
+%
+% The basis of that package was to ensure that only those sectional elements
+% that were required to appear in the printed ToC were written to the \file{.toc}
+% file. The sectional commands call the |\addcontentsline| command to
+% write an entry to the \file{.toc} file.
+% There were two methods to achieve the desired functionality, both of which 
+% required
+% modifications to the internal \LaTeX{} macros.
+% \begin{enumerate}
+% \item Modify the sectional commands so that they check the value of
+% \Lcount{tocdepth} in order to decide whether or not to put an entry
+% into the \file{.toc} file (i.e., call |\addcontentsline|).
+% \item Modify |\addcontentsline| so that it decides whether or not to write
+% to the \file{.toc} file. This is less efficient in terms of processing
+% time than changing the sectional commands.
+% \end{enumerate}
+%
+% Both approaches had disadvantages. If the \Lpack{tocvsec} package
+% changed the sectional commands and it was used in conjunction with
+% another package that also changes these definitions, then one or the other
+% package would not work as expected. On the other hand, changing the 
+% |\addcontentsline| command may have had unexpected results if |\addcontentsline|
+% was either modified or used in a different manner elsewhere in the document.
+%
+%    The \Lpack{tocvsec2} package takes a different approach which does
+% not have these disadvantages. It provides a means of inserting commands
+% into the \file{.toc} file that change the current value of 
+% \Lcount{tocdepth} within the body of the file.
+%
+%
+% The package also provides some utility commands so you don't have to remember
+% the level numbers of the sectioning commands.
+%
+% \DescribeMacro{\maxtocdepth}
+% The |\maxtocdepth{|\meta{sec}|}| command can be used after the preamble
+% (and before the |\tableofcontents| command) to set the global value
+% for the \Lcount{tocdepth}. \meta{sec} is the name of a sectioning
+% division (e.g., |part| or |paragraph|). You can also use |all|,
+% meaning all sectioning divisions, or |none|, meaning no sectioning divisions.
+% 
+%
+% \DescribeMacro{\settocdepth}
+% The |\settocdepth{|\meta{sec}|}| command can be used to change the value of
+% the \Lcount{tocdepth} counter within the \file{.toc} file, 
+% where \meta{sec} is the name of a sectional
+% division (e.g., \texttt{chapter} or \texttt{subsection}), or |all| or 
+% |none|. For example,
+% |\settocdepth{section}| will set \Lcount{tocdepth} to be 1 within the
+% \file{.toc} file, until it is altered by another |\settocdepth|
+% command. The command
+% cannot be used in the preamble (i.e., before |\begin{document}|), but
+% can be used any point thereafter.
+%
+% \Lcount{tocdepth} should be set in the preamble, or immediately after,
+% to the least 
+% significant sectional unit
+% that should be in the printed ToC.
+% Later, after the |\tableofcontents| command,  it is possible to 
+% to use |\settocdepth| to reset \Lcount{tocdepth} to a more significant
+% sectional level (and to reset it back again). As an example, assume that
+% the ToC should list subsections and above, but there is one particular
+% section in the document which consists of a set of definitions, each of
+% which is presented as a subsection, but these should not appear in the
+% printed ToC. 
+% \begin{verbatim}
+% \documentclass{...}
+% \usepackage{tocvsec2}
+% ...
+% \begin{document}
+%       \maxtocdepth{subsection}
+% ...
+% \tableofcontents
+% ...
+% \section{Definitions}
+%       \settocdepth{section}
+% \subsection{Definition 1}
+%  ...
+%       \settocdepth{subsection}
+% \section{After definitions}
+% ...
+% \end{verbatim}
+%
+% \DescribeMacro{\setsecnumdepth}
+% The |\setsecnumdepth{|\meta{sec}|}| command is similar to |\settocdepth| 
+% except
+% that it changes the value of \Lcount{secnumdepth} at the point in
+% the document where it is called. Like the |\settocdepth|
+% command, it cannot be used in the preamble, but can be used as often as
+% necessary after that.
+%
+% \DescribeMacro{\maxsecnumdepth}
+% The |\maxsecnumdepth{|\meta{sec}|}| command is similar to |\maxtocdepth|
+% except that it is for setting the default value for \Lcount{secnumdepth}
+% after the preamble. If you used |\setsecnumdepth| for this purpose
+% you might find an extra blank page in the typeset manuscript.
+%
+% For example, assume that in a document the sectional divisions are 
+% normally numbered down to the sub-subsection level, but within a particular
+% section, they should only be numbered to the subsection level. Also,
+% all sectional divisions within the appendices are to be numbered.
+% This can be accomplished like:
+% \begin{verbatim}
+% \documentclass{...}
+% \usepackage{tocvsec2}
+% ...
+% \begin{document}
+%       \maxsecnumdepth{subsubsection}
+% ...
+% \tableofcontents
+% ...
+% \section{Normal section}
+% ...
+% \section{Reduce numbering} 
+%       \setsecnumdepth{subsection}
+% ...
+%       \setsecnumdepth{subsubsection}
+% \section{Another normal section}
+%  ...
+% \appendix
+%       \setsecnumdepth{all}
+% ...
+% \end{verbatim}
+%
+%
+%
+%
+% \section{The package code} \label{sec:code}
+%
+%    Announce the name and version of the package, which requires
+% \LaTeXe{} and the \Lpack{stdclsdv} and \Lpack{ifthen} packages.
+%    \begin{macrocode}
+%<*usc>
+\NeedsTeXFormat{LaTeX2e}
+\ProvidesPackage{tocvsec2}[1999/01/24 v1.1 variable ToC section entries]
+\RequirePackage{stdclsdv}
+\RequirePackage{ifthen}
+%    \end{macrocode}
+%
+% In order to try and avoid name clashes with other packages, each internal
+% name will include the character string \texttt{t@c}.
+%
+% Issue warning(s) if there are no recognized sectional divisions. Skip
+% the rest of the code if necessary.
+%    \begin{macrocode}
+\ifSCDknownclass
+  \ifSCDnodivs
+    \PackageWarning{tocvsec2}{There are no sectional divisions in this class}
+    \renewcommand{\SCDquit}{\endinput}
+  \fi
+\else
+  \PackageWarning{tocvsec2}%
+    {I don't recognize the class but I'll do my best}
+\fi
+\SCDquit
+%    \end{macrocode}
+%
+% \begin{macro}{\if@knownsect@c}
+% \begin{macro}{\@setseccntt@c}
+% A helper macro to set a sectioning-related counter. Call as
+% |\@setseccntt@c{|\meta{sec}|}{|\meta{counter}|}| to set
+% \Lcount{counter} to the level of \meta{sec}.
+%    \begin{macrocode}
+\newif\if@knownsect@c
+\newcommand{\@setseccntt@c}[2]{
+  \@knownsect@cfalse
+  \ifthenelse{\equal{#1}{none}}{\setcounter{#2}{-10}
+                                \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{part}}{\ifSCDchapter
+                                  \setcounter{#2}{-1} 
+                                \else
+                                  \setcounter{#2}{0}
+                                \fi
+                                \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{chapter}}{\setcounter{#2}{0}
+                                   \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{section}}{\setcounter{#2}{1}
+                                   \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{subsection}}{\setcounter{#2}{2}
+                                      \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{subsubsection}}{\setcounter{#2}{3}
+                                         \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{paragraph}}{\setcounter{#2}{4}
+                                     \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{subparagraph}}{\setcounter{#2}{5}
+                                        \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{all}}{\setcounter{#2}{100}
+                                \@knownsect@ctrue}{}
+  \if@knownsect@c\else
+    \PackageError{tocvsec2}{%
+      Unknown sectioning command name (#1)
+    }{%
+      I'll ignore it. Type \space <return> and I'll continue.\MessageBreak
+      If you haven't mistyped the name then use \protect\setcounter\space instead.}
+  \fi
+}
+%    \end{macrocode}
+% \end{macro}
+% \end{macro}
+%
+%
+% \begin{macro}{\settocdepth}
+% |\settocdepth{|\meta{sec}|}| is the user command for setting 
+% \Lcount{tocdepth} in the \file{.toc} file to the value corresponding 
+% to \meta{sec}. 
+%    \begin{macrocode}
+\newcommand{\settocdepth}[1]{%
+  \@knownsect@cfalse
+  \ifthenelse{\equal{#1}{none}}{%
+    \addtocontents{toc}{\protect\setcounter{tocdepth}{-10}}
+    \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{part}}{%
+    \ifSCDchapter
+      \addtocontents{toc}{\protect\setcounter{tocdepth}{-1}}
+    \else
+      \addtocontents{toc}{\protect\setcounter{tocdepth}{0}}
+    \fi
+    \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{chapter}}{%
+    \addtocontents{toc}{\protect\setcounter{tocdepth}{0}}
+    \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{section}}{%
+    \addtocontents{toc}{\protect\setcounter{tocdepth}{1}}
+    \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{subsection}}{
+    \addtocontents{toc}{\protect\setcounter{tocdepth}{2}}
+    \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{subsubsection}}{%
+    \addtocontents{toc}{\protect\setcounter{tocdepth}{3}}
+    \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{paragraph}}{%
+    \addtocontents{toc}{\protect\setcounter{tocdepth}{4}}
+    \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{subparagraph}}{%
+    \addtocontents{toc}{\protect\setcounter{tocdepth}{5}}
+    \@knownsect@ctrue}{}
+  \ifthenelse{\equal{#1}{all}}{%
+    \addtocontents{toc}{\protect\setcounter{tocdepth}{100}}
+    \@knownsect@ctrue}{}
+  \if@knownsect@c\else
+    \PackageError{tocvsec2}{%
+      Unknown sectioning command name (#1)}%
+     {I'll ignore it. Type \space <return> and I'll continue.}
+  \fi
+}
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\maxtocdepth}
+% |\maxtocdepth{|\meta{sec}|}| can be used to initialise \Lcount{tocdepth}
+% between the end of the preamble and the |\tableofcontents| command.
+%    \begin{macrocode}
+\newcommand{\maxtocdepth}[1]{
+  \@setseccntt@c{#1}{tocdepth}}
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\setsecnumdepth}
+% |\setsecnumdepth{|\meta{sec}|}| is the user command for setting 
+% \Lcount{secnumdepth} to the value corresponding to \meta{sec}.
+%    \begin{macrocode}
+\newcommand{\setsecnumdepth}[1]{\leavevmode%
+  \@setseccntt@c{#1}{secnumdepth}}
+%    \end{macrocode}
+% \end{macro}
+%
+% \begin{macro}{\maxsecnumdepth}
+% |\maxsecnumdepth{|\meta{sec}|}| is the user command to initialise
+% \Lcount{secnumdepth} after the preamble 
+% to the value corresponding to \meta{sec}.
+%    \begin{macrocode}
+\newcommand{\maxsecnumdepth}[1]{%
+  \@setseccntt@c{#1}{secnumdepth}}
+%    \end{macrocode}
+% \end{macro}
+%
+%
+%    The end of this package.
+%    \begin{macrocode}
+%</usc>
+%    \end{macrocode}
+%
+%
+% \bibliographystyle{alpha}
+%
+% \begin{thebibliography}{GMS94}
+%
+% \bibitem[GMS94]{GOOSSENS94}
+% Michel Goossens, Frank Mittelbach, and Alexander Samarin.
+% \newblock {\em The LaTeX Companion}.
+% \newblock Addison-Wesley Publishing Company, 1994.
+%
+% \bibitem[Wil96]{PRW96i}
+% Peter~R. Wilson.
+% \newblock {\em {LaTeX for standards: The LaTeX package files user manual}}.
+% \newblock NIST Report NISTIR, June 1996.
+%
+% \end{thebibliography}
+%
+%
+% \Finale
+% \PrintIndex
+%
+\endinput
+
+%% \CharacterTable
+%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
+%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
+%%   Digits        \0\1\2\3\4\5\6\7\8\9
+%%   Exclamation   \!     Double quote  \"     Hash (number) \#
+%%   Dollar        \$     Percent       \%     Ampersand     \&
+%%   Acute accent  \'     Left paren    \(     Right paren   \)
+%%   Asterisk      \*     Plus          \+     Comma         \,
+%%   Minus         \-     Point         \.     Solidus       \/
+%%   Colon         \:     Semicolon     \;     Less than     \<
+%%   Equals        \=     Greater than  \>     Question mark \?
+%%   Commercial at \@     Left bracket  \[     Backslash     \\
+%%   Right bracket \]     Circumflex    \^     Underscore    \_
+%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
+%%   Right brace   \}     Tilde         \~}
+
+
diff --git a/Master/texmf-dist/source/latex/tocvsec2/tocvsec2.ins b/Master/texmf-dist/source/latex/tocvsec2/tocvsec2.ins
new file mode 100644
index 00000000000..6dabd07e64d
--- /dev/null
+++ b/Master/texmf-dist/source/latex/tocvsec2/tocvsec2.ins
@@ -0,0 +1,60 @@
+%%
+%% tocvsec2.ins
+%% Copyright 1998 Peter R. Wilson
+%%
+%% This program is provided under the terms of the
+%% LaTeX Project Public License distributed from CTAN
+%% archives in directory macros/latex/base/lppl.txt.
+%%
+%% Author: Peter Wilson (CUA and NIST)
+%%         now at: peter.r.wilson@boeing.com
+%% 
+%% This file will generate fast loadable files and documentation
+%% driver files from the doc files in this package when run through
+%% LaTeX or TeX.
+%%
+%% --------------- start of docstrip commands ------------------
+%%
+\def\batchfile{tocvsec2.ins}
+\input docstrip.tex
+\preamble
+
+ Copyright 1998 Peter R. Wilson
+
+ This program is provided under the terms of the
+ LaTeX Project Public License distributed from CTAN
+ archives in directory macros/latex/base/lppl.txt.
+
+Author: Peter Wilson (CUA and NIST)
+        now at: peter.r.wilson@boeing.com
+
+\endpreamble
+
+\keepsilent
+
+%%% \Msg{*** Generating the driver file ***}
+%%% \generateFile{tocvsec2.drv}{t}{\from{tocvsec2.dtx}{driver}}
+
+\Msg{*** Generating the LaTeX2e package files ***}
+
+\generateFile{tocvsec2.sty}{t}{\from{tocvsec2.dtx}{usc}}
+
+\Msg{***********************************************************}
+\Msg{*}
+\Msg{* To finish the installation you have to move the following}
+\Msg{* file(s) into a directory searched by TeX:}
+\Msg{*}
+\Msg{* \space\space tocvsec2.sty}
+\Msg{*}
+\Msg{*}
+\Msg{* To produce the documentation run the files ending with}
+\Msg{* `.dtx' through LaTeX.}
+\Msg{* Process any name.idx file by:}
+\Msg{* \space\space\space\space makeindex -s gind.ist name}
+\Msg{* Process any name.glo file by:}
+\Msg{* \space\space\space\space makeindex -s gglo.ist -o name.gls name.glo}
+\Msg{*}
+\Msg{* Happy TeXing}
+\Msg{***********************************************************}
+
+\endinput