Author rhettinger
Recipients barry, docs@python, r.david.murray, rhettinger, xmorel
Date 2011-02-22.21:23:03
SpamBayes Score 0.000321667
Marked as misclassified No
Message-id <1298409784.53.0.410672954296.issue11260@psf.upfronthosting.co.za>
In-reply-to
Content
> As I said, my only intention here is be to document 
> (and argparsify/formalize) what is already there.

In a handful of cases, that would be useful; however,
for the most part, these APIs were undocumented for
a reason.  Some of the command-line interfaces were
slapped together without much of a design effort; some
were little more than quick-and-dirty ad-hoc tests.
It would be a mistake to "document and formalize"
accidental mini-apps.

There's no harm in adding --help or a usage example,
but please avoid making behavior guarantees that we
really don't want to have to live with.

Only "document and formalize" the parts that are well
thought out.
History
Date User Action Args
2011-02-22 21:23:04rhettingersetrecipients: + rhettinger, barry, r.david.murray, xmorel, docs@python
2011-02-22 21:23:04rhettingersetmessageid: <1298409784.53.0.410672954296.issue11260@psf.upfronthosting.co.za>
2011-02-22 21:23:03rhettingerlinkissue11260 messages
2011-02-22 21:23:03rhettingercreate