R. David Murray <rdmur...@bitdance.com> added the comment:

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 :)

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue10396>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to