summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2006-01-11 23:55:51 +0000
committerKarl Berry <karl@freefriends.org>2006-01-11 23:55:51 +0000
commita8781e89e10b78cb9b46c8af6801bdf9888931b8 (patch)
tree5093652fd7d0b5d30bf90ad81ff17a1629dd6744 /Master
parentfa8c4b93214f1b8964720de0b4b0f32675b71d0b (diff)
trunk/Master/texmf-dist/source/latex/pageno
git-svn-id: svn://tug.org/texlive/trunk@430 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/source/latex/pageno/pageno.dtx277
-rw-r--r--Master/texmf-dist/source/latex/pageno/pageno.ins57
2 files changed, 334 insertions, 0 deletions
diff --git a/Master/texmf-dist/source/latex/pageno/pageno.dtx b/Master/texmf-dist/source/latex/pageno/pageno.dtx
new file mode 100644
index 00000000000..17a34e6d32e
--- /dev/null
+++ b/Master/texmf-dist/source/latex/pageno/pageno.dtx
@@ -0,0 +1,277 @@
+% \iffalse
+% File pageno.dtx
+% inspired by Axel Sommerfeldt's rplain.sty
+% Copyright Rowland McDonnell 1996
+% Some code copyright Axel Sommerfeldt
+% email: rebecca@astrid.u-net.com
+%
+% See the section on copying below for restrictions.
+%
+%\fi
+%
+%\iffalse
+%<*driver>
+\documentclass[a4paper]{ltxdoc}
+\begin{document}
+ \DocInput{pageno.dtx}
+\end{document}
+%</driver>
+%\fi
+%\iffalse
+%<*package>
+%\fi
+%%
+%% \CheckSum{189}
+%% \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 \~}
+%
+%
+%\iffalse
+% Some useful bits
+%\fi
+% \newcommand*{\bs}{\char'134}
+% \DeclareRobustCommand*{\packname}[1]{\textsf{#1}}
+% \DeclareRobustCommand*{\comname}[1]{{\ttfamily\makeatletter\bs #1\makeatother}}
+% \newcommand*{\optname}[1]{{\ttfamily #1}}
+% \newcommand*{\filename}[1]{{\ttfamily #1}}
+%
+% \title{The \packname{pageno} package}
+% \date{Version 1.2, 22nd September 1998}
+% \author{ Rowland McDonnell,\\ after Axel Sommerfeldt}
+% \maketitle
+% \tableofcontents
+%
+% \section{Introduction}
+%
+% The \packname{pageno} package can change the place that page
+% numbers are printed on the page. By page numbers, I mean `folios':
+% the numbers printed on a page to say which page it is.
+%
+% This job is done by re-defining the \texttt{plain} page style; you
+% control where the page numbers are printed by passing options to the
+% \packname{pageno} package. You can have page numbers at the top or
+% bottom of the page; in the inside corner, outside corner, or in the
+% middle.
+%
+% The advantage of this way of doing things over the \packname{fancyhdr}
+% package is that you don't have to worry about your new page style
+% being `lost' because some part of \LaTeX{} has switched to the
+% \texttt{plain} page style, and of course there are no new commands to
+% learn. The disadvantage is that it's a very simple-minded package:
+% any package that re-defines the \texttt{plain} page style is likely
+% to conflict in some way with \packname{pageno}. In such cases, the
+% \packname{fancyhdr} package might well help.
+%
+% If you want more control over headers and footers, or if you don't
+% want to re-define the \texttt{plain} page style, try the
+% \packname{fancyhdr} package.
+%
+% The \packname{pageno} package was inspired by Axel Sommerfeldt's
+% \packname{rplain} package, which redefines the \texttt{plain} page
+% style to put page numbers in the bottom outside corner.
+%
+% \section{How to use the package}
+%
+% It's all done with options:
+% \begin{verbatim}
+% \documentclass{article}
+% \usepackage[insidefoot]{pageno}
+% \begin{document}
+% ...
+%\end{verbatim}
+% will re-define the \texttt{plain} page style so that page numbers will
+% be printed in the bottom inside corner. If you don't give the
+% \packname{pageno} package an option, it won't change the
+% \texttt{plain} page style. If you give \packname{pageno} more than
+% one option, the last one specified will be the one that's used.
+%
+% Whatever else \packname{pageno} does, it will switch to the
+% \texttt{plain} page style when its finished.
+%
+% The full list of options is this:
+%\DeleteShortVerb{\|}
+% \begin{center}
+% \begin{tabular}{l|l}
+% Option & Page number position \\ \hline
+% \optname{centerfoot} & Centre bottom \\
+% \optname{outsidefoot} & Outside bottom \\
+% \optname{insidefoot} & Inside bottom \\
+% \optname{centrehead} & Centre top \\
+% \optname{outsidehead} & Outside top \\
+% \optname{insidehead} & Inside top \\
+% \end{tabular}
+% \end{center}
+% \MakeShortVerb{\|}
+% You can say \optname{centrefoot} and \optname{centrehead} instead
+% of \optname{centerfoot} and \optname{centerhead} if you like.
+%
+% The \optname{centerfoot} option really does re-define the
+% \texttt{plain} pagestyle, but it's redundant because the result is
+% the same as the default definition.
+%
+% If you use this package, or decide not to, I'd very much appreciate it
+% if you would send me a message saying why. Suggestions for
+% improvements and reports of bugs are of course most welcome.
+% \verb|rebecca@astrid.u-net.com| is my email address.
+%
+% \section{A typographical note}
+%
+% There is a point to labeling each page in a document with a page
+% number: it's so the reader can refer to it. In a conventional book,
+% the best place for the page number is on one of the outside edges:
+% that way, a reader can flip through the book and find a page easily.
+% If the page numbers are on an inside edge, it's very difficult to
+% read them without fully opening the book on each page.
+%
+% \section{Copying and stuff}
+%
+% If you want to give the \packname{pageno} package to someone, please
+% give them the unchanged files \filename{pageno.dtx} and
+% \filename{pageno.ins}. Anyone may make as many copies of these files
+% as they like and give them to anyone. You're not allowed to charge
+% money for distributing this package, except for a nominal fee to cover
+% costs, although I'm happy for non-profit organizations like the TeX
+% Users' Group to include and sell this on CD-ROMs and the like
+% containing selections of code from CTAN.
+%
+% If you want to change this package, please make a copy of the package
+% file, and change the name, file identification commands, and comments
+% to identify it as being your responsibility now, not mine.
+%
+% \StopEventually
+%
+%\iffalse
+% 1998/09/22 v1.3 Re-wrote some documentation with the aim of
+% uploading it to CTAN
+% 1996/11/01 v1.2 It looks ready now
+%\fi
+% \section{The code itself}
+%
+% Who am I, and what do I need? This package will probably work with
+% any version of \LaTeXe, but I've only tested it with the June 1996
+% release.
+%
+% \begin{macrocode}
+\NeedsTeXFormat{LaTeX2e}[1996/06/01]
+\ProvidesPackage{pageno}[1996/11/01 v1.2
+ pagenumbers package (RJMM, after AS)]
+% \end{macrocode}
+%
+% \subsection{Declare and process the options}
+%
+% There's not much to be said, really. The \optname{centrefoot} option
+% duplicates the effect of the standard definition of
+% \comname{ps@plain}---this is the macro that is executed to define the
+% \texttt{plain} page style. The other options are variations on the
+% same theme. Axel Sommerfeldt did the original re-definition; I copied
+% him. The original \LaTeX{} code looks like this:
+% \begin{verbatim}
+% \def\ps@plain{\let\@mkboth\@gobbletwo
+% \let\@oddhead\@empty\def\@oddfoot{\reset@font\hfil\thepage
+% \hfil}\let\@evenhead\@empty\let\@evenfoot\@oddfoot}
+%\end{verbatim}
+%
+% The redefinitions here might be a little less efficient than the
+% standard code, but I doubt that matters.
+%
+% \begin{macrocode}
+\DeclareOption{centrefoot}{%
+ \renewcommand{\ps@plain}{%
+ \renewcommand{\@mkboth}{\@gobbletwo}%
+ \renewcommand{\@oddhead}{}%
+ \renewcommand{\@evenhead}{}%
+ \renewcommand{\@evenfoot}{\reset@font\rmfamily\hfil\thepage\hfil}%
+ \renewcommand{\@oddfoot}{\reset@font\rmfamily\hfil\thepage\hfil}}
+ }
+
+\DeclareOption{centerfoot}{%
+ \renewcommand{\ps@plain}{%
+ \renewcommand{\@mkboth}{\@gobbletwo}%
+ \renewcommand{\@oddhead}{}%
+ \renewcommand{\@evenhead}{}%
+ \renewcommand{\@evenfoot}{\reset@font\rmfamily\hfil\thepage\hfil}%
+ \renewcommand{\@oddfoot}{\reset@font\rmfamily\hfil\thepage\hfil}}
+ }
+
+\DeclareOption{outsidefoot}{%
+ \renewcommand{\ps@plain}{%
+ \renewcommand{\@mkboth}{\@gobbletwo}%
+ \renewcommand{\@oddhead}{}%
+ \renewcommand{\@evenhead}{}%
+ \renewcommand{\@evenfoot}{\reset@font\rmfamily\thepage\hfil}%
+ \renewcommand{\@oddfoot}{\reset@font\rmfamily\hfil\thepage}}
+ }
+
+\DeclareOption{insidefoot}{%
+ \renewcommand{\ps@plain}{%
+ \renewcommand{\@mkboth}{\@gobbletwo}%
+ \renewcommand{\@oddhead}{}%
+ \renewcommand{\@evenhead}{}%
+ \renewcommand{\@evenfoot}{\reset@font\rmfamily\hfil\thepage}%
+ \renewcommand{\@oddfoot}{\reset@font\rmfamily\thepage\hfil}}
+ }
+
+\DeclareOption{centrehead}{%
+ \renewcommand{\ps@plain}{%
+ \renewcommand{\@mkboth}{\@gobbletwo}%
+ \renewcommand{\@evenhead}{\reset@font\rmfamily\hfil\thepage\hfil}%
+ \renewcommand{\@oddhead}{\reset@font\rmfamily\hfil\thepage\hfil}%
+ \renewcommand{\@evenfoot}{}%
+ \renewcommand{\@oddfoot}{}}
+ }
+
+\DeclareOption{centerhead}{%
+ \renewcommand{\ps@plain}{%
+ \renewcommand{\@mkboth}{\@gobbletwo}%
+ \renewcommand{\@evenhead}{\reset@font\rmfamily\hfil\thepage\hfil}%
+ \renewcommand{\@oddhead}{\reset@font\rmfamily\hfil\thepage\hfil}%
+ \renewcommand{\@evenfoot}{}%
+ \renewcommand{\@oddfoot}{}}
+ }
+
+\DeclareOption{outsidehead}{%
+ \renewcommand{\ps@plain}{%
+ \renewcommand{\@mkboth}{\@gobbletwo}%
+ \renewcommand{\@evenhead}{\reset@font\rmfamily\thepage\hfil}%
+ \renewcommand{\@oddhead}{\reset@font\rmfamily\hfil\thepage}%
+ \renewcommand{\@evenfoot}{}%
+ \renewcommand{\@oddfoot}{}}
+ }
+
+\DeclareOption{insidehead}{%
+ \renewcommand{\ps@plain}{%
+ \renewcommand{\@mkboth}{\@gobbletwo}%
+ \renewcommand{\@evenhead}{\reset@font\rmfamily\hfil\thepage}%
+ \renewcommand{\@oddhead}{\reset@font\rmfamily\thepage\hfil}%
+ \renewcommand{\@evenfoot}{}%
+ \renewcommand{\@oddfoot}{}}
+ }
+
+\ProcessOptions*
+% \end{macrocode}
+%
+% \subsection{Select the \texttt{plain} page style and finish}
+%
+% \begin{macrocode}
+\pagestyle{plain}
+\endinput
+% \end{macrocode}
+%
+% \Finale
+%\iffalse
+%<*package>
+%%
+%% End of file `pageno.dtx'.\fi
diff --git a/Master/texmf-dist/source/latex/pageno/pageno.ins b/Master/texmf-dist/source/latex/pageno/pageno.ins
new file mode 100644
index 00000000000..d78d2da0292
--- /dev/null
+++ b/Master/texmf-dist/source/latex/pageno/pageno.ins
@@ -0,0 +1,57 @@
+% File pageno.ins
+% Copyright Rowland McDonnell 1996
+%
+% Installation file for the pageno package.
+%
+%
+% To install the pageno package you need:
+%
+% pageno.ins (this file)
+% pageno.dtx
+% docstrip.tex (part of the standard LaTeX2e distribution)
+%
+%
+% To produce the documentation you also need:
+%
+% doc.sty (part of the standard LaTeX2e distribution)
+%
+%
+% Instructions
+%
+% Run LaTeX on this file to strip the comments from pageno.dtx and
+% produce the package file pageno.sty. Put pageno.sty somewhere that
+% LaTeX can see it.
+%
+% Run LaTeX on pageno.dtx to produce the documentation.
+%
+% You might like to keep pageno.ins and pageno.dtx somewhere safe as a
+% backup, or in case you want to pass the pageno package on to someone
+%
+% You can delete pageno.dvi, pageno.aux, pageno.toc, and pageno.log.
+%
+%
+%
+\ProvidesFile{pageno.ins}
+\def\batchfile{pageno.ins}
+\input docstrip
+\keepsilent
+\generateFile{pageno.sty}{t}{\from{pageno.dtx}{package}}
+\typeout{}
+\typeout{}
+\typeout{Finished stripping the comments from pageno.dtx.}
+\typeout{}
+\typeout{To finish the installation, put pageno.sty in a sensible place}
+\typeout{on your system's TeX-inputs search path.}
+\typeout{}
+\typeout{To produce the documentation, run LaTeX on pageno.dtx.}
+\typeout{}
+\typeout{You might like to keep pageno.ins and pageno.dtx somewhere safe }
+\typeout{as a backup, or in case you want to pass the pageno package on}
+\typeout{to someone.}
+\typeout{}
+\typeout{Don't forget to delete:}
+\typeout{pageno.dvi, pageno.aux, pageno.toc, and pageno.log.}
+\typeout{}
+\typeout{}
+
+\endinput \ No newline at end of file