LaTeX macros for use in TUGboat
===============================

This is the first public distribution of a set of macros I have been
working on for some time.  The macros are still `work in progress',
and I hope to deliver new versions fairly regularly.

These macros *are* supported; please do *not* bother the TUGboat
editor with queries about the macros (or the TUGboat proceedings
editor, if you're preparing an article for submission to a TUG
conference).  Bother me, instead (the editors do, in any case, so you
might as well short-circuit them ;-)

Robin Fairbairns
rf@cl.cam.ac.uk

Installation and use:
=====================

The directory contains four files containing TeX code:

  tugboat.dtx  -- the source for the macros
  tugboat.ins  -- the docstrip instructions
  old-boat.ins -- docstrip instructions for LaTeX distributions before
                  1995/12/01 (*much* slower)
  ltubguid.ltx -- documentation for the macros (published in TUGboat 52)

Processing one of the .ins files produces:

  ltugboat.cls -- For preparing articles for regular issues of TUGboat
  ltugproc.cls -- For preparing articles for conference proceedings
  ltugboat.sty -- The usual `obsolete file' warning
  ltugproc.sty -- The usual `obsolete file' warning
  ltugcomn.sty -- Used when processing tugboat.dtx for its
                  documentation content
  ltugbib.bst  -- A BibTeX style to match ltugboat.cls's default
                  biblio capabilities

The procedure for using the macros should therefore be:

  process a .ins file
  move the .sty and .cls to "somewhere LaTeX will search", and
       the .bib to "somewhere BibTeX will search"
  process the .dtx file for its documentation content

The macros, once unpacked, make use of Ulrik Vieth's mflogo.sty, if
it's available on your system; otherwise they hack up a small set of
replacement commands.  I recommend Ulrik's package to you; you can
find it on CTAN in directory macros/latex/contrib/supported/mflogo

The `user-level' documentation may be acquired by processing
ltubguid.ltx with LaTeX.  The documentation, having been published in
TUGboat, needs ltugboat.cls to run.  You are strongly recommended to
acquire a copy of url.sty (available from CTAN macros/latex/contrib/
other/misc); booktabs.sty (available from CTAN macros/latex/contrib/
supported/booktabs) is also desirable, but you can get along without
it.