[Doc-SIG] Docutils config file reorganization

[David Goodger]

Just checked in; "[options]" is dead (well, hanging on by a thread),
long live "[general]", "[html4css1 writer]", etc. etc.  Docs here:
<http://docutils.sf.net/docs/config.html>.  Please take it out for a
good spin, and let me know if there are any problems.

To convert existing config files, the easiest way is to change
"[options]" to "[general]".  Most settings haven't changed.  The only
ones to watch out for are these:

     pep_stylesheet      -->  [pep_html writer] stylesheet
     pep_stylesheet_path -->  [pep_html writer] stylesheet_path
     pep_template        -->  [pep_html writer] template

The old-style config files will still work, but a deprecation warning
is issued.

-- 
David Goodger    http://starship.python.net/~goodger
For hire: http://starship.python.net/~goodger/cv
Docutils: http://docutils.sourceforge.net/
(includes reStructuredText: http://docutils.sf.net/rst.html)