s�n 2004-06-13 klockan 01.07 skrev Gustavo J. A. M. Carneiro:
> A S�b, 2004-06-12 �s 23:18, Johan Dahlin escreveu:
> > There are a couple of things wrt to the documentation that I'd like to
> > change/solve before 2.4.
> > 
> > 1) Include the reference manual in the pygtk tarball (like in gtk+)
> > 2) Likewise for the tutorial
> 
> > 3) Generate .devhelp files on the fly
> 
>   Can you expand on this?  Generate from what and how?

A devhelp file has two sections; 
1) TOC, index file with at tree over all the sections
2) A list of all function names, class names, structs etc

1 is quite easy to generate, since you can just look at all <a> tags
with href properties.

2 is harder, since we want the string "gtk.Button.set_text" map to
foo/bar/baz/class-gtkbutton.html#set_text and do the correct thing.

Clear.

> > And once 1) is done, change commit policy so an api/change addition is
> > required to add/change the appropriate documentation so it stays
> > updated.
> 
>   I'm afraid this policy would only inhibit contributions from lazy
> people, such as myself :-P

Just poke someone (John perhaps) to update it for you then!

-- 
Johan Dahlin <[EMAIL PROTECTED]>

_______________________________________________
pygtk mailing list   [EMAIL PROTECTED]
http://www.daa.com.au/mailman/listinfo/pygtk
Read the PyGTK FAQ: http://www.async.com.br/faq/pygtk/

Reply via email to