[Beni Cherniavsky <cben@us...>]

I've written a quite comprehensive and very flexible Makefile for
driving docutils.  I hope it will save others the work.  It was
availible for some time but I restructured it a little, mergeing its
two parts into one file for easier deployment and improving the
documentation.  I consider it stable now.  It's avaliable under:

http://docutils.sourceforge.net/sandbox/cben/make/

`<Makefile.docutils>`_ is a makefile that handles most things one
would want to do with docutils.  For minimal applications it can be
used directly; typically you would include it in your makefiles,
e.g.::

    DOCS = foo.txt bar.txt

    include Makefile.docutils

This makefile is very flexible and can be configured by setting many
variables.  It also supports pre/postprocessing, currently with
`sandbox/cben/rolehack <../rolehack>`_ scripts and rudimentary
output-format-dependant adaptation of ``.*`` names with sed scripts.

The makefile is heavily commented and the comments themeselves are in
reST (sort of literate programming).  A script (`<make2rst.py>`_) is
provided that can convert the whole file to legal reST - run ``make``
in this directory to build the docs (``make ps pdf`` would give you
more formats).

Enjoy and tell me (cben@...) if you miss any functionality or
flexibility...

-- 
Beni Cherniavsky <cben@...>
Note: I can only read email on week-ends...

... that can be fixed at any time.  Bugs are written to be squashed.  ;-)
  -- Fred L. Drake, Jr. on python-dev