From 789dcb3c382a6a5d267ac8b0cd363aa33d5a70cd Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 11 Jun 2010 16:36:25 +0000 Subject: new latex pkg undolabl (10jun10) git-svn-id: svn://tug.org/texlive/trunk@18896 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/undolabl/README | 149 +++++++++++++++++++++ Master/texmf-dist/doc/latex/undolabl/ltxdoc.cfg | 109 +++++++++++++++ .../doc/latex/undolabl/undolabl-example.pdf | Bin 0 -> 66928 bytes .../doc/latex/undolabl/undolabl-example.tex | 127 ++++++++++++++++++ Master/texmf-dist/doc/latex/undolabl/undolabl.pdf | Bin 0 -> 362702 bytes 5 files changed, 385 insertions(+) create mode 100644 Master/texmf-dist/doc/latex/undolabl/README create mode 100644 Master/texmf-dist/doc/latex/undolabl/ltxdoc.cfg create mode 100644 Master/texmf-dist/doc/latex/undolabl/undolabl-example.pdf create mode 100644 Master/texmf-dist/doc/latex/undolabl/undolabl-example.tex create mode 100644 Master/texmf-dist/doc/latex/undolabl/undolabl.pdf (limited to 'Master/texmf-dist/doc/latex/undolabl') 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 + + + +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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/undolabl/undolabl-example.pdf differ 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 Binary files /dev/null and b/Master/texmf-dist/doc/latex/undolabl/undolabl.pdf differ -- cgit v1.2.3