[PYTHON DOC-SIG] Structured Text Module

[Jim Fulton]

Hi,

Some time ago I told some folks about a module I have for converting
structured text to HTML.  I suggested that this would be useful
when generating documentation for python modules.  Well, I'm finally 
getting around to releasing it.  To find out about the structured text
module, see:

  http://www.digicool.com/jim/python/StructuredText.html

Or you can get the module itself at:

  http://www.digicool.com/jim/python/StructuredText.py

I wrote this while working on my own module documentation tool,
module2html:

  http://www.digicool.com/jim/python/module2html.py

I'm releasing this both as an example of using StructuredText and as a
source of ideas for improving gendoc.  Some ideas perhaps worth 
borrowing:

  - A first cut at supporting built-in types.  This is not much 
    use without my meta-type module or MESS. 
  - Use of meta-data alone.  No parsing of python code is done.
    This is important if we want to document built-in modules.
    And I do.
  - Use of structured text to provide pretty rich text formatting
    capabilities while keeping the text readable.

Jim

-- 
Jim Fulton         Digital Creations
jim@digicool.com   540.371.6909
## Python is my favorite language ##
##     http://www.python.org/     ##

=================
DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org
=================