Mailman 3 December 2011 - docs

[issue13557] exec of list comprehension fails on NameError
by Éric Araujo Dec. 10, 2011

Dec. 10, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: Would you like to make a doc patch? ---------- assignee: -> docs@python components: +Documentation keywords: +easy nosy: +docs@python, eric.araujo resolution: invalid -> stage: -> needs patch versions: +Python 2.7, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13557> _______________________________________

1 0

[issue13538] Improve doc for str(bytesobject)
by Éric Araujo Dec. 10, 2011

Dec. 10, 2011

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- title: Docstring of str() and/or behavior -> Improve doc for str(bytesobject) _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13538> _______________________________________

1 0

[issue13538] Docstring of str() and/or behavior
by Éric Araujo Dec. 10, 2011

Dec. 10, 2011

Éric Araujo <merwok(a)netwok.org> added the comment: A note in the docs (without note/warning directives, just a note) and maybe the docstring would be good. It should better explain that str has two uses: converting anything to a str (using __str__ or __repr__), decode buffer to str (with encoding and errors arguments). str(b'') is a case of the first use, not the second (and likewise %s formatting). ---------- nosy: +eric.araujo _______________________________________ Python … [View More]

1 0

[issue13528] Rework performance FAQ
by Antoine Pitrou Dec. 9, 2011

Dec. 9, 2011

New submission from Antoine Pitrou <pitrou(a)free.fr>: This is a slimmed down rewrite of the performance question in the FAQ (also moved around to a dedicated subheader). ---------- assignee: docs@python components: Documentation files: perffaq.patch keywords: patch messages: 148853 nosy: docs@python, pitrou, rhettinger priority: normal severity: normal stage: patch review status: open title: Rework performance FAQ versions: Python 3.2, Python 3.3 Added file: http://bugs.python.org/… [View More]

2 2

[issue13538] Docstring of str() and/or behavior
by Antoine Pitrou Dec. 6, 2011

Dec. 6, 2011

Antoine Pitrou <pitrou(a)free.fr> added the comment: Well, I forgot to mention it in my previous message, but there is already a warning that you can activate with the -b option: $ ./python -b Python 3.3.0a0 (default:6b6c79eba944, Dec 6 2011, 11:11:32) [GCC 4.5.2] on linux Type "help", "copyright", "credits" or "license" for more information. >>> str(b"") __main__:1: BytesWarning: str() on a bytes instance "b''" And you can even turn it into an error with -bb: $ ./python -… [View More]

1 0

[issue13538] Docstring of str() and/or behavior
by R. David Murray Dec. 6, 2011

Dec. 6, 2011

R. David Murray <rdmurray(a)bitdance.com> added the comment: A diff would be great. We try to use warnings sparingly, and I don't think this is a case that warrants it. Possibly a .. note is worthwhile, perhaps with an example for the bytes case, but even that may be too much. I also wouldn't use the wording "is totally different from what you would expect", since by now I do expect it :). How about something like "the result will not be the decoded version of the bytes, but instead … [View More]

1 0

[issue13538] Docstring of str() and/or behavior
by Guillaume Bouchard Dec. 6, 2011

Dec. 6, 2011

Guillaume Bouchard <guillaum.bouchard(a)gmail.com> added the comment: > str always falls back to the repr; in general str(obj) should always return some value, otherwise the assumptions of a *lot* of Python code would be broken. Perhaps it may raises a warning ? ie, the only reason encoding exists if for the conversion of bytes (or something which looks like bytes) to str. Do you think it may be possible to special case the use of str for bytes (and bytesarray) with something like … [View More]

1 0

[issue13538] Docstring of str() and/or behavior
by Antoine Pitrou Dec. 6, 2011

Dec. 6, 2011

Antoine Pitrou <pitrou(a)free.fr> added the comment: > Personally I'm not at all sure why str takes encoding and errors > arguments (I never use them). Probably because the unicode type also did in 2.x. And also because it makes it compatible with arbitrary buffer objects: >>> str(memoryview(b"foo"), "ascii") 'foo' ---------- nosy: +pitrou _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13538> _______________________________________

1 0

[issue13538] Docstring of str() and/or behavior
by R. David Murray Dec. 6, 2011

Dec. 6, 2011

R. David Murray <rdmurray(a)bitdance.com> added the comment: I agree with you that this is inconsistent. However, having str raise an error is pretty much a non-starter as a suggestion. str always falls back to the repr; in general str(obj) should always return some value, otherwise the assumptions of a *lot* of Python code would be broken. Personally I'm not at all sure why str takes encoding and errors arguments (I never use them). I'd rather there be only one way to do that, decode.… [View More]

1 0

[issue13527] Remove obsolete mentions in the GUIs page
by Antoine Pitrou Dec. 4, 2011

Dec. 4, 2011

New submission from Antoine Pitrou <pitrou(a)free.fr>: The "Other Graphical User Interface Packages" page (library/othergui.html) lists "Python megawidgets" and "Tkinter3000 Widget Construction Kit (WCK)". These two projects look pretty much dead to me, so I'm proposing to remove them. ---------- assignee: docs@python components: Documentation messages: 148821 nosy: docs@python, pitrou priority: low severity: normal status: open title: Remove obsolete mentions in the GUIs page versions: … [View More]

3 3