Re: [pygame] updating the docs

[Peter Shinners <pete@xxxxxxxxxxxx>]

On Tue, 2005-10-04 at 17:05 -0700, Bob Ippolito wrote:
> reStructuredText (docutils) would be a much better target.. the  
> signal:noise is REALLY high, and you can export to just about  
> anything useful (including docbook) without having to write an  
> exporter yourself.

Rest is very cool for articles. I tried to use it awhile ago, but
couldn't figure out how to apply it to reference. I just found this
yesterday,

http://docutils.sourceforge.net/sandbox/edloper/docpy/asyncore.rst

It doesn't look too bad as far as markup goes. It wouldn't be hard to
convert. I am unable to convert this document to anything using the rest
tools. I guess I need some sort of stylesheet since I get these errors, 

asyncore.rst:270: (ERROR/3) Unknown interpreted text role "label".
asyncore.rst:272: (ERROR/3) Unknown interpreted text role "class".

Is anyone more experienced with restructured text and the python
docutils?