[issue30211] Bdb: add docstrings

2017-05-16 Thread Terry J. Reedy
Terry J. Reedy added the comment: I still need to push a News Entry. -- ___ Python tracker ___ ___

[issue30211] Bdb: add docstrings

2017-05-16 Thread Terry J. Reedy
Terry J. Reedy added the comment: New changeset 0774e79b93cc494b3a957d538c7c112e289973c0 by terryjreedy (csabella) in branch 'master': bpo-30211: bdb: add docstrings (#1350) https://github.com/python/cpython/commit/0774e79b93cc494b3a957d538c7c112e289973c0 --

[issue30211] Bdb: add docstrings

2017-05-16 Thread Terry J. Reedy
Terry J. Reedy added the comment: I plan to merge when I can. Possible future improvements for bdb.py. 1. Bdb attributes. 2. Say what user_xyz functions might do. Anything better than 'Intervene in debugging process.'? 3. Clarify what get_stack does. Improvement for bdb.rst (optional for

[issue30211] Bdb: add docstrings

2017-05-16 Thread Cheryl Sabella
Cheryl Sabella added the comment: Thank you. I had some questions that I put on the commit. You're right about it saying it must be in canonic form and then it calls canonic. I figured someone added the call later to prevent an error, but didn't change the warning, but I didn't know if I

[issue30211] Bdb: add docstrings

2017-05-16 Thread Terry J. Reedy
Terry J. Reedy added the comment: The bdb class or __init__ docstring needs to document the data members with a short explanation. Some of the args need better explanation. Some of this I may fill in *after* reviewing the proposed tests, when I understand the code better. Reviewing pdb and

[issue30211] Bdb: add docstrings

2017-05-15 Thread Terry J. Reedy
Terry J. Reedy added the comment: As I just posted to core-mentorship, my attempt to push to the PR failed. Did you leave the 'allow pushes' box checked when you created the PR? -- ___ Python tracker

[issue30211] Bdb: add docstrings

2017-05-15 Thread Terry J. Reedy
Terry J. Reedy added the comment: In the entry at https://docs.python.org/3/library/bdb.html#bdb.Bdb.canonic, ", stripped of surrounding angle brackets" is wrong, and should be replaced by ". 'Filenames' with angle brackets, such as "", generated in interactive mode, are returned unchanged"

[issue30211] Bdb: add docstrings

2017-04-30 Thread Cheryl Sabella
Changes by Cheryl Sabella : -- components: +Documentation -IDLE ___ Python tracker ___ ___

[issue30211] Bdb: add docstrings

2017-04-30 Thread Cheryl Sabella
Changes by Cheryl Sabella : -- components: +IDLE -Documentation ___ Python tracker ___ ___

[issue30211] Bdb: add docstrings

2017-04-29 Thread Cheryl Sabella
New submission from Cheryl Sabella: Add docstrings to Bdb. See issue 19417. -- assignee: docs@python components: Documentation messages: 292598 nosy: csabella, docs@python, terry.reedy priority: normal pull_requests: 1467 severity: normal status: open title: Bdb: add docstrings type: