sttools doc update (1mar10)

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

6 files changed, 263 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/sttools/doc/cuted.pdf b/Master/texmf-dist/doc/latex/sttools/doc/cuted.pdf
new file mode 100644
index 00000000000..d3f2607ca41
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sttools/doc/cuted.pdf
diff --git a/Master/texmf-dist/doc/latex/sttools/doc/cuted.tex b/Master/texmf-dist/doc/latex/sttools/doc/cuted.tex
new file mode 100644
index 00000000000..cb51250bff2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sttools/doc/cuted.tex
@@ -0,0 +1,91 @@
+\documentclass[DIV=8, pagesize=auto]{scrartcl}
+
+\usepackage{fixltx2e}
+\usepackage{etex}
+\usepackage{xspace}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\usepackage[utf8]{inputenc}
+\usepackage{microtype}
+\usepackage[unicode=true]{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*{\opt}[1]{\texttt{#1}}
+\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle}
+\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}}
+
+\addtokomafont{title}{\rmfamily}
+
+\title{The \pkg{cuted} package}
+\author{Sigitas Tolušis\\\mail{sigitas@vtex.lt}\\\url{http://www.vtex.lt/tex/download/macros/}}
+\date{1997/10/01}
+
+
+\begin{document}
+
+\maketitle
+
+\section{Purpose:}
+
+Insert some onecolumn material in full-width on double-column page.
+
+
+\section{Short Description:}
+
+It is denoted to place some material in full-width at any place 
+on double-column page (\cmd{\twocolumn} mode). The part of material
+can be placed on the next page. Existing text is placed
+under inserted material in two columns (it is reformatted).
+
+Provides new environment:
+\verb+\begin{strip}+\meta{\ldots}\verb+\end{strip}+\\
+Puts \cmd{\vbox}\marg{\ldots} in full-width on double-column page.
+Adds \cmd{\stripsep} glue before and after
+(By default \verb+\stripsep=15pt plus2pt minus 2pt+).
+It can be problems with floats and footnotes. In the case of 
+problems with footnotes it is possible to correct the situation
+using commands \cmd{\footnotemark} and \cmd{\footnotetext}.
+
+Provides new command:
+\cmd{\oldcolsbreak}\marg{\#1}\\
+Adds \meta{\#1} in place of original column break if strip is placed 
+on the right column.
+
+
+\section{List of Changes}
+
+\begin{tabular}{@{}l@{ -- }l@{}}
+  1997/09/02 & improved column balancing                        \\
+  1997/09/03 & float control for \cmd{\@colroom} setting        \\
+  1997/09/04 & improved \cmd{\@colroom} setting                 \\
+  1997/09/05 & checking for \cmd{\@viper} and \cmd{\hold@viper} \\
+  1997/09/09 & compatibility with \pkg{flushend.sty}            \\
+  1997/09/22 & improved \cmd{\output} ir \cmd{\@specialoutput}  \\
+  1997/10/01 & improved \cmd{\output} ir \cmd{\@addviper}
+\end{tabular}
+
+\bigskip
+
+\footnotesize
+\noindent
+\pkg{cuted.sty}\\
+Copyright 1997 Sigitas Tolušis\\
+V\TeX\ Ltd., Akademijos 4, Vilnius, Lithuania\\
+e-mail \mail{sigitas@vtex.lt}\\
+\url{http://www.vtex.lt/tex/download/macros/}
+
+This program can redistributed and/or modified under the terms
+of the \LaTeX\ Project Public License Distributed from CTAN
+archives in directory \texttt{macros/latex/base/lppl.txt}; either
+version~1 of the License, or (at your option) any later version.
+
+\end{document}
+
+
diff --git a/Master/texmf-dist/doc/latex/sttools/doc/floatpag.pdf b/Master/texmf-dist/doc/latex/sttools/doc/floatpag.pdf
new file mode 100644
index 00000000000..050443c6bf6
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sttools/doc/floatpag.pdf
diff --git a/Master/texmf-dist/doc/latex/sttools/doc/floatpag.tex b/Master/texmf-dist/doc/latex/sttools/doc/floatpag.tex
new file mode 100644
index 00000000000..b4907c0dfed
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sttools/doc/floatpag.tex
@@ -0,0 +1,86 @@
+\documentclass[DIV=8, parskip=half, pagesize=auto]{scrartcl}
+
+\usepackage{fixltx2e}
+\usepackage{etex}
+\usepackage{xspace}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\usepackage[utf8]{inputenc}
+\usepackage{microtype}
+\usepackage[unicode=true]{hyperref}
+
+\newcommand*{\mail}[1]{\href{mailto:#1}{\texttt{#1}}}
+\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*{\opt}[1]{\texttt{#1}}
+\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle}
+\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}}
+
+\addtokomafont{title}{\rmfamily}
+
+\title{The \pkg{floatpag} package}
+\author{Vytas Statulevičius\\\mail{vytas@vtex.lt}\\\url{http://www.vtex.lt/tex/download/macros/}}
+\date{1999/04/29}
+
+
+\begin{document}
+
+\maketitle
+
+\section{Purpose:}
+
+provides commands to apply different pagestyles
+to the full page floats.
+
+
+\section{Usage:}
+
+\begin{labeling}{\cmd{\thisfloatpagestyle}\marg{foo}}
+\item[\cmd{\floatpagestyle}\marg{foo}] will apply pagestyle
+  `\meta{foo}' to all pages occupied by full page floats.
+\item[\cmd{\rotfloatpagestyle}\marg{foo}] will apply pagestyle `\meta{foo}'
+  to all pages occupied by sideways figures and tables produced with
+  the help of `\pkg{rotating.sty}' package (Sebastian Rahtz and Leonor
+  Barroca)
+\item[\cmd{\thisfloatpagestyle}\marg{foo}] will apply pagestyle
+  `\meta{foo}' to a page where this command was used inside figure or
+  table environment
+\end{labeling}
+
+
+\section{Default:}
+
+\begin{verbatim}
+\floatpagestyle{headings}
+\rotfloatpagestyle{plain}
+\end{verbatim}
+
+\medskip
+The macros, developed by Sigitas Tolusis \Mail{sigitas@vtex.lt},
+were used in this package.
+
+The following commands from the LaTeX2e kernel were redefined:\\
+\cmd{\@xfloat}, \cmd{\@vtryfc}\\
+The following command from the rotating.sty  was redefined:\\
+\cmd{\@xrotfloat}
+
+\bigskip
+\footnotesize
+\pkg{floatpag.sty}\\
+Copyright 1999 V.\ Statulevičius\\
+V\TeX\ Ltd., Akademijos 4, Vilnius, Lithuania\\
+e-mail \mail{vytas@vtex.lt}\\
+\url{http://www.vtex.lt/tex/download/macros/}
+
+This program can redistributed and/or modified under the terms
+of the \LaTeX\ Project Public License Distributed from CTAN
+archives in directory \texttt{macros/latex/base/lppl.txt}; either
+version~1 of the License, or (at your option) any later version.
+
+\end{document}
diff --git a/Master/texmf-dist/doc/latex/sttools/doc/flushend.pdf b/Master/texmf-dist/doc/latex/sttools/doc/flushend.pdf
new file mode 100644
index 00000000000..ca84cb35d02
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sttools/doc/flushend.pdf
diff --git a/Master/texmf-dist/doc/latex/sttools/doc/flushend.tex b/Master/texmf-dist/doc/latex/sttools/doc/flushend.tex
new file mode 100644
index 00000000000..28066da7444
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/sttools/doc/flushend.tex
@@ -0,0 +1,86 @@
+\documentclass[DIV=8, pagesize=auto]{scrartcl}
+
+\usepackage{fixltx2e}
+\usepackage{etex}
+\usepackage{xspace}
+\usepackage{lmodern}
+\usepackage[T1]{fontenc}
+\usepackage{textcomp}
+\usepackage{array}
+\usepackage[utf8]{inputenc}
+\usepackage{microtype}
+\usepackage[unicode=true]{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*{\opt}[1]{\texttt{#1}}
+\newcommand*{\meta}[1]{\textlangle\textsl{#1}\textrangle}
+\newcommand*{\marg}[1]{\texttt{\{}\meta{#1}\texttt{\}}}
+
+\addtokomafont{title}{\rmfamily}
+
+\title{The \pkg{flushend} package}
+\author{Sigitas Tolušis\\\mail{sigitas@vtex.lt}\\\url{http://www.vtex.lt/tex/download/macros/}}
+\date{1997/10/01}
+
+
+\begin{document}
+
+\maketitle
+
+\section{Purpose:}
+
+Balanced columns on last page in \opt{twocolumn} mode.
+
+
+\section{Short Description:}
+
+\begin{labeling}[\hspace{\labelsep}--]{\cmd{\flushend} (loaded by default)}
+\item[\cmd{\flushend} (loaded by default)] Switches on column balancing at last page
+\item[\cmd{\raggedend}] Switches off column balancing at last page
+\item[\cmd{\atColsBreak=}\marg{\#1}] Adds \meta{\#1} in place of original column break (without balancing)\\
+  Example: \verb+\atColsBreak{\vskip-2pt}+
+\item[\cmd{\showcolsendrule}] Adds rule to the bottom of columns (just for debugging)
+\end{labeling}
+
+P.\,S.\ To stretch right column by \meta{\#1} add command \cmd{\vskip-}\meta{\#1} just before
+command \verb+\end{document}+.
+TO shrink right column by \meta{\#1} add command \cmd{\vskip}\meta{\#1} just before
+command \verb+\end{document}+.
+Example:
+%
+\begin{verbatim}
+\vskip-10pt
+\end{document}
+\end{verbatim}
+
+
+\section{List of Changes}
+
+\begin{tabular}{@{}l@{ -- }>{\raggedright\arraybackslash}p{10cm}@{}}
+  1997/05/16 & first version                                  \\
+  1997/09/09 & support for compatibility with \pkg{cuted.sty} \\
+  1997/10/01 & \cmd{\vipersep} changed to \cmd{\stripsep} for compatibility with \pkg{cuted.sty}
+\end{tabular}
+
+\bigskip
+
+\footnotesize
+\noindent
+\pkg{flushend.sty}\\
+Copyright 1997 Sigitas Tolušis\\
+V\TeX\ Ltd., Akademijos 4, Vilnius, Lithuania\\
+e-mail \mail{sigitas@vtex.lt}\\
+\url{http://www.vtex.lt/tex/download/macros/}
+
+This program can redistributed and/or modified under the terms
+of the \LaTeX\ Project Public License Distributed from CTAN
+archives in directory \texttt{macros/latex/base/lppl.txt}; either
+version~1 of the License, or (at your option) any later version.
+
+\end{document}