doc 4

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

2 files changed, 191 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/footnpag/footnpag-doc.sty b/Master/texmf-dist/doc/latex/footnpag/footnpag-doc.sty
new file mode 100644
index 00000000000..82aad99e61a
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/footnpag/footnpag-doc.sty
@@ -0,0 +1,58 @@
+% $Id: footnpag-doc.sty,v 2.1 1995/08/04 00:18:33 schrod Exp $
+%----------------------------------------------------------------------
+
+%
+% tags for the documentation of footnpag package
+%
+
+
+\ProvidesPackage{footnpag-doc}
+
+
+%
+% Used packages
+%
+
+\RequirePackage{footnpag}		% for style revision
+\providecommand*\fnpp@loaded{$StyleRevision$} % bootstrap
+
+
+
+%
+% Configuration of RCS fields
+%
+
+% keywords in style are prefixed by `Style', in documentation by `Doc'.
+\let\RcsHandleStyleDate=\RcsHandleDate	% transform StyleDate value
+\let\RcsHandleDocDate=\RcsHandleDate	% transform DocDate field
+
+% the revision of rcs.sty is needed by the documentation
+\expandafter\RCS \fnpp@loaded		% creates \RCSStyleRevision
+
+% author name
+\rcsAuthor{schrod}{Joachim Schrod}
+
+
+
+%
+% new tags
+%
+
+\def\<#1>{%				% syntactic element
+    \mbox{$\langle$\rm #1$\rangle$}%
+    }
+
+
+
+\endinput
+
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+Local Variables:
+mode: plain-TeX
+TeX-master: t
+TeX-brace-indent-level: 4
+indent-tabs-mode: t
+TeX-auto-untabify: nil
+End:
diff --git a/Master/texmf-dist/doc/latex/footnpag/footnpag-user.tex b/Master/texmf-dist/doc/latex/footnpag/footnpag-user.tex
new file mode 100644
index 00000000000..1ad5a6ea83c
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/footnpag/footnpag-user.tex
@@ -0,0 +1,133 @@
+% $DocId: footnpag-user.tex,v 2.1 1995/08/04 00:18:33 schrod Exp $
+%------------------------------------------------------------
+
+%
+% user manual/requirement definition for footnpag package
+%
+% [LaTeX]
+% (history at end)
+
+
+% This file is either a subdocument of the style doc or a document on
+% its own. In the former case it's a chapter, in the latter it's a
+% ``normal'' LaTeX progltx document.
+%     If it's a subdocument, this file will be included after
+% \begin{document}. We can detect this: \document redefines
+% \documentclass to be \@twoclasseserror. Then we also have to define
+% how this document is ended: Either by \endinput or by an additional
+% revision log.
+% Of course, this test works only if LaTeX 2e is used for processing.
+
+\expandafter\ifx \csname @twoclasseserror\endcsname \documentclass
+
+        \let\endSubDocument=\endinput
+
+        \chap What's this package for?.
+
+\else
+
+        \let\endSubDocument=\relax
+
+        \documentclass{progltx}
+
+        \usepackage{footnpag-doc}       % document-specific markup
+        \usepackage{a4-9}               % Tschichold's A4 layout
+
+        \nofiles                        % no crossreferences used
+
+        \begin{document}
+
+        \title{The \texttt{footnpag} Package}
+        \author{Joachim Schrod%
+            \thanks{Email: \texttt{schrod@iti.informatik.th-darmstadt.de}}%
+            }
+
+        \RCS $DocDate: 1995/08/04 00:18:33 $
+        \date{%
+            \RCSDocDate\\[3pt] % LaTeX Error: Paragraph terminated too early
+            (Revision \RCSStyleRevision{} of \texttt{footnpag.sty})%
+            }
+
+        \maketitle
+
+        \sect
+
+\fi
+
+
+
+
+
+This package is appropriate for numbering footnotes separately on each
+page. It may be used with all standard document classes (and I assume
+with all other well written ones). `Numbering' here does not only mean
+supplying Arabic numbers, if your class or another package sets up
+appropriate symbols, they are used instead.
+
+You just have to use the |footnpag| package, the rest will happen
+automagically. You will need two \LaTeX{} runs, as with cross
+references or citations.
+
+
+\sect \textsl{Known Problems}.
+
+\medskip
+
+\noindent Unlike with references, \LaTeX{} will not issue a warning if
+a footnote number is incorrect due to new page breaks. Thus run
+\LaTeX{} always another time if you want a final document.
+
+This is scheduled to change in the next revision.
+
+
+\sect An auxiliary file is used, named \textit{jobname}|.fot|. This is
+not necessary by itself, it would have been better to use the
+|aux| file. (Actually, this package was written for plain \TeX{}
+originally, there is no |aux| file there.)
+
+This is also scheduled to change in the next revision. In fact, it's
+the same problem like the previous one: When I use the |aux| file,
+\LaTeX{}'s warning mechanism can be utilized.
+
+
+\sect There is no possibility to change the number that's used for the
+first footnote on a page.
+
+Some people like to start their footnotes with~`0', there exists even
+a package for that named |zero|. |footnpag| should cooperate with that
+package.
+
+If one uses symbols as footnote markers, the first footnote is marked
+with an asterisk. One might want to use a dagger instead, that's not
+possible currently.
+
+Most probably this feature will be made available via the new
+``keyword-value'' option scheme, as you'll find it in the |graphicx|
+package.
+
+
+
+
+\endSubDocument
+
+
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
+\vskip \PltxPreSectSkip
+
+\begin{rcslog}
+$DocLog: footnpag-user.tex,v $
+\Revision 2.1 1995/08/04 00:18:33 schrod
+Made a \LaTeXe{} package from this style option.
+
+User manual is a separate document now, that's better for
+installation. Started to change the distribution into one that
+conforms to the `supported bundle guidelines.'
+
+\end{rcslog}
+
+
+
+\end{document}
+
+% LocalWords:  footnpag jobname fot graphicx