new latex pkg undolabl (10jun10)

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

5 files changed, 385 insertions, 0 deletions

diff --git a/Master/texmf-dist/doc/latex/undolabl/README b/Master/texmf-dist/doc/latex/undolabl/README
new file mode 100644
index 00000000000..6d869990788
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/undolabl/README
@@ -0,0 +1,149 @@
+README for undolabl package, 2010/06/03, v1.0b
+
+
+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 allows to override existing labels,
+especially automatically generated ones.
+
+Note: The main code of the undolabl package was invented
+by Ulrich Diez (eu_angelion at web dot de) in 2008 and
+published on the internet. While Ulrich Diez neither
+wanted to create a package himself nor have one published
+under his name, he granted the publication of his code.
+Therefore: Thanks!
+I (H.-Martin Münch) submitted this package to CTAN
+(after some updates of the documentation, mainly layout,
+ typos and such things.)
+
+
+2 DOWNLOAD
+==========
+
+`undolabl' is available on CTAN:
+  CTAN:macros/latex/contrib/muench/undolabl/
+
+Also a ZIP file is provided that contains the files, already
+sorted in a TDS tree:
+  CTAN:install/macros/latex/contrib/muench/undolabl.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/muench/pagesLTS/
+corresponds to
+  CTAN:macros/latex/contrib/muench/pagesLTS/
+
+
+3 INSTALLATION
+==============
+
+Installation with ZIP file in TDS format
+----------------------------------------
+The ZIP file `undolabl.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.../undolabl.tds.zip
+Do not forget to refresh the file name database of this
+TDS tree.
+Example:
+  texhash /...somewhere.../texmf
+
+Manual installation
+-------------------
+a) Download the undolabl 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 undolabl.ins
+d) Install the files `*.sty', and `*.cfg' in your TDS tree:
+     cp *.sty *.cfg TDS:tex/latex/muench/undolabl/
+   Replace `TDS:' by the prefix of your TDS tree
+   (texmf directory).
+e) Copy the documentation files to
+   "TDS:doc/latex/muench/undolabl/":
+   README, undolabl.pdf, undolabl-example.tex,
+   undolabl-example.pdf.
+f) Update the databases if necessary, e. g. for teTeX:
+     mktexlsr .../texmf
+
+
+4 ADDITIONAL PACKAGES
+=====================
+
+undolabl itself does not load other packages,
+but working with labels usually means using
+* hyperref.sty:
+    CTAN:macros/latex/contrib/hyperref/
+which again loads other packages
+(see the result of the \listfiles command in the log-file
+ of the example).
+
+
+5 PACKAGE COMPATIBILITY
+=======================
+
+There are no known incompatibilities (yet).
+
+6 AUTHOR/MAINTAINER
+=====================
+
+* Author of the original main code: Ulrich Dietz (Thanks!)
+* Author of the recent package and 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
+=================
+
+* as yet: none...
\ No newline at end of file
diff --git a/Master/texmf-dist/doc/latex/undolabl/ltxdoc.cfg b/Master/texmf-dist/doc/latex/undolabl/ltxdoc.cfg
new file mode 100644
index 00000000000..741f977af09
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/undolabl/ltxdoc.cfg
@@ -0,0 +1,109 @@
+%%
+%% This is file `ltxdoc.cfg',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% undolabl.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).
+%% 
+%% The main code of this package was invented by Ulrich Diez
+%% (eu_angelion@web.de) in 2008 and published on the internet.
+%% While Ulrich Diez neither wanted to create a package himself
+%% nor have one published under his name, he granted the
+%% publication of his code. Therefore: Thanks!
+%% 
+%% This work consists of the main source file undolabl.dtx
+%% and the derived files
+%%    undolabl.sty, undolabl.pdf, undolabl.ins, undolabl.drv,
+%%    undolabl-example.tex.
+%% 
+\NeedsTeXFormat{LaTeX2e}[1994/06/01]
+\ProvidesFile{ltxdoc.cfg}[2010/06/01 v1.0 configuration file for undolabl (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'.
diff --git a/Master/texmf-dist/doc/latex/undolabl/undolabl-example.pdf b/Master/texmf-dist/doc/latex/undolabl/undolabl-example.pdf
new file mode 100644
index 00000000000..7c703c3e60f
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/undolabl/undolabl-example.pdf
diff --git a/Master/texmf-dist/doc/latex/undolabl/undolabl-example.tex b/Master/texmf-dist/doc/latex/undolabl/undolabl-example.tex
new file mode 100644
index 00000000000..240b29ac491
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/undolabl/undolabl-example.tex
@@ -0,0 +1,127 @@
+%%
+%% This is file `undolabl-example.tex',
+%% generated with the docstrip utility.
+%%
+%% The original source files were:
+%%
+%% undolabl.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).
+%% 
+%% The main code of this package was invented by Ulrich Diez
+%% (eu_angelion@web.de) in 2008 and published on the internet.
+%% While Ulrich Diez neither wanted to create a package himself
+%% nor have one published under his name, he granted the
+%% publication of his code. Therefore: Thanks!
+%% 
+%% This work consists of the main source file undolabl.dtx
+%% and the derived files
+%%    undolabl.sty, undolabl.pdf, undolabl.ins, undolabl.drv,
+%%    undolabl-example.tex.
+%% 
+
+\documentclass[british]{article}
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+\usepackage{undolabl}[2010/06/03]% v1.0b
+%% There are no options for the undolabl package. %%
+\usepackage{hyperref}[2010/05/13]% v6.81e; if you want to use nameref
+\hypersetup{%
+ extension=pdf,%
+ plainpages=false,%
+ pdfpagelabels=true,%
+ hyperindex=false,%
+ pdflang={en},%
+ pdftitle={undolabl package example},%
+ pdfauthor={Hans-Martin Muench},%
+ pdfsubject={Example for the undolabl package},%
+ pdfkeywords={LaTeX, undolabl, Hans-Martin Muench},%
+ pdfview=FitH,%
+ pdfstartview=FitH,%
+ pdfpagelayout=OneColumn,%
+ bookmarksopen=true%
+}
+\makeatletter
+%% Code from tcilatex.tex, Macros for Scientific Word and Scientific WorkPlace 5.5 <06 Oct 2005> %%
+%% Copyright (C) 2005 Mackichan Software, Inc.                                                   %%
+%% That macro file is NOT proprietary and may be freely copied and distributed.                  %%
+  \def\unit#1{\mathord{\thinspace\rm #1}}%
+%% End of code from tcilatex.tex                                                                 %%
+\makeatother
+\listfiles
+\begin{document}
+\pagenumbering{arabic}
+\section*{Example for undolabl}
+
+This example demonstrates the use of package\newline
+\textsf{undolabl}, v1.0b as of 2010/06/03 (HMM).\newline
+The used options were \texttt{linktextcolour=black},
+\texttt{backgroundcolour=white}, and \texttt{pdfborder={0 0 1}}
+(the default ones).\newline
+For more details please see the documentation!\newline
+
+\noindent 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
+
+\bigskip
+
+\section{Test}
+
+text \label{testlabel}\\
+page-reference: \pageref{testlabel}\\%% -> page 4
+sectional-reference: \ref{testlabel}\\%% -> section 4
+name-reference: \nameref{testlabel}%% -> Still another test
+
+\newpage
+
+\section{Another test}
+
+text \overridelabel{testlabel}\\
+page-reference: \pageref{testlabel}\\%% -> page 4
+sectional-reference: \ref{testlabel}\\%% -> section 4
+name-reference: \nameref{testlabel}%% -> Still another test
+
+\newpage
+
+\section{Yet another test}
+
+text \overridelabel{testlabel}\\
+page-reference: \pageref{testlabel}\\%% -> page 4
+sectional-reference: \ref{testlabel}\\%% -> section 4
+name-reference: \nameref{testlabel}%% -> Still another test
+
+\newpage
+
+\section{Still another test}
+
+text \overridelabel{testlabel}\\
+page-reference: \pageref{testlabel}\\%% -> page 4
+sectional-reference: \ref{testlabel}\\%% -> section 4
+name-reference: \nameref{testlabel}%% -> Still another test
+
+\end{document}
+
+\endinput
+%%
+%% End of file `undolabl-example.tex'.
diff --git a/Master/texmf-dist/doc/latex/undolabl/undolabl.pdf b/Master/texmf-dist/doc/latex/undolabl/undolabl.pdf
new file mode 100644
index 00000000000..993c8f7c2ad
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/undolabl/undolabl.pdf