readme.txt                                           1999/04/13

This file describes the files in directory
  CTAN:macros/latex/contrib/supported/oberdiek/
It contains four packages:

* hypbmsec 1999/04/12 v2.0 Bookmarks in sectioning commands.
* pagesel  1999/04/13 v1.1 Selecting shipout pages.
* alphalph 1999/04/13 v1.1 Converting numbers to letters.
* twoopt   1999/04/12 v1.3 Definitions with two optional arguments.

COPYRIGHT, DISCLAIMER, LIZENZ
=============================

Copyright (C) 1999 Heiko Oberdiek.

The files listed below can be redistributed and/or modified under
the terms of the LaTeX Project Public License distributed from
CTAN archives in directory macros/latex/base/lppl.txt; either
version 1 of the License, or (at your option) any later version.

FILES
=====
readme.txt:   this file.

hypbmsec.dtx: docstrip archive and documentation source.
hypbmsec.ins: docstrip installation script.
hypbmsec.pdf: documentation.

pagesel.dtx:  docstrip archive and documentation source.
pagesel.ins:  docstrip installation script.
pagesel.pdf:  documentation.

alphalph.dtx: docstrip archive and documentation source.
alphalph.ins: docstrip installation script.
alphalph.sty: package file (for TeX users without docstrip).
alphalph.pdf: documentation.

twoopt.dtx:   docstrip archive and documentation source.
twoopt.ins:   docstrip installation script.
twoopt.pdf:   documentation.

holtxdoc.zip: archive with files for generating the documenation:
 * holtxdoc.sty: * common macros for all dtx files
                 * hyperref support
                 * patches, bug fixes
 * hothread.sty  * writes thread informations into the log file.
 * hothread.pl   * perl script that reads the thread informations
                   and updates the pdf file, it is a workaround
                   for bugs in pdfTeX (tested with 0.13b).

REQUIREMENTS
============
All packages are LaTeX2e packages.
alphalph can be used by plain-TeX, too.

SHORT USER INTERFACE
====================
For a longer description see the pdf files.

* With package hypbmsec bookmark entries can be given in another
  argument of the sectioning commands, e.g.:
    out = outline string, toc = string in table of contents
    \section{toc, out, txt}
    \section[toc, out]{txt}
    \section[toc][out]{txt}
    \section[toc](out){txt}
    \section(out)[toc]{txt}
    \section(out){toc, txt}
  hyperref is required to get the bookmarks, but the syntax work
  without hyperref, too.

* pagesel selects single pages, page areas, odd, or even pages
  for output.

* alphalph provides the new expandable commands \alphalph
  \AlphAlph. They are like \number, but the expansion consists of
  lowercase and uppercase letters respectively:
     1..26 = a..z
    27..52 = aa..az
    53..78 = ba..bz
   702,703 = zz, aaa
  So the commands can be used as an replacement for LaTeX's \@alph
  and \@Alph macros.

* twoopt provides commands to define macros with two optional
  arguments:
  \newcommandtwoopt{\Cmd}[3][DefaultA][DefaultB]{Args: #1, #2, #3}
  \renewcommandtwoopt, \providecommandtwoopt

INSTALLATION
============
The packages are in docstrip format. For unpacking all run:
  tex oberdiek.ins
or for a single package file run:
  tex <package>.ins

Generating the documentation:
  1. latex <package>.dtx
  2. makeindex -rs <package>
  3. latex <package>.dtx
  4. makeindex -rs <package>
  5. latex <package>.dtx
Remarks:
* alphalph needs another cycle of latex/makeindex.
* holtxdoc.sty of holtxdoc.zip is needed (see above).
* For hyperlink support hyperref is required. For other than the
  default drivers use an appropriate hyperref.cfg file.
* pdfTeX users:
  * Thumbnail support is added by package thumbpdf:
      CTAN:macros/pdftex/thumbpdf/
    6. thumbpdf <package>
    7. latex <package>
  * For correct article threads hothread.sty and hothread.pl
    (holtxdoc.zip) are needed to correct bugs in pdfTeX:
    8. hothread <package>

AUTHOR
======
Heiko Oberdiek
Email: oberdiek@ruf.uni-freiburg.de

QUESTIONS, SUGGESTED IMPROVEMENTS
=================================

If you have questions, problems with 'thumbpdf', error reports,
if you have improvements or want to have additional features,
please send them to the author.

Happy TeXing
