Mailman 3 October 2012 - docs

[issue15888] ipaddress HOWTO examples have some errors
by Chris Jerdonek Oct. 7, 2012

Oct. 7, 2012

New submission from Chris Jerdonek: The ipaddress HOWTO seems to have some errors in its interactive doctest examples. Below are the errors after running the doctests for it using the regrtest patch posted to issue 15629. (This is the first doc file for which I have used the modified script to open an issue.) The errors seem valid to me on casual inspection. Note that you need to add an initial ">>> import ipaddress" at the beginning of the first doctest example to have these actually run. ---------------------------------------------------------------------- File "Doc/howto/ipaddress.rst", line 146, in ipaddress.rst Failed example: ipaddress.ip_network('2001:db8::1/96') Exception raised: Traceback (most recent call last): File "Lib/doctest.py", line 1287, in __run compileflags, 1), test.globs) File "<doctest ipaddress.rst[15]>", line 1, in <module> ipaddress.ip_network('2001:db8::1/96') File "Lib/ipaddress.py", line 79, in ip_network return IPv6Network(address, strict) File "Lib/ipaddress.py", line 2056, in __init__ raise ValueError('%s has host bits set' % self) ValueError: 2001:db8::1/96 has host bits set ---------------------------------------------------------------------- File "Doc/howto/ipaddress.rst", line 181, in ipaddress.rst Failed example: net4.numhosts Exception raised: Traceback (most recent call last): File "Lib/doctest.py", line 1287, in __run compileflags, 1), test.globs) File "<doctest ipaddress.rst[25]>", line 1, in <module> net4.numhosts AttributeError: 'IPv4Network' object has no attribute 'numhosts' ---------------------------------------------------------------------- File "Doc/howto/ipaddress.rst", line 184, in ipaddress.rst Failed example: net6.numhosts Exception raised: Traceback (most recent call last): File "Lib/doctest.py", line 1287, in __run compileflags, 1), test.globs) File "<doctest ipaddress.rst[27]>", line 1, in <module> net6.numhosts AttributeError: 'IPv6Network' object has no attribute 'numhosts' ---------------------------------------------------------------------- File "Doc/howto/ipaddress.rst", line 190, in ipaddress.rst Failed example: for x in net4.hosts(): Exception raised: Traceback (most recent call last): File "Lib/doctest.py", line 1287, in __run compileflags, 1), test.globs) File "<doctest ipaddress.rst[29]>", line 1 for x in net4.hosts(): ^ SyntaxError: unexpected EOF while parsing ---------------------------------------------------------------------- File "Doc/howto/ipaddress.rst", line 219, in ipaddress.rst Failed example: addr6.exploded Expected: '2001:0db8:0000:0000:0000:0000:0000:0000' Got: '2001:0db8:0000:0000:0000:0000:0000:0001' ---------------------------------------------------------------------- File "Doc/howto/ipaddress.rst", line 221, in ipaddress.rst Failed example: addr6.compressed Expected: '2001:db8::' Got: '2001:db8::1' ---------------------------------------------------------------------- File "Doc/howto/ipaddress.rst", line 244, in ipaddress.rst Failed example: net6[1] Expected: IPv6Address('2001::1') Got: IPv6Address('2001:db8::1') ---------------------------------------------------------------------- File "Doc/howto/ipaddress.rst", line 246, in ipaddress.rst Failed example: net6[-1] Expected: IPv6Address('2001::ffff:ffff') Got: IPv6Address('2001:db8::ffff:ffff') ---------- assignee: docs@python components: Documentation keywords: easy messages: 170097 nosy: cjerdonek, docs@python, ncoghlan, pmoody priority: normal severity: normal stage: needs patch status: open title: ipaddress HOWTO examples have some errors type: behavior versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue15888> _______________________________________

4 11

[issue16082] xml.etree.ElementTree.tostringlist does not conform to its documentation
by Eli Bendersky Oct. 7, 2012

Oct. 7, 2012

Eli Bendersky added the comment: Thanks for the report. I'll take a look. Patches always welcome :) ---------- stage: -> patch review title: xml.etree.ElementTree.tostringlist does conform to it's documentation -> xml.etree.ElementTree.tostringlist does not conform to its documentation _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16082> _______________________________________

1 0

[issue16149] "Decimal(2) != float(2)" documentation bug
by Michele Orrù Oct. 6, 2012

Oct. 6, 2012

New submission from Michele Orrù: Follows from the discussion on python-dev: http://mail.python.org/pipermail/python-dev/2012-September/121871.html ---------- assignee: docs@python components: Documentation messages: 172182 nosy: docs@python, maker, terry.reedy priority: normal severity: normal status: open title: "Decimal(2) != float(2)" documentation bug versions: Python 3.3, Python 3.4 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16149> _______________________________________

4 6

missing method
by Mark Summerfield Oct. 6, 2012

Oct. 6, 2012

Hi, On page: http://docs.python.org/py3k/library/difflib.html#module-difflib class difflib.Differ has a compare() method: but it isn't shown. -- Mark Summerfield, Qtrac Ltd, www.qtrac.eu C++, Python, Qt, PyQt - training and consultancy "Programming in Python 3" - ISBN 0321680561 http://www.qtrac.eu/py3book.html

2 1

damn it .... Look at this function....
by 逸君曹 Oct. 6, 2012

Oct. 6, 2012

stat.S_IMODE(*mode*) it output 493 when one file has permission settings 755 !!!!! it seems it directly output binary: 111,101,101 as a whole number!!!

2 1

[issue16025] Minor corrections to the zipfile documentation
by Serhiy Storchaka Oct. 6, 2012

Oct. 6, 2012

New submission from Serhiy Storchaka: The proposed patch corrects a few markup errors in the zipfile documentation and adds a few relevant hyperlinks. ---------- assignee: docs@python components: Documentation files: doc_zipfile-3.3.patch keywords: patch messages: 171157 nosy: docs@python, storchaka priority: normal severity: normal status: open title: Minor corrections to the zipfile documentation versions: Python 2.7, Python 3.2, Python 3.3 Added file: http://bugs.python.org/file27277/doc_zipfile-3.3.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16025> _______________________________________

6 16

[issue11710] Landing pages in docs for standard library packages
by Nick Coghlan Oct. 6, 2012

Oct. 6, 2012

New submission from Nick Coghlan <ncoghlan(a)gmail.com>: http://docs.python.org/py3k/urllib errors out rather than returning an index page for the modules that are part of the urllib package. This index page could also link to the HOWTO at http://docs.python.org/py3k/howto/urllib2.html The following packages have the same problem: xml, http, xmlrpc, concurrent These ones look OK: logging, curses, html, tkinter These index pages don't necessarily need to be linked from the contents page, but they should exist so that manually typed URLs for these packages do something useful rather than erroring out with a 404. ---------- assignee: docs@python components: Documentation messages: 132481 nosy: docs@python, ncoghlan priority: normal severity: normal status: open title: Landing pages in docs for standard library packages versions: Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue11710> _______________________________________

6 9

Finally statement cannot access the exception information
by Joe Borġ Oct. 5, 2012

Oct. 5, 2012

As the docs say:* The exception information is not available to the program during execution of the finally<http://docs.python.org/reference/compound_stmts.html#finally>clause. * But why is this? Is it restricted by implementation? Regards, Joseph David Borġ http://www.jdborg.com

1 0

[issue16138] In the glossary there is a small typo about __len__() in the sequence definition
by py.user Oct. 5, 2012

Oct. 5, 2012

New submission from py.user: http://docs.python.org/py3k/glossary.html#term-sequence "and defines a len() method that returns the length of the sequence" change to "and defines a __len__() special method that returns the length of the sequence" ---------- assignee: docs@python components: Documentation messages: 172013 nosy: docs@python, py.user priority: normal severity: normal status: open title: In the glossary there is a small typo about __len__() in the sequence definition versions: Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16138> _______________________________________

3 2

[issue16127] Correct mentions of narrow build in documentation and comments
by Serhiy Storchaka Oct. 5, 2012

Oct. 5, 2012

New submission from Serhiy Storchaka: In some places in the documentation and in the comments still left incorrect mention of the narrow build. Suggested patch fixes this. ---------- assignee: docs@python components: Documentation, Unicode files: doc_narrow_build.patch keywords: patch messages: 171924 nosy: docs@python, ezio.melotti, storchaka priority: normal severity: normal status: open title: Correct mentions of narrow build in documentation and comments type: enhancement versions: Python 3.3, Python 3.4 Added file: http://bugs.python.org/file27410/doc_narrow_build.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue16127> _______________________________________

3 2