On Tue, 1 Apr 2008 08:14:01 -0700 (PDT) "Edward K. Ream" <[EMAIL PROTECTED]> wrote:
> def finalize_options (self): > > # This method (and its pliant slaves, like 'finalize_unix()', > # 'finalize_other()', and 'select_scheme()') is where the default Hmm, a formatted paragraph of narrative text occurring at the start of a method definition. If only there was some way for that string to be included in the documentation... :-) I don't see how anything can let you code against an API as fast as up to date, complete, and accurate documentation does. Plenty of packages manage to provide that, PIL and lxml are just a couple I've used recently. And docstrings work so nicely with ipython. Documentation's great, it's just too often neglected and missing. I've had a lot of trouble understanding distutils too, if I remember correctly too many "here's an example" and not enough "this function takes these inputs, does this to them, makes these outputs, and they have these types". One gotcha I ran into was the system automatically creating a MANIFEST file, and then ignoring me in favor of it's not updated contents. Of course I could have been doing something wrong. Cheers -Terry --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "leo-editor" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/leo-editor?hl=en -~----------~----~----~----~------~----~------~--~---
