Mailman 3 May 2010 - docs

[issue8707] Duplicated document in telnetlib.
by INADA Naoki 21 May '10

21 May '10

New submission from INADA Naoki <songofacandy(a)gmail.com>: http://docs.python.org/dev/library/telnetlib.html#telnetlib.Telnet The part "number can be passed to the constructor... " is duplicated. ---------- assignee: docs@python components: Documentation messages: 105667 nosy: docs@python, naoki priority: normal severity: normal status: open title: Duplicated document in telnetlib. versions: Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8707> _______________________________________

5 7

Python Documentation Typo
by Viktor Viktorov 21 May '10

21 May '10

Hello,There is a typo in the documentation at http://docs.python.org/py3k/library/urllib.request.html:>>> import urllib.request >>> f = urllib.request.urlopen('http://www.python.org/') >>> print(fp.read(100).decode('utf-8')) <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtm Should be>>> import urllib.request >>> f = urllib.request.urlopen('http://www.python.org/') >>> print(f.read(100).decode('utf-8')) ^^^ <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtm Cheers.

2 1

[issue8724] bind_and_activate parameter is missed from directive
by Georg Brandl 21 May '10

21 May '10

Georg Brandl <georg(a)python.org> added the comment: Thanks, fixed in r81419. ---------- nosy: +georg.brandl resolution: -> fixed status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8724> _______________________________________

1 0

Typo in urllib2
by INADA Naoki 21 May '10

21 May '10

I've found typo in urllib2. But bugs.python.org is down now. http://docs.python.org/dev/library/urllib2.html#urllib2.OpenerDirector.open -(if not specified, the global default timeout setting will be usedi). +(if not specified, the global default timeout setting will be used). # extra 'i' -- INADA Naoki <songofacandy(a)gmail.com>

2 1

Bad link in document
by Komorowski, George 21 May '10

21 May '10

The link to the Apple website is broken. The current PDF file at Apple website has 2009 in file name the Apple Publications Style Guide wherever Documenting Python Release 3.1.2 Georg Brandl March 20, 2010 [cid:image001.jpg@01CAF28D.27E6D430] George Komorowski IT Service Desk Iberdrola USA Management Corporation 400 West Ave, Rochester, NY 14611 800-646-3850 Service Desk 585-771-4374 Direct George.Komorowski(a)EnergyEast.com [cid:image002.jpg@01CAF28D.27E6D430] In the interest of the environment, please print only if necessary and recycle.

2 1

Python 2.6.5 threading.Event.wait()
by Andrew Trusty 21 May '10

21 May '10

Just spent a couple hours debugging some code because the threading.Event.wait() documentation said it returned the internal flag when it always returns None. I just noticed that there is an addendum that says this was behavior that was changed in 2.7 but since these are the 2.6.5 docs it would be a lot less confusing if it first said that it always returns None and then said that in 2.7 it will return the internal flag. http://docs.python.org/library/threading.html#threading.Event.wait Andrew

2 1

A documentation glitch
by Денис Горбачев 21 May '10

21 May '10

Page in question: http://docs.python.org/py3k/tutorial/datastructures.html#sets >>> fruit = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana'] >>> fruit = set(basket) # create a set without duplicates Should be >>> fruit = ['apple', 'orange', 'apple', 'pear', 'orange', 'banana'] >>> fruit = set(*fruit*) # create a set without duplicates as the intention is to show how to create a set without duplicates from a list. -- Денис Горбачев, Начальник отдела Web-разработок ЗАО <<ТруОфис>> http://www.trueoffice.ru/ +7 929 619-35-88

2 1

Typo in callable doc
by Éric Araujo 21 May '10

21 May '10

Hello Revision 77096 fixed a bug in Doc/library/2to3.rst by changing “hasattr(x, "__call_")” to “isinstance(x, collections.Callable)”. However, in the 2.6 documentation still visible at docs.python.org, the incorrect “__call_” is still present. Regards

2 1

[issue8694] python3 FAQ mentions unicode()
by Nathan Phillip Brink 21 May '10

21 May '10

New submission from Nathan Phillip Brink <ohnobinki(a)ohnopublishing.net>: http://docs.python.org/py3k/faq/programming.html#what-does-unicodeerror-asc… When I try to use unicode() from within python3, the call fails. I would actually expect that the FAQ should contain more information concerning the merging of the unicode and str classes. It would be nice if, when this FAQ entry is updated, there is a short discussion on making the code compatible with both python2 and python3, as it appears that's the only way python3 adaption will ever happen. ---------- assignee: docs@python components: Documentation messages: 105574 nosy: docs@python, ohnobinki priority: normal severity: normal status: open title: python3 FAQ mentions unicode() versions: Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8694> _______________________________________

4 3

[issue8783] The external link to a "Hash Collision FAQ" points to some company's homepage
by Daniel Stutzbach 21 May '10

21 May '10

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: At the bottom of the documentation for hashlib, there's a link to http://www.cryptography.com/cnews/hash.html which the hashlib documentation describes as "Hash Collision FAQ with information on which algorithms have known issues and what that means regarding their use." However, the page at that link is identical to http://www.cryptography.com/ which is just the homepage of some company that happens to deal with cryptography. If they do in fact host a Hash Collision FAQ, I couldn't find it. :-( Googling for "Hash Collision FAQ" (with quotes) mostly turns up references to the Python documentation, so I'm guessing the intended document no longer exists. The following wikipedia link might be an OK substitute, although it makes for pretty dense reading. http://en.wikipedia.org/wiki/Cryptographic_hash_function#Cryptographic_hash… ---------- assignee: docs@python components: Documentation messages: 106259 nosy: docs@python, stutzbach priority: normal severity: normal status: open title: The external link to a "Hash Collision FAQ" points to some company's homepage _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8783> _______________________________________

2 1