Mailman 3 July 2011 - docs

[issue4819] Misc/cheatsheet needs updating
by Éric Araujo July 13, 2011

July 13, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: I spent a few minutes updating the cheatsheet. I think that the document is an outdated duplicate of random parts of the docs (syntax, man page, library reference, etc.) that’s rather hard to maintain for little benefit. Is there any evidence that people used it? I’d like to propose that we delete the file in 2.7 (it’s already gone from 3.2+) and that we start anew on a real cheatsheet, i.e. one or two A4 pages, in HTML and PDF and … [View More]

1 0

[issue10224] Build 3.x documentation using python3.x
by Sye van der Veen July 13, 2011

July 13, 2011

Sye van der Veen <syeberman(a)gmail.com> added the comment: When I built the documentation on Win7, it failed with a SyntaxError, and it took some digging to find the reason why. I was hoping that issuing this warning would save others the trouble. I agree: on Windows, PYTHON is rarely set. However, look in make.bat: you'll see that when PYTHON is not already set, it's set to ..\pcbuild\python, which is Python 3. ---------- _______________________________________ Python tracker <… [View More]

1 0

logging.Logger.debug example doesn't work
by Robert Xiao July 13, 2011

July 13, 2011

The Logger.debug example (at http://docs.python.org/py3k/library/logging.html#logging.Logger.debug) does not actually work in Python 3.2: Python 3.2 (r32:88452, Feb 20 2011, 11:12:31) [GCC 4.2.1 (Apple Inc. build 5664)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> import logging >>> FORMAT = '%(asctime)-15s %(clientip)s %(user)-8s %(message)s' >>> logging.basicConfig(format=FORMAT) >>> d = {'clientip': '192.168.0.1', '… [View More]user': 'fbloggs'} >>> logging.warning('Protocol problem: %s', 'connection reset', extra=d) Traceback (most recent call last): File "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py", line 934, in emit msg = self.format(record) File "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py", line 809, in format return fmt.format(record) File "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py", line 551, in format s = self.formatMessage(record) File "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py", line 520, in formatMessage return self._style.format(record) File "/Library/Frameworks/Python.framework/Versions/3.2/lib/python3.2/logging/__init__.py", line 371, in format return self._fmt % record.__dict__ KeyError: 'asctime' Logged from file <stdin>, line 1 The problem is that the logger expects to see the exact string "%(asctime)s" in the format string before it will add the asctime attribute. Using the "-15" modifier on the asctime causes the match to fail, and the asctime attribute is not emitted. To fix the example, change %(asctime)-15s to %(asctime)s: Python 3.2 (r32:88452, Feb 20 2011, 11:12:31) [GCC 4.2.1 (Apple Inc. build 5664)] on darwin Type "help", "copyright", "credits" or "license" for more information. >>> import logging >>> FORMAT = '%(asctime)s %(clientip)s %(user)-8s %(message)s' >>> logging.basicConfig(format=FORMAT) >>> d = { 'clientip' : '192.168.0.1', 'user' : 'fbloggs' } >>> logger = logging.getLogger('tcpserver') >>> logger.warning('Protocol problem: %s', 'connection reset', extra=d) 2011-07-12 13:39:44,317 192.168.0.1 fbloggs Protocol problem: connection reset This also reflects a problem in the library in that it is not flexible enough to understand different formats. As a separate matter, perhaps the library could be amended to always include the asctime field (the asctime string could be lazily computed by using a class instance for which the __str__ method produces the actual formatted date), rather than trying to guess when it is needed. Robert [View Less]

2 1

[issue3565] array documentation, method names not 3.x-compliant
by Matt Giuca July 13, 2011

July 13, 2011

Matt Giuca <matt.giuca(a)gmail.com> added the comment: There are still some inconsistencies in the documentation (in particular, incorrectly using the word "string" to refer to a bytes object, which made sense in Python 2 but not 3), which I fixed in my doc-only.patch file that's coming up to its third birthday. Most of it has been fixed with the previous change which added 'tobytes' and 'frombytes' and made tostring and fromstring aliases. But there are some places which don't make … [View More]

1 0

[issue3565] array documentation, method names not 3.x-compliant
by Antoine Pitrou July 12, 2011

July 12, 2011

Antoine Pitrou <pitrou(a)free.fr> added the comment: > Is there still any idea/intention of renaming .from/.tounicode to > .from/.tostring? That would have to be done at least one version with > the 'string' names absent, and would have little gain as 'unicode' is > clear. Indeed, not only it would bring little benefit, but may also confuse users porting from 2.x (since the from/tostring methods would then have a totally different meaning). ---------- resolution: -> … [View More]

1 0

[issue9254] __import__ docstring should recommend importlib.import_module()
by Brett Cannon July 12, 2011

July 12, 2011

Brett Cannon <brett(a)python.org> added the comment: Patch looks good to me. ---------- stage: needs patch -> commit review _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9254> _______________________________________

1 0

[issue3565] array documentation, method names not 3.x-compliant
by Éric Araujo July 12, 2011

July 12, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: It was Antoine in fa8b57f987c5, for #8990. ---------- nosy: +eric.araujo _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue3565> _______________________________________

1 0

[issue9254] __import__ docstring should recommend importlib.import_module()
by Éric Araujo July 12, 2011

July 12, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: The docstring of __import__ was updated to mention importlib in 3d490c3a019e, for #7397. Attached patch edits the docs. ---------- keywords: +patch versions: -Python 3.1 Added file: http://bugs.python.org/file22629/__import__-mention-importlib.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9254> _______________________________________

1 0

[issue12343] ssl documentation needs comments about non-blocking behaviour
by Antoine Pitrou July 10, 2011

July 10, 2011

Antoine Pitrou <pitrou(a)free.fr> added the comment: I'd say this is fixed now. Tell me if there are any precisions you would like to see added. ---------- resolution: -> fixed stage: needs patch -> committed/rejected status: open -> closed versions: -Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue12343> _______________________________________

1 0

[issue12343] ssl documentation needs comments about non-blocking behaviour
by Roundup Robot July 10, 2011

July 10, 2011

Roundup Robot <devnull@devnull> added the comment: New changeset b763c1ba5589 by Antoine Pitrou in branch '3.2': Issue #12343: Add some notes on behaviour of non-blocking SSL sockets. http://hg.python.org/cpython/rev/b763c1ba5589 New changeset 77334eb5038d by Antoine Pitrou in branch 'default': Issue #12343: Add some notes on behaviour of non-blocking SSL sockets. http://hg.python.org/cpython/rev/77334eb5038d ---------- nosy: +python-dev _______________________________________ Python … [View More]

1 0