summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/lastpage
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2010-09-08 23:08:23 +0000
committerKarl Berry <karl@freefriends.org>2010-09-08 23:08:23 +0000
commitee2de76f7db0b19a657a7f3b9ba8768bc8e69e37 (patch)
treecb89ecf46c7a4843251d70c2aa0341a945c81353 /Master/texmf-dist/doc/latex/lastpage
parentd9c6145293d327c544fc033d3e9956fc1afc5b25 (diff)
lastpage 1.2d (28aug10)
git-svn-id: svn://tug.org/texlive/trunk@19615 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/lastpage')
-rw-r--r--Master/texmf-dist/doc/latex/lastpage/README146
-rw-r--r--Master/texmf-dist/doc/latex/lastpage/README.lastpage22
-rw-r--r--Master/texmf-dist/doc/latex/lastpage/lastpage-example.pdfbin0 -> 128200 bytes
-rw-r--r--Master/texmf-dist/doc/latex/lastpage/lastpage-example.tex146
-rw-r--r--Master/texmf-dist/doc/latex/lastpage/lastpage.pdfbin166512 -> 498075 bytes
-rw-r--r--Master/texmf-dist/doc/latex/lastpage/ltxdoc.cfg112
6 files changed, 404 insertions, 22 deletions
diff --git a/Master/texmf-dist/doc/latex/lastpage/README b/Master/texmf-dist/doc/latex/lastpage/README
new file mode 100644
index 00000000000..f275f0e49f2
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/lastpage/README
@@ -0,0 +1,146 @@
+README for lastpage package, 2010/08/25, v1.2d
+
+
+TABLE OF CONTENTS
+=================
+
+1 Introduction
+2 Download
+3 Installation
+4 Additional Packages
+5 New Features
+6 Package Compatibility
+7 Authors/Maintainers
+8 Bug Reports
+9 Known Problems
+
+
+1 INTRODUCTION
+==============
+
+This package puts the label LastPage (\AtEndDocument) into
+the .aux file, allowing the user to refer to the last page
+of a document. This might be particularly useful in places
+like headers or footers. -
+When more than one page numbering scheme is used, or the
+fnsymbol page numbering scheme is used, or another package
+has output after this package, or the number of pages
+instead of the last page's name is needed, or the page
+numbers exeed a certain range, there might be problems,
+which can be solved by using the pagesLTS package instead.
+
+
+2 DOWNLOAD
+==========
+
+`lastpage' is available on CTAN:
+ CTAN:macros/latex/contrib/lastpage/
+
+Also a ZIP file is provided that contains the files, already
+sorted in a TDS tree (should become available on CTAN soon):
+ CTAN:install/macros/latex/contrib/lastpage.tds.zip
+
+`CTAN:' means one of the `Comprehensive TeX Archive Network'
+nodes or one of its mirrors. This is explained in
+ http://www.tex.ac.uk/cgi-bin/texfaq2html?label=archives
+
+The CTAN stuff will be mirrored automatically from the
+ftp server, so
+ ftp://ftp.tug.org/pub/tex/pagesLTS/
+corresponds to
+ CTAN:macros/latex/contrib/pagesLTS/
+
+
+3 INSTALLATION
+==============
+
+First, please make sure that there is no old version of
+lastpage at some obsolete place in your system.
+
+Installation with ZIP file in TDS format
+----------------------------------------
+The ZIP file `lastpage.tds.zip' contains the files sorted
+in a TDS tree. Thus you can directly unpack the ZIP file
+inside a TDS tree.
+(See CTAN:tds.zip for an explanation of TDS.)
+Example:
+ cd /...somewhere.../texmf
+ unzip /...downloadpath.../lastpage.tds.zip
+Do not forget to refresh the file name database of this
+TDS tree.
+Example:
+ texhash /...somewhere.../texmf
+
+Manual installation
+-------------------
+a) Download the lastpage files from CTAN or the TUG server.
+ If necessary, unpack them.
+b) If directory `beta' exists, replace the files by the
+ counterparts in this directory, if you want to use the
+ latest versions.
+c) Generate the package and driver files:
+ tex lastpage.ins
+d) Install the files `*.sty', and `*.cfg' in your TDS tree:
+ cp *.sty *.cfg TDS:tex/latex/muench/lastpage/
+ Replace `TDS:' by the prefix of your TDS tree
+ (texmf directory).
+e) Copy the documentation files to
+ "TDS:doc/latex/muench/lastpage/":
+ README, lastpage.pdf, lastpage-example.tex,
+ lastpage-example.pdf.
+f) Update the databases if necessary, e.g. for teTeX:
+ mktexlsr .../texmf
+
+
+4 ADDITIONAL PACKAGES
+=====================
+
+The lastpage package does not depend on other packages.
+
+
+5 PACKAGE COMPATIBILITY
+=======================
+
+lastpage is not compatible with the very old version 2.0
+(and earlier) of the endfloat package. Newer versions of
+endfloat exists (at the time of writing this documentation:
+v2.4i as of 1995/10/11), which are available at CTAN.
+
+
+6 AUTHOR/MAINTAINER
+=====================
+
+* Hans-Martin Münch
+
+
+7 BUG REPORTS
+==============
+
+A bug report should contain:
+* Comprehensive problem description. This includes error or
+ warning messages.
+ * \errorcontextlines=\maxdimen can be added in the
+ TeX code to get more informations in TeX error messages.
+* Minimal test file that shows the problem, but does not
+ contain any unnecessary packages and code.
+* Used drivers/programs.
+* Version information about used packages and programs.
+ * If you are using LaTeX, then add "\listfiles". Then
+ a list of version informations is printed at the end
+ of the LaTeX run.
+* Please no other files than the minimal test file.
+ The other files .log, .dvi, .ps, .pdf are seldom
+ necessary, so send them only on request.
+* Please .zip or .tar.gz your file(s) before sending them!
+
+Bug address
+-----------
+Bug reports can be send to the maintainer:
+ Hans-Martin Münch
+ <Martin [dot] Muench [at] Uni-Bonn [dot] de>
+
+
+8 KNOWN PROBLEMS
+=================
+
+* Really a lot, see chapter 3 of the documentation! \ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/lastpage/README.lastpage b/Master/texmf-dist/doc/latex/lastpage/README.lastpage
deleted file mode 100644
index 22d3a7820b2..00000000000
--- a/Master/texmf-dist/doc/latex/lastpage/README.lastpage
+++ /dev/null
@@ -1,22 +0,0 @@
-This is an extremely minor package (7 lines of "real code")
-for LaTeX2e. Allows for a references to something on the
-last page of a document.
-
-README.lastpage This file (sorry not 8.3 character name)
-
-lastpage.ins The installation batch file. (just run
- latex on that) to get .drv and .sty files
-
-lastpage.dtx The main file.
-
-Written and
-currently maintained by Jeff Goldberg (J.Goldberg@Cranfield.ac.uk)
-
-Note that as of May 1999, I am formally releasing this package under the terms
-of the General Public License Agreement of the Free Software Foundation.
-
-The previous license was not well thought out and was overly restrictive.
-I am happy for the new freedoms granted by the license change to applied
-retrospectively to any previous release of this package.
-
-1999/05/29
diff --git a/Master/texmf-dist/doc/latex/lastpage/lastpage-example.pdf b/Master/texmf-dist/doc/latex/lastpage/lastpage-example.pdf
new file mode 100644
index 00000000000..bbe410bdeb9
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/lastpage/lastpage-example.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/lastpage/lastpage-example.tex b/Master/texmf-dist/doc/latex/lastpage/lastpage-example.tex
new file mode 100644
index 00000000000..ca05690ffc3
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/lastpage/lastpage-example.tex
@@ -0,0 +1,146 @@
+%%
+%% This is file `lastpage-example.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% lastpage.dtx (with options: `example')
+%%
+%% This is a generated file.
+%%
+%% IMPORTANT NOTICE:
+%% The usual disclaimers apply:
+%% If it doesn't work right that's your problem.
+%% (Nevertheless, send an e-mail to the maintainer
+%% when you find an error in this package.)
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either
+%% version 1.3c of this license or (at your option) any later
+%% version. This version of this license is in
+%% http://www.latex-project.org/lppl/lppl-1-3c.txt
+%% and the latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3c or later is part of all distributions of
+%% LaTeX version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status "maintained".
+%%
+%% The Current Maintainer of this work is H.-Martin Muench
+%% (Martin dot Muench at Uni-Bonn dot de).
+%%
+%% This package was invented by Jeffrey P. Goldberg
+%% (jeffrey+news at goldmark dot org).
+%% I thought that a replacement was needed and therefore created the
+%% pagesLTS package,
+%% http://www.ctan.org/tex-archive/macros/latex/contrib/pagesLTS/pagesLTS.dtx
+%% or
+%% http://www.ctan.org/tex-archive/install/macros/latex/contrib/pagesLTS.tds.zip
+%% . Nevertheless, for compatibility with existing documents/packages as well as
+%% for the low amount of resources needed by the lastpage package (no new counter!),
+%% I updated this package.
+%% Thanks go to Jeffrey P. Goldberg for allowing me to do this.
+%%
+%% This work consists of the main source file lastpage.dtx
+%% and the derived files
+%% lastpage.sty, lastpage.ins, lastpage.drv,
+%% lastpage-example.tex, lastpage.pdf.
+%%
+\documentclass[british]{article}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\usepackage[draft]{showkeys}[2007/08/07]% v3.15
+%% Use final instead of draft to hide the keys. %%
+\usepackage{hyperref}[2010/06/18]% v6.81g
+\hypersetup{%
+ extension=pdf,%
+ plainpages=false,%
+ pdfpagelabels=true,%
+ hyperindex=false,%
+ pdflang={en},%
+ pdftitle={lastpage package example},%
+ pdfauthor={Hans-Martin Muench},%
+ pdfsubject={Example for the lastpage package},%
+ pdfkeywords={LaTeX, lastpage, Hans-Martin Muench},%
+ pdfview=Fit,%
+ pdfstartview=Fit,%
+ pdfpagelayout=SinglePage%
+}
+%% If you disable hyperref, you must also remove the one \href in this example.
+\usepackage{lastpage}[2010/08/25]% v1.2d
+\makeatletter
+\renewcommand{\@evenfoot}%
+ {\normalsize\slshape \today\hfil \upshape page {\thepage} of \pageref{LastPage}}
+\renewcommand{\@oddfoot}{\@evenfoot}
+\gdef\unit#1{\mathord{\thinspace\mathrm{#1}}}%
+\makeatother
+\listfiles
+\begin{document}
+\pagenumbering{Roman}
+
+\section*{Example for lastpage}
+\markboth{Example for lastpage}{Example for lastpage}
+
+This example demonstrates the use of package\newline
+\textsf{lastpage}, v1.2d as of 2010/08/25 (HMM; JPG).\newline
+The package takes no options.\newline
+For more details please see the documentation!\newline
+
+\noindent \label{keys} To hide the \pageref{keys}{\qquad } use option
+\texttt{final} instead of \texttt{draft} with the \textsf{showkeys}
+package (or remove the package call from the preamble of
+this document).\newline
+
+\textbf{Trademarks} appear throughout this example without any
+trademark symbol; they are the property of their respective
+trademark owner. There is no intention of infringement; the
+usage is to the benefit of the trademark owner.\newline
+
+\textbf{Tip}: Use \textit{logical page numbers} for
+the display of the pdf!\newline
+(In Adobe Reader 9.3.3: \underline{E}dit $>$
+Prefere\underline{n}ces (Ctrl+k) $>$ Page Display $>$
+Page Content and Information $>$ Use logical page
+\nolinebreak{\underline{n}umbers.)}\newline
+
+If you are more ambitiouse in respect to your aims with this package,
+you might want to have a look at the \textsf{pagesLTS} package\newline
+(\href{http://www.ctan.org/tex-archive/macros/latex/contrib/pagesLTS/}{%
+CTAN:/macros/latex/contrib/pagesLTS/}).
+
+\bigskip
+
+Save per page about $200\unit{ml}$~water, $2\unit{g}$~CO$_{2}$
+and $2\unit{g}$~wood:\newline
+Therefore please print only if this is really necessary.\newline
+I do NOT think, that it is necessary to print THIS file, really\newline
+(at least not after this page)!
+
+\bigskip
+
+\noindent The page (\texttt{\textbackslash thepage}): \thepage \newline
+
+\noindent Last page's name (LastPage): \pageref{LastPage}
+
+\newpage
+
+\noindent The page (\texttt{\textbackslash thepage}): \thepage \newline
+
+\noindent Last page's name (LastPage): \pageref{LastPage}
+
+\newpage
+
+\noindent The page (\texttt{\textbackslash thepage}): \thepage \newline
+
+\noindent Last page's name (LastPage): \pageref{LastPage}
+
+\newpage
+
+\section*{The End}
+
+\noindent The page (\texttt{\textbackslash thepage}): \thepage \newline
+
+\noindent Last page's name (LastPage): \pageref{LastPage}
+\end{document}
+\endinput
+%%
+%% End of file `lastpage-example.tex'.
diff --git a/Master/texmf-dist/doc/latex/lastpage/lastpage.pdf b/Master/texmf-dist/doc/latex/lastpage/lastpage.pdf
index 3737be8ac94..acfb9b47ef3 100644
--- a/Master/texmf-dist/doc/latex/lastpage/lastpage.pdf
+++ b/Master/texmf-dist/doc/latex/lastpage/lastpage.pdf
Binary files differ
diff --git a/Master/texmf-dist/doc/latex/lastpage/ltxdoc.cfg b/Master/texmf-dist/doc/latex/lastpage/ltxdoc.cfg
new file mode 100644
index 00000000000..2789906c283
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/lastpage/ltxdoc.cfg
@@ -0,0 +1,112 @@
+%%
+%% This is file `ltxdoc.cfg',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% lastpage.dtx (with options: `ltxdoc')
+%%
+%% This is a generated file.
+%%
+%% IMPORTANT NOTICE:
+%% The usual disclaimers apply:
+%% If it doesn't work right that's your problem.
+%% (Nevertheless, send an e-mail to the maintainer
+%% when you find an error in this package.)
+%%
+%% This work may be distributed and/or modified under the
+%% conditions of the LaTeX Project Public License, either
+%% version 1.3c of this license or (at your option) any later
+%% version. This version of this license is in
+%% http://www.latex-project.org/lppl/lppl-1-3c.txt
+%% and the latest version of this license is in
+%% http://www.latex-project.org/lppl.txt
+%% and version 1.3c or later is part of all distributions of
+%% LaTeX version 2005/12/01 or later.
+%%
+%% This work has the LPPL maintenance status "maintained".
+%%
+%% The Current Maintainer of this work is H.-Martin Muench
+%% (Martin dot Muench at Uni-Bonn dot de).
+%%
+%% This package was invented by Jeffrey P. Goldberg
+%% (jeffrey+news at goldmark dot org).
+%% I thought that a replacement was needed and therefore created the
+%% pagesLTS package,
+%% http://www.ctan.org/tex-archive/macros/latex/contrib/pagesLTS/pagesLTS.dtx
+%% or
+%% http://www.ctan.org/tex-archive/install/macros/latex/contrib/pagesLTS.tds.zip
+%% . Nevertheless, for compatibility with existing documents/packages as well as
+%% for the low amount of resources needed by the lastpage package (no new counter!),
+%% I updated this package.
+%% Thanks go to Jeffrey P. Goldberg for allowing me to do this.
+%%
+%% This work consists of the main source file lastpage.dtx
+%% and the derived files
+%% lastpage.sty, lastpage.ins, lastpage.drv,
+%% lastpage-example.tex, lastpage.pdf.
+%%
+\NeedsTeXFormat{LaTeX2e}[1994/06/01]
+\ProvidesFile{ltxdoc.cfg}[2010/07/29 v1.0b configuration file for lastpage (HMM)]
+ %% Code from original ltxdoc.cfg [2007/01/08 latex-tds: ltxdoc.cls configuration (HO)], %%
+ % copyrighted 2006, 2007 Heiko Oberdiek, part of project `latex-tds'.
+ % That file may be distributed and/or modified under the
+ % conditions of the LaTeX Project Public License, either version 1.3
+ % of this license or (at your option) any later version.
+ % The latest version of this license is in
+ % http://www.latex-project.org/lppl.txt
+ % and version 1.3c or later is part of all distributions of LaTeX
+ % version 2005/12/01 or later.
+ % That work has the LPPL maintenance status `maintained'.
+ % The Current Maintainer of that work is Heiko Oberdiek.
+ \PassOptionsToClass{a4paper}{article}
+ \AtEndOfClass{%
+ \RequirePackage[numbered]{hypdoc}[2010/03/26]% v1.9
+ \pdfstringdefDisableCommands{%
+ \let\env\relax % longtable.dtx
+ \let\mytt\relax % tabularx.dtx
+ }%
+ \addtolength{\topmargin}{-10mm}%
+ \addtolength{\textheight}{20mm}%
+ % Depending on the page style, the head or foot area
+ % are put into the text area.
+ % Usually the page style is the default "plain".
+ % tools/verbatim.dtx uses "myheadings".
+ \def\string@plain{plain}%
+ \def\string@myheadings{myheadings}%
+ \def\current@pagestyle{plain}%
+ \let\ltxdoc@cfg@pagestyle\pagestyle
+ \def\pagestyle#1{%
+ \def\current@pagestyle{#1}%
+ \ltxdoc@cfg@pagestyle{#1}%
+ }%
+ \edef\ltxdoc@cfg@jobname{\jobname}%
+ \def\ltxdoc@cfg@longtable{longtable}%
+ \@onelevel@sanitize\ltxdoc@cfg@longtable
+ \ifx\ltxdoc@cfg@jobname\ltxdoc@cfg@longtable
+ \def\current@pagestyle{both}%
+ \fi
+ \let\ltxdoc@cfg@document\document
+ \def\document{%
+ \ifx\current@pagestyle\string@plain
+ \addtolength{\textheight}{\headheight}%
+ \addtolength{\textheight}{\headsep}%
+ \setlength{\headheight}{0pt}%
+ \setlength{\headsep}{0pt}%
+ \global\textheight\textheight
+ \global\headheight\headheight
+ \global\headsep\headsep
+ \fi
+ \ifx\current@pagestyle\string@myheadings
+ \addtolength{\textheight}{\footskip}%
+ \global\textheight\textheight
+ \fi
+ \ltxdoc@cfg@document
+ }%
+ %% End of code from original ltxdoc.cfg [2007/01/08 latex-tds: ltxdoc.cls configuration (HO)] %%
+ %% Place additional code here. %%
+ }
+
+\endinput
+%%
+%% End of file `ltxdoc.cfg'.