diff options
author | Karl Berry <karl@freefriends.org> | 2010-09-08 23:08:23 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-09-08 23:08:23 +0000 |
commit | ee2de76f7db0b19a657a7f3b9ba8768bc8e69e37 (patch) | |
tree | cb89ecf46c7a4843251d70c2aa0341a945c81353 /Master/texmf-dist/doc/latex | |
parent | d9c6145293d327c544fc033d3e9956fc1afc5b25 (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')
-rw-r--r-- | Master/texmf-dist/doc/latex/lastpage/README | 146 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/lastpage/README.lastpage | 22 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/lastpage/lastpage-example.pdf | bin | 0 -> 128200 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/lastpage/lastpage-example.tex | 146 | ||||
-rw-r--r-- | Master/texmf-dist/doc/latex/lastpage/lastpage.pdf | bin | 166512 -> 498075 bytes | |||
-rw-r--r-- | Master/texmf-dist/doc/latex/lastpage/ltxdoc.cfg | 112 |
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 Binary files differnew file mode 100644 index 00000000000..bbe410bdeb9 --- /dev/null +++ b/Master/texmf-dist/doc/latex/lastpage/lastpage-example.pdf 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 Binary files differindex 3737be8ac94..acfb9b47ef3 100644 --- a/Master/texmf-dist/doc/latex/lastpage/lastpage.pdf +++ b/Master/texmf-dist/doc/latex/lastpage/lastpage.pdf 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'. |