Mailman 3 July 2012 - docs

[issue14787] pkgutil.walk_packages returns extra modules
by Nick Coghlan July 16, 2012

July 16, 2012

Nick Coghlan <ncoghlan(a)gmail.com> added the comment: At the very least, the pkgutil docs need to state clearly that walk_packages only works properly with sys.path entries, and the constraint feature may not descend into packages correctly if an entry is shadowed by a sys.modules entry or an entry earlier on sys.meta_path or sys.path. ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14787> _______________________________________

1 0

[issue15297] pkgutil.iter_importers() includes an ImpImporter
by Chris Jerdonek July 15, 2012

July 15, 2012

Chris Jerdonek <chris.jerdonek(a)gmail.com> added the comment: Closing as this is no longer an issue after Nick's pkgutil changes documented in issue 15343. ---------- status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15297> _______________________________________

1 0

[issue14332] Better explain "junk" concept in difflib doc
by Terry J. Reedy July 15, 2012

July 15, 2012

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: I guess I should try to come up with something that is an improvement, even if not perfect. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14332> _______________________________________

1 0

[issue13997] Clearly explain the bare minimum Python 3 users should know about Unicode
by Eli Bendersky July 15, 2012

July 15, 2012

Changes by Eli Bendersky <eliben(a)gmail.com>: ---------- nosy: -eli.bendersky _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13997> _______________________________________

1 0

[issue14332] Better explain "junk" concept in difflib doc
by Eli Bendersky July 15, 2012

July 15, 2012

Eli Bendersky <eliben(a)gmail.com> added the comment: ping ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue14332> _______________________________________

1 0

[issue13823] xml.etree.ElementTree.ElementTree.write - argument checking
by patrick vrijlandt July 15, 2012

July 15, 2012

New submission from patrick vrijlandt <patrick.vrijlandt(a)gmail.com>: (1) The docs say: xml_declaration controls if an XML declaration should be added to the file. Use False for never, True for always, None for only if not US-ASCII or UTF-8 or Unicode (default is None). The method also accepts other values, like xml_declaration = "yes". This behavior should be documented, or raise a ValueError (up to effbot, I think) (2) The docs say (in a note): The encoding string included in XML output should conform to the appropriate standards. For example, “UTF-8” is valid, but “UTF8” is not. See http://www.w3.org/ But the method accepts both values, (“UTF-8” and “UTF8”). Since this will result in invalid xml, (but not invalid python) it should probably raise ValueError too. (3) Open issue 9458 also refers to this method. It might be wise to raise ValueError if the encoding does not match the (mode of the) file target (binary or text). ---------- assignee: docs@python components: Documentation, XML messages: 151612 nosy: docs@python, patrick.vrijlandt priority: normal severity: normal status: open title: xml.etree.ElementTree.ElementTree.write - argument checking versions: Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue13823> _______________________________________

3 3

[issue9458] xml.etree.ElementTree.ElementTree.write(): encoding handling problems
by Eli Bendersky July 15, 2012

July 15, 2012

Eli Bendersky <eliben(a)gmail.com> added the comment: I agree with Serhiy that this is more of a documentation/understanding issue than a real bug. I've clarified the doc of ElementTree.write a bit to make it explicit what stream is expected for 'write'. ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9458> _______________________________________

1 0

[issue15331] Codecs docs should explain that the bytes-bytes shorthand aliases are missing
by Nick Coghlan July 14, 2012

July 14, 2012

Nick Coghlan <ncoghlan(a)gmail.com> added the comment: While you're right about that, the docs shouldn't be claiming they're available as long as that is the case. Updated the issue to make it clear this is a problem with the current docs and the change in the nature of the encode() and decode() methods for Python 3. ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: test needed -> needs patch title: Missing codec aliases for bytes-bytes codecs -> Codecs docs should explain that the bytes-bytes shorthand aliases are missing _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15331> _______________________________________

1 0

[issue15241] venv module and pyvenv script documented, but not python behavior itself
by Éric Araujo July 13, 2012

July 13, 2012

New submission from Éric Araujo <merwok(a)netwok.org>: I did not find any doc or test for the behavior of the interpreter in virtual mode, only for venv and pyvenv. A new paragraph in site.py exists, but it’s missing from site.rst, contains what I think is an error (saying that sys.prefix is always the real prefix), and should be somewhere more obvious than the site docs or linked from somewhere more obvious, like the Usage and Setup docs or maybe the tutorial. ---------- assignee: docs@python components: Documentation, Tests messages: 164563 nosy: docs@python, eric.araujo, vinay.sajip priority: normal severity: normal status: open title: venv module and pyvenv script documented, but not python behavior itself versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15241> _______________________________________

3 5

[issue15345] HOWTOs Argparse tutorial - code example raises SyntaxError
by Simon Hayward July 13, 2012

July 13, 2012

New submission from Simon Hayward <simonhayward(a)gmail.com>: HOWTOs - Argparse Tutorial, the code example will raise a syntax error when run. A trailing python3 reference (if called as a function): 'end=""', to suppresses a newline remains. print "{}^{} == ".format(args.x, args.y), end="" Should read: print "{}^{} ==".format(args.x, args.y), ---------- assignee: docs@python components: Documentation files: argparse-howto.patch keywords: patch messages: 165381 nosy: docs@python, simon.hayward priority: normal severity: normal status: open title: HOWTOs Argparse tutorial - code example raises SyntaxError type: behavior versions: Python 2.7 Added file: http://bugs.python.org/file26374/argparse-howto.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15345> _______________________________________

4 3