Mailman 3 November 2015 - docs

[issue25732] functools.total_ordering does not correctly implement not equal behaviour
by R. David Murray Nov. 25, 2015

Nov. 25, 2015

Changes by R. David Murray <rdmurray(a)bitdance.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25732> _______________________________________

1 0

[issue25697] Fix rough alphabetical order in Misc/ACKS
by Serhiy Storchaka Nov. 25, 2015

Nov. 25, 2015

New submission from Serhiy Storchaka: the list in Misc/ACKS is intended to be in rough alphabetical order by last names. But some lines breaks this order. Proposed patch restores ordering. It also removes duplicates for Richard Oudkerk. Correct sorting is not easy due to different letter order in different alphabets and different collation rules in different languages. I tried to take it into account, but can make a mistake. ---------- assignee: docs@python components: Documentation files: … [View More]

4 7

Docs.python.org/3/download.html no-go
by Marc Tofsted Nov. 25, 2015

Nov. 25, 2015

Gentlemen, None of the links on this page are working today. Thanks for your help. Marc Tofsted

2 1

[issue25730] invisible sidebar content with code snippets
by Ezio Melotti Nov. 25, 2015

Nov. 25, 2015

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, ezio.melotti, georg.brandl, terry.reedy stage: -> needs patch type: -> behavior _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue25730> _______________________________________

1 0

Document that tp_setattro and tp_setattr are used for deleting attributes (issue 25701)
by victor.stinner＠gmail.com Nov. 25, 2015

Nov. 25, 2015

http://bugs.python.org/review/25701/diff/16034/Doc/c-api/object.rst File Doc/c-api/object.rst (right): http://bugs.python.org/review/25701/diff/16034/Doc/c-api/object.rst#newcode… Doc/c-api/object.rst:72: otherwise set it to *v* (``o.attr_name = v``). Returns ``-1`` on failure. I know that it's not a common Python doc, but I prefer to explicitly say that an exception is raised in case of error. I suggest: Raise an exception and returns -1 on failure, return 0 on success. (Same change for … [View More]

1 0

[issue20923] ConfigParser should nested [] in section names.
by STINNER Victor Nov. 25, 2015

Nov. 25, 2015

STINNER Victor added the comment: > It would be good if ConfigParser supported angled brackets in section names by being greedy when parsing. I agree with Terry, it's the opposite: we must explicitly reject them to be compatible with other applications. Please move the discussion to issue #25723. ---------- nosy: +haypo resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20923> _______________________________________

1 0

[issue10796] Improve doc for readline.set_completer_delims()
by Martin Panter Nov. 25, 2015

Nov. 25, 2015

Martin Panter added the comment: I propose to address this with the general documentation bug, Issue 6953 ---------- dependencies: +readline documenation needs work nosy: +martin.panter title: readline completion flaw -> Improve doc for readline.set_completer_delims() _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10796> _______________________________________

1 0

[issue25576] Remove “Content-Type: application/x-www-form-urlencoded; charset” advice
by Martin Panter Nov. 25, 2015

Nov. 25, 2015

New submission from Martin Panter: I understand using a “charset” parameter with “Content-Type: application/x-www-form-urlencoded” is not standardized. Since Issue 11082, the documentation advises to use it, but I propose to remove this advice. HTML 5 mentions setting a _charset_ parameter, and mentions decoding with a default of UTF-8 (not Latin-1!), but does not mention any Content-Type parameters. There seems to be confusion about what encoding it actually represents. According to <… [View More]

3 6

[issue20923] ConfigParser should nested [] in section names.
by Terry J. Reedy Nov. 25, 2015

Nov. 25, 2015

Terry J. Reedy added the comment: Discussion continues because my close message was, I now realize, incomplete and therefore unsatisfying. Ditto for the doc. So I complete my close message here and reopen issue to augment the doc. The discussion has so far has glossed over the key question: "What is a legal section name?" Pulling the answer from the doc was a challenge. It uses 'legal section name', once, as if one should already know. Reading further, I found the answer: there is no (… [View More]

1 0

[issue25700] namedtuple documentation
by Laur Joost Nov. 24, 2015

Nov. 24, 2015

New submission from Laur Joost: collections.namedtuple documentation has an example about changing the resulting class docstrings: Docstrings can be customized by making direct assignments to the ``__doc__`` fields: >>> Book = namedtuple('Book', ['id', 'title', 'authors']) >>> Book.__doc__ += ': Hardcover book in active collection' This seems to work for the resulting class, but not the field names: MsgPacket = namedtuple('MsgPacket', ['sender', '… [View More]

3 3