This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author r.david.murray
Recipients docs@python, eric.araujo, hoffman, r.david.murray
Date 2010-11-19.16:52:30
SpamBayes Score 9.363188e-05
Marked as misclassified No
Message-id <1290185552.55.0.727094149379.issue10396@psf.upfronthosting.co.za>
In-reply-to
Content
The argument against adding this to the pdb docs is that if you pull in that statement from cmd, you really ought to pull in the full description of the __init__ arguments. And whether you do that or just pull in that single statement, you are duplicating the documentation from cmd.  This *may* be best, but it does increase the maintenance burden, since any change to cmd will require changes to both the cmd and pdb docs, whereas now someone changing cmd doesn't need to know that they also have to update pdb.  If the situation being documented here improves in some way, I'll bet we will forget to update the pdb docs accordingly....

So, I'm -1 on adding this to the pdb docs, but will bow to the wisdom of the doc folks :)
History
Date User Action Args
2010-11-19 16:52:32r.david.murraysetrecipients: + r.david.murray, hoffman, eric.araujo, docs@python
2010-11-19 16:52:32r.david.murraysetmessageid: <1290185552.55.0.727094149379.issue10396@psf.upfronthosting.co.za>
2010-11-19 16:52:31r.david.murraylinkissue10396 messages
2010-11-19 16:52:30r.david.murraycreate