Am 2010-10-14 um 19:53 schrieb Paul McNett: > > I tried a few systems before rolling my own, and the reason I rolled > my own was that > I felt there was far too much noise in the output, mostly due to all > of the classes > involved in a given Dabo object. I couldn't seem to get control over > issues like > "don't list all the wx-layer stuff". > > Also, it was tough to train the other systems how to find the UI > classes, because of > the indirection we use. When I got it to work, it gave incorrect > information > (dabo.ui.uiwx.dTextBox versus dabo.ui.dTextBox).
I understand. Of course, dabo is doing some magic here... >> I just tried Sphinx on dabo - it's easy and looks good, but requires >> you at least to list all modules, that you want documented, in ReST >> files. >> If I'll ever complete my current projects, I can provide a setup for >> that, if you like. > > It would be nice to see it, and I'm open to switching to something > else but don't > really have much time these days to make such a pursuit myself. I also don't have any time (150% work in 50% work time...), but if I use open source software and get help by its developers, I feeld obligated to give something back. You might not believe it, but I really *like* writing docs. Since there's so much documentation in dabo's code, I guess you also don't really hate it :-) Unfortunately dabo's wiki is rather untended - and even in "my home wiki" (wiki.contextgarden.net, where I'm a mere garden hand), there's too much left to do, despite an active community... And I wanted to open source my dabo-based tool-kit for a long time, but that needs some more work and even more documentation to be useful... Enough moaning, back to work. Greetlings from Lake Constance! Hraban --- http://www.fiee.net https://www.cacert.org (I'm an assurer) _______________________________________________ Post Messages to: [email protected] Subscription Maintenance: http://leafe.com/mailman/listinfo/dabo-users Searchable Archives: http://leafe.com/archives/search/dabo-users This message: http://leafe.com/archives/byMID/[email protected]
