Mailman 3 September 2012 - docs

[issue15964] SyntaxError in asdl when building 2.7 with system Python 3
by Chris Jerdonek 23 Sep '12

23 Sep '12

Chris Jerdonek added the comment: > We should be able to add the "make touch" target to the 2.7 Makefile without running afoul of the "no new features" rule. I created issue 16004 for this: http://bugs.python.org/issue16004 ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15964> _______________________________________

1 0

[issue15964] SyntaxError in asdl when building 2.7 with system Python 3
by Chris Jerdonek 23 Sep '12

23 Sep '12

Chris Jerdonek added the comment: > We should be able to add the "make touch" target to the 2.7 Makefile without running afoul of the "no new features" rule. To keep things simpler, I'm going to create a separate issue for this so that it can be discussed and committed independently of this doc-only issue. If necessary, we can always modify the answers to existing FAQ's in that issue. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15964> _______________________________________

1 0

[issue15964] SyntaxError in asdl when building 2.7 with system Python 3
by Nick Coghlan 22 Sep '12

22 Sep '12

Nick Coghlan added the comment: We should be able to add the "make touch" target to the 2.7 Makefile without running afoul of the "no new features" rule. However, agreed this is mostly a docs problem. We're seeing a couple of common traps that people run into when first getting started, so it will be good to get answers up somewhere where people are likely to look (and where search engines will be able to see the error messages). ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15964> _______________________________________

1 0

[issue15964] SyntaxError in asdl when building 2.7 with system Python 3
by Chris Jerdonek 22 Sep '12

22 Sep '12

Chris Jerdonek added the comment: Adding Nick because he is the one that suggested adding a "Build Troubleshooting" section to the devguide FAQ (meant to add him above). ---------- nosy: +ncoghlan _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15964> _______________________________________

1 0

[issue15964] SyntaxError in asdl when building 2.7 with system Python 3
by Chris Jerdonek 22 Sep '12

22 Sep '12

Chris Jerdonek added the comment: Attaching patch. I started a new section in the FAQ called "Build Troubleshooting" which is something Nick suggested in the context of addressing this issue. I'm sure we could add a couple more questions to this section right now if we wanted to. ---------- keywords: +patch Added file: http://bugs.python.org/file27260/issue-15964-1.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15964> _______________________________________

1 0

[issue15956] backreference to named group does not work
by Terry J. Reedy 22 Sep '12

22 Sep '12

Terry J. Reedy added the comment: I read it as a 'native speaker' and it looks fine to me. Table is clear, but I will let doc stylist decide. ---------- nosy: +terry.reedy _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15956> _______________________________________

1 0

[issue15964] SyntaxError in asdl when building 2.7 with system Python 3
by Chris Jerdonek 21 Sep '12

21 Sep '12

Chris Jerdonek added the comment: Switching this to a devguide issue so the work-around can be documented, for example in this section: http://docs.python.org/devguide/faq.html#how-do-i-switch-between-branches-i… ---------- assignee: -> docs@python components: +Devguide, Documentation -Build keywords: +easy nosy: +docs@python, ezio.melotti stage: -> needs patch type: behavior -> enhancement _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15964> _______________________________________

1 0

[issue15980] Non-escaped '\n' in docstrings
by Serhiy Storchaka 21 Sep '12

21 Sep '12

New submission from Serhiy Storchaka: Here are patches that escapes '\n' in docstrings of LWPCookieJar and (for 2.7 only) of email. ---------- assignee: docs@python components: Documentation files: escape_nl2.patch keywords: patch messages: 170794 nosy: docs@python, ezio.melotti, storchaka priority: normal severity: normal status: open title: Non-escaped '\n' in docstrings type: enhancement versions: Python 2.7, Python 3.2, Python 3.3 Added file: http://bugs.python.org/file27229/escape_nl2.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15980> _______________________________________

3 3

[issue15548] Mention all new os functions in What's New in Python 3.3
by STINNER Victor 20 Sep '12

20 Sep '12

New submission from STINNER Victor: The os module has a lot of new functions in Python 3.3. It looks like only a few are documented in What's New in Python 3.3. Examples : truncate(), ftruncate() and sync() are not mentionned. Does Sphinx have a function to list of new functions added to Python 3.3? At least to check that the What's New in Python 3.3 is complete. I would like to have the full list to check that new functions are consistent. See for example the issue #15547. ---------- assignee: docs@python components: Documentation messages: 167315 nosy: docs@python, georg.brandl, haypo, larry, rhettinger priority: normal severity: normal status: open title: Mention all new os functions in What's New in Python 3.3 versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15548> _______________________________________

5 5

[issue15985] round() has wrong argument names
by Chris Jerdonek 20 Sep '12

20 Sep '12

New submission from Chris Jerdonek: The documentation for round() says: round(x[, n]) Return the floating point value x rounded to n digits after the decimal point. If n is omitted, it defaults to zero. Delegates to x.__round__(n). (from http://docs.python.org/dev/library/functions.html#round ) However, we have the following: Python 3.3.0rc2+ (default:1704deb7e6d7+, Sep 16 2012, 04:49:45) >>> round(x=4.7) Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: Required argument 'number' (pos 1) not found >>> round(number=4.7) 5 The second argument is also affected: >>> round(5.1234, n=3) Traceback (most recent call last): File "<stdin>", line 1, in <module> TypeError: 'n' is an invalid keyword argument for this function >>> round(5.1234, ndigits=3) 5.123 ---------- assignee: docs@python components: Documentation keywords: easy messages: 170822 nosy: cjerdonek, docs@python priority: normal severity: normal stage: needs patch status: open title: round() has wrong argument names type: behavior versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15985> _______________________________________

4 8