Mailman 3 July 2010 - docs

[issue1349732] urllib.urlencode provides two features in one param
by Senthil Kumaran July 14, 2010

July 14, 2010

Senthil Kumaran <orsenthil(a)gmail.com> added the comment: This was fixed as part of Issue8788. Closing this. ---------- resolution: -> duplicate stage: unit test needed -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1349732> _______________________________________

1 0

Python documentation in ePub?
by Martin Oestergaard July 14, 2010

July 14, 2010

I was wondering how easy it would be for you to release the Python documentation in the ePub format (for use on e-reader devices)? -- Sincerely, Martin Østergaard

2 1

[issue9258] Typos in docs for methods kqueue and kevent of module 'select'
by Retro July 14, 2010

July 14, 2010

New submission from Retro <vinetouu(a)gmail.com>: Fix the docs for every selected Python version. They all have the same typos. The typos appear in the documentation of the 'select' module. These are the methods that need typo fixes: select.kqueue() (Only supported on BSD.) Returns a kernel queue object object ... [remove one of the words 'object' here because they are unnecessarily repeated] select.kevent(ident, filter=KQ_FILTER_READ, flags=KQ_EV_ADD, fflags=0, data=0, udata=0) (Only supported on BSD.) Returns a kernel event object object; see section Kevent Objects below for the methods supported by kqueue objects. [again, remove one of the words 'object' here because they are unnecessarily repeated; also, fix the word 'kqueue' to 'kevent'] ---------- assignee: docs@python components: Documentation messages: 110255 nosy: Retro, docs@python, georg.brandl priority: normal severity: normal status: open title: Typos in docs for methods kqueue and kevent of module 'select' versions: Python 2.6, Python 2.7, Python 3.1, Python 3.2, Python 3.3 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9258> _______________________________________

3 3

Documentation for math.atan2() can be improved.
by Niraj Dudani July 14, 2010

July 14, 2010

Hullo, The documentation for math.atan2( y, x ) says: --------8<-------- The point of atan2() is that the signs of both inputs are known to it, so it can compute the correct quadrant for the angle. --------8<-------- This is correct, but incomplete. Another big advantage of using atan2() is that it works perfectly in the regime where x, the denominator, is close to, or equal to zero. While atan() will fail for x == 0, and may give inaccurate answers for x~= 0, atan2() should work fine. Thanks, Niraj

1 0

[issue9254] __import__ docstring should recommend importlib.import_module()
by Éric Araujo July 13, 2010

July 13, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: More rationale for not using a dummy fromlist, from Brett Cannon: “Pulling from sys.modules is the correct way to do this. There are subtle issues when using a bunk fromlist argument (empty modules, double initialization, etc.). If one does not use importlib.import_module -- written *specifically* to prevent people from doing the nasty hack with the fromlist -- then you should use the sys.modules approach, period” ---------- nosy: +merwok _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9254> _______________________________________

1 0

[issue9254] __import__ docstring should recommend importlib.import_module()
by Alexander Belopolsky July 13, 2010

July 13, 2010

Changes by Alexander Belopolsky <belopolsky(a)users.sourceforge.net>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: -> needs patch type: -> feature request _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9254> _______________________________________

1 0

Broken Links
by Charles Taylor July 13, 2010

July 13, 2010

Hi there, I attempted to download the Python documentation just now, but got a 404 not found error. I tried all of the options. Cheers, C./ -- 416-835-0314 www.CharlesAngusTaylor.com

1 0

[issue4968] Clarify inspect.is<callable> method docs
by Terry J. Reedy July 12, 2010

July 12, 2010

Changes by Terry J. Reedy <tjreedy(a)udel.edu>: ---------- versions: +Python 3.2 -Python 3.0 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue4968> _______________________________________

1 0

[issue2864] etree: Add XPath documentation
by Ezio Melotti July 11, 2010

July 11, 2010

Changes by Ezio Melotti <ezio.melotti(a)gmail.com>: ---------- nosy: +docs@python stage: -> needs patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue2864> _______________________________________

1 0

[issue7674] select.select() corner cases: duplicate fds, out-of-range fds
by Antoine Pitrou July 11, 2010

July 11, 2010

Changes by Antoine Pitrou <pitrou(a)free.fr>: ---------- assignee: docs@python -> components: -Documentation nosy: +exarkun versions: +Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue7674> _______________________________________

1 0