[cairo] python bindings documentaion?

[Steve Chaplin]

On Tue, 2006-02-21 at 16:34 -0800, Carl Worth wrote:
> Just to throw something else into the mix. I recently took a closer
> look at asciidoc. See:
> 
> 	http://www.methods.co.nz/asciidoc/
> 
> It can generate HTML, man pages, DocBook, (and obviously, any DocBook
> targets). It has a "wiki-like" syntax in that the source text document
> for the documentation is quite readable directly.
> 
> The only drawback I've found in the short bit I've played with it,
> (the git documentation uses it), is that the document generation is
> quite slow, (and I do mean *really* slow).
> 
> I do find the source format and the number of output formats quite
> appealing though. I think I might try writing a cairo tutorial in it
> to really try it out. (Notice that the asciidoc web pages are
> generated in asciidoc and you can get a feel for what it can do).
> 
> I'm not entirely sure it would make sense to switch cairo's API
> documentation system, but I'm open to options.

I had a look at asciidoc, it does produce very nice looking HTML.

A cairo tutorial in asciidoc format would be very useful for all cairo
bindings - they could take the text file and edit it to convert C into
the binding language.

Writing cairo's API in asciidoc format would be useful in the same way,
and would avoid the need to cut and paste from the cairo *.c files.

cairo and all its bindings could then have a consistent set of
documents, all using the same format and derived from the same 'master'
documents.

Steve

Send instant messages to your online friends http://au.messenger.yahoo.com