Mailman 3 February 2014 - docs

Re: [docs] Add doc examples for DictReader and DictWriter (issue 20351)
by vadmium+py＠gmail.com Feb. 10, 2014

Feb. 10, 2014

http://bugs.python.org/review/20351/diff/10699/Doc/library/csv.rst File Doc/library/csv.rst (right): http://bugs.python.org/review/20351/diff/10699/Doc/library/csv.rst#newcode1… Doc/library/csv.rst:166: Wonderful SPAM I think the space argument to print() shouldn’t be there; print() should already be adding the single space separator on its own. Also, making the capitalisation agree with the DictWriter example below would be nice. http://bugs.python.org/review/20351/

1 0

[issue9694] argparse required arguments displayed under "optional arguments"
by Martin Panter Feb. 10, 2014

Feb. 10, 2014

Martin Panter added the comment: A new “required arguments” section seems too arbitrary to me. It would clash with the “positional arguments” heading, since those are also required by default. I would go with the heading “options”, as a noun. That term seems to be well used, at least on Linux and Wikipedia (see https://en.wikipedia.org/wiki/Command-line_option). Other terms are “flag” and “switch”. In this thread I see two arguments against this: 1. Eric Smith prefers to retain the noun “… [View More]

1 0

[issue19871] json module won't parse a float that starts with a decimal point
by Ezio Melotti Feb. 10, 2014

Feb. 10, 2014

Ezio Melotti added the comment: I missed this comment from Serhiy: > There are too many cases where json and Python syntax differ. How many differences there are between the two? I think we might add notes to the table at http://docs.python.org/3/library/json.html#encoders-and-decoders (either something similar to the notes in the table at http://docs.python.org/3/library/stdtypes.html#mutable-sequence-types, or just a couple of lines in a third column). If there are too many differences … [View More]

1 0

[issue19906] Typo in urllib documentation
by Claudiu.Popa Feb. 10, 2014

Feb. 10, 2014

New submission from Claudiu.Popa: In the first note from urllib.rst, there is a reference to urllib being replaced by urllib2 in Python 3, which is False. ---------- assignee: docs@python components: Documentation files: urllib2.patch keywords: patch messages: 205359 nosy: Claudiu.Popa, docs@python priority: normal severity: normal status: open title: Typo in urllib documentation type: enhancement versions: Python 2.7 Added file: http://bugs.python.org/file33002/urllib2.patch … [View More]

4 5

[issue20573] "built-in repr()" function link on the repr module documentation is incorrect
by Ned Deily Feb. 9, 2014

Feb. 9, 2014

Changes by Ned Deily <nad(a)acm.org>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20573> _______________________________________

1 0

[issue19363] Python 2.7's future_builtins.map is not compatible with Python 3's map
by Nick Coghlan Feb. 8, 2014

Feb. 8, 2014

Nick Coghlan added the comment: Switched to be a docs-only bug as Gareth suggested. ---------- assignee: rhettinger -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python, ncoghlan resolution: wont fix -> stage: committed/rejected -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue19363> _______________________________________

1 0

[issue20477] Add examples of using the new contentmanager api to the email docs
by R. David Murray Feb. 7, 2014

Feb. 7, 2014

New submission from R. David Murray: Here are the examples I promised to write in issue 18891. ---------- assignee: docs@python components: Documentation, email files: contentmanager-examples.patch keywords: patch messages: 209922 nosy: barry, docs@python, r.david.murray priority: normal severity: normal stage: commit review status: open title: Add examples of using the new contentmanager api to the email docs type: behavior versions: Python 3.4 Added file: http://bugs.python.org/file33850/… [View More]

2 2

[issue20386] socket.SocketType enum overwrites import of _socket.SocketType
by Ethan Furman Feb. 6, 2014

Feb. 6, 2014

Ethan Furman added the comment: Thanks for the hints, Georg! ---------- Added file: http://bugs.python.org/file33945/issue20386.stoneleaf.04.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue20386> _______________________________________

1 0

[issue12691] tokenize.untokenize is broken
by Gareth Rees Feb. 6, 2014

Feb. 6, 2014

Gareth Rees added the comment: I did some research on the cause of this issue. The assertion was added in this change by Jeremy Hylton in August 2006: <https://mail.python.org/pipermail/python-checkins/2006-August/055812.html> (The corresponding Mercurial commit is here: <http://hg.python.org/cpython/rev/cc992d75d5b3#l217.25>). At that point I believe the assertion was reasonable. I think it would have been triggered by backslash-continued lines, but otherwise it worked. But in … [View More]

1 0

[issue20488] importlib title and introduction are out of date
by R. David Murray Feb. 6, 2014

Feb. 6, 2014

New submission from R. David Murray: Now that importlib *is* the import system in CPython, the title ("An Implementation of import") and the intro ("a reference implementation that is easier to comprehend than..." seem to me like they are out of date and should be reworded. ---------- assignee: docs@python components: Documentation messages: 209994 nosy: brett.cannon, docs@python, eric.snow, r.david.murray priority: normal severity: normal status: open title: importlib title and introduction … [View More]

3 3