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...