Mailman 3 March 2013 - docs

[issue17414] timeit.timeit not in __all__ even though documented
by Terry J. Reedy March 15, 2013

March 15, 2013

Changes by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17414> _______________________________________

1 0

[issue17414] timeit.timeit not in __all__ even though documented
by Terry J. Reedy March 15, 2013

March 15, 2013

Terry J. Reedy added the comment: Fred Drake, Eli Bendersky, and in particular, Guido ("I do see that it shouldn't be backported, but I don't see any worries about doing it in 3.4.") said that this is a 3.4-only enhancement. Anuj, ACKS are alphabetical. Åstrand is at the end because that is where Å sorts. Thanks for the patch. We hope to see more. ---------- versions: -Python 2.6, Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17414> _______________________________________

1 0

[issue17414] timeit.timeit not in __all__ even though documented
by Roundup Robot March 15, 2013

March 15, 2013

Roundup Robot added the comment: New changeset dda8a6b8a351 by Terry Jan Reedy in branch 'default': Issue #17414: Add timeit, repeat, and default_timer to timeit.__all__. http://hg.python.org/cpython/rev/dda8a6b8a351 ---------- nosy: +python-dev _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17414> _______________________________________

1 0

[issue17414] timeit.timeit not in __all__ even though documented
by Terry J. Reedy March 15, 2013

March 15, 2013

Terry J. Reedy added the comment: As long as we are editing the module docstring, the last sentence should be deleted in 3.x patches, and the preceding sentence added to the preceding paragraph. In 3.3+, the paragraph beginning "The difference in default timer function" is obsolete and should be removed. Anuj, I believe patch is correct for 2.7, so I do not think more patch versions are needed now. I see the __all__ change as both behavior fix and enhancement, so I don't know whether there should be one fix or four. I posted "Matching __all__ to doc: bugfix or enhancement?" on pydev to see what other think. (Reminder to self: remove old code to handle absence of itertools from stdlib. This will break the current patch.) ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17414> _______________________________________

1 0

[issue16471] upgrade to sphinx 1.1
by Chris Jerdonek March 15, 2013

March 15, 2013

New submission from Chris Jerdonek: This issue is to upgrade Python's Sphinx from version 1.0 to 1.1. I don't already see an issue for this, and I'm not sure what upgrading entails. Personally, I'm interested in the enhanced indexing capabilities, e.g. the "see" and "seealso" entry types, as well as marking main index entries: http://sphinx-doc.org/markup/misc.html#directive-index I'm sure other reasons for upgrading have been floated, though I don't know what they are. ---------- assignee: docs@python components: Documentation messages: 175560 nosy: chris.jerdonek, docs@python priority: normal severity: normal status: open title: upgrade to sphinx 1.1 type: enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________

4 4

[issue17414] timeit.timeit not in __all__ even though documented
by Anuj Gupta March 14, 2013

March 14, 2013

Anuj Gupta added the comment: I'm a new contributor so, not sure if I'm missing anything: The issue seems straightforward to me, the exports should definitely be included in both - the docstring and __all__. Also, default_timer is documented and should be imported as well. I've contributed a patch for the dev version. After a review, I can submit patches for all remaining versions. Thanks! ---------- keywords: +patch nosy: +anuj Added file: http://bugs.python.org/file29407/timeit_exports.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17414> _______________________________________

1 0

[issue13604] update PEP 393 (match implementation)
by Ezio Melotti March 14, 2013

March 14, 2013

Ezio Melotti added the comment: What's the status of this? ---------- nosy: +ezio.melotti _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13604> _______________________________________

1 0

[issue17414] timeit.timeit not in __all__ even though documented
by Ezio Melotti March 14, 2013

March 14, 2013

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation keywords: +easy nosy: +docs@python, ezio.melotti stage: -> needs patch versions: +Python 2.7, Python 3.2, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17414> _______________________________________

1 0

Improve -O docs (issue 17232)
by ezio.melotti＠gmail.com March 14, 2013

March 14, 2013

http://bugs.python.org/review/17232/diff/7583/Doc/using/cmdline.rst File Doc/using/cmdline.rst (right): http://bugs.python.org/review/17232/diff/7583/Doc/using/cmdline.rst#newcode… Doc/using/cmdline.rst:214: :const:`__debug__`. Change the filename extension for compiled Does this link to the place where __debug__ is documented (assuming there is such place)? http://bugs.python.org/review/17232/diff/7583/Doc/using/cmdline.rst#newcode… Doc/using/cmdline.rst:221: Discard docstrings in addition to what :option:`-O` does. What about "Like :option:`-O`, but also discard docstrins."? http://bugs.python.org/review/17232/diff/7583/Modules/main.c File Modules/main.c (right): http://bugs.python.org/review/17232/diff/7583/Modules/main.c#newcode69 Modules/main.c:69: -O : remove assert and __debug__-dependent statements; change .py\n\ Shouldn't this be .pyc? http://bugs.python.org/review/17232/diff/7583/Modules/main.c#newcode71 Modules/main.c:71: -OO : remove doc-strings in addition to the -O changes\n\ I would re-use the same wording I proposed for the docs. http://bugs.python.org/review/17232/

1 0

[issue17243] The changes made for issue 4074 should be documented
by Ezio Melotti March 13, 2013

March 13, 2013

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python type: behavior -> enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue17243> _______________________________________

1 0