[Paroli] Docstrings, please?

David Fokkema dfokkema at ileos.nl
Fri Jun 19 22:42:23 CEST 2009


Hi list,

(for just the praise, skip the rant)

rant:
Paroli really could do with some docstrings. Presently, I'm trying to
figure out which eml_*_window to use. Is there _any_ documentation on
that?

I'm used to import all kinds of things and then read the docstrings. I'm
also used to just reading the code, if necessary. I _think_ I'm starting
to understand (elm_list_window has a scroller, whereas elm_layout_window
does not) but docstrings (even single-line ones) really help here. I'm
beginning to understand edje and paroli (I hope), but actually hacking
existing code or writing a complete app requires documentation.
/rant

praise:
Of course, I'm still in awe of the work that has been done around
openmoko. So many projects, distributions, etc. all with their own goals
and visions. Most of them are really thought out, including, I think,
paroli.
/praise

Thanks,

David




More information about the support mailing list