Mailman 3 June 2010 - docs

[issue9001] PyFile_FromFd wrong documentation
by Renato Cunha 15 Jun '10

15 Jun '10

New submission from Renato Cunha <renato(a)renatocunha.com>: PyFile_FromFd has a wrong argument cound and, consequently, a wrong description in py3k docs. The "errors" is never mentioned. ---------- assignee: docs@python components: Documentation files: correct-py3k-c-api-doc.diff keywords: patch messages: 107879 nosy: docs@python, trovao priority: normal severity: normal status: open title: PyFile_FromFd wrong documentation type: behavior versions: Python 3.2, Python 3.3 Added file: http://bugs.python.org/file17677/correct-py3k-c-api-doc.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9001> _______________________________________

2 1

[issue8865] select.poll is not thread safe
by Christian Schubert 15 Jun '10

15 Jun '10

New submission from Christian Schubert <bugs(a)apexo.de>: invoking select.poll.poll() concurrently from multiple threads frequently yields garbage in one thread: while poll_poll in thread 1 is parsing its result, another thread 2 calling poll may overwrite revents; assuming poll_result was 1 in thread 1 and thread 2 managed to clear all revents before thread 1 started scanning ufds, thread 1 would iterate straight through all ufds, past its bounds (no bound checks there), and return the first out-of-bounds entry that happens to have revents != 0 this issue needs at least documentation (although bounds-checking to prevent garbage in the result wouldn't hurt) also, since there doesn't seem to be any locking w/ regards to ufds, it might be possible to corrupt python's heap, by concurrently invoking poll_register and poll_poll. poll_register could move the ufds array to another location while resizing it and poll_poll would subsequently overwrite memory that is not allocated anymore or allocated by someone else (did not test that) python 2.5.5 ---------- assignee: docs@python components: Documentation, Library (Lib) messages: 106815 nosy: apexo, docs@python priority: normal severity: normal status: open title: select.poll is not thread safe type: behavior versions: Python 2.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8865> _______________________________________

2 5

[issue8993] Small typo in docs for PySys_SetArgv
by flashk 14 Jun '10

14 Jun '10

New submission from flashk <flashk(a)gmail.com>: The docs for PySys_SetArgv say: "This function works like PySys_SetArgv() with updatepath set to 1." I believe it should be "PySys_SetArgvEx". I've attached a patch. ---------- assignee: docs@python components: Documentation files: init.rst.patch keywords: patch messages: 107771 nosy: docs@python, flashk priority: normal severity: normal status: open title: Small typo in docs for PySys_SetArgv versions: Python 2.7 Added file: http://bugs.python.org/file17665/init.rst.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8993> _______________________________________

2 1

sqlite3 documentation
by Christopher Simmons 14 Jun '10

14 Jun '10

I think that documentation should say that sqlite3's Connection.close() is called when the connection falls out of scope, in the same way that Python closes files when they fall out of scope. I tested this behavior using the 'lsof' command to see whether or not connections were open.

1 0

[issue8925] Improve c-api/arg.rst: use "bytes" or "str" types instead of "string"
by STINNER Victor 13 Jun '10

13 Jun '10

New submission from STINNER Victor <victor.stinner(a)haypocalc.com>: http://docs.python.org/py3k/c-api/arg.html is unclear about what is a "string". Attached patch: - Use directly bytes, bytearray and str types - Replace "default encoding" by "``'utf-8'`` encoding" - Add bytes and/or bytearray to "... buffer compatible object" because it's not easy to understand what is a buffer compatible object, especially because there are different kind of buffer objects: read-only, read-write, pinned, etc. - Fix reST syntax ("..note ::") - Fix "es", "es#", "et" and "et#" formats: they doesn't accept "character buffer compatible object" (can someone double check that?) Py_BuildValue(): I choosed to mark U and U# formats as deprecated alias to s/s# => see issue #8848. I wrote the patch by reading getargs.c. ---------- assignee: docs@python components: Documentation, Unicode files: arg.patch keywords: patch messages: 107209 nosy: docs@python, haypo priority: normal severity: normal status: open title: Improve c-api/arg.rst: use "bytes" or "str" types instead of "string" versions: Python 3.2 Added file: http://bugs.python.org/file17576/arg.patch _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8925> _______________________________________

4 10

[issue8350] os.mkdir doc comment is incorrect
by Éric Araujo 13 Jun '10

13 Jun '10

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- assignee: georg.brandl -> docs@python nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8350> _______________________________________

1 0

A suggestion to change decimal module docstring
by Alexander Belopolsky 12 Jun '10

12 Jun '10

Not worth a tracker entry, so I am just sending this to docs and Mark. I find current "(for instance, in binary floating point, 1.00 % 0.1 gives 0.09999999999999995 instead of the expected Decimal("0.00") returned by decimal floating point)" in the introduction a bit unclear because neither Decimal class nor it's constructor taking a string has been introduced by that point. I think it is better to just use 0.00 for the "expected" value.

3 3

[issue459007] Document sys.path on Windows
by Éric Araujo 12 Jun '10

12 Jun '10

Changes by Éric Araujo <merwok(a)netwok.org>: ---------- assignee: georg.brandl -> docs@python nosy: +docs@python versions: +Python 3.2 -Python 3.0 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue459007> _______________________________________

1 0

[issue8904] quick example how to fix docs
by anatoly techtonik 12 Jun '10

12 Jun '10

New submission from anatoly techtonik <techtonik(a)gmail.com>: It would be helpful to have examples how to patch docs in some place like http://docs.python.org/bugs.html For example, in CHM version of 2.6.5 manual open() anchor points to reference/datamodel.html#index-844 and to tutorial/inputoutput.html#index-1080 but not to library/functions.html#open ---------- assignee: docs@python components: Documentation messages: 107127 nosy: docs@python, techtonik priority: normal severity: normal status: open title: quick example how to fix docs _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8904> _______________________________________

5 7

[issue8960] 2.6 README
by Vojtěch Rylko 12 Jun '10

12 Jun '10

New submission from Vojtěch Rylko <vojta.rylko(a)seznam.cz>: In 2.6 README are this paragraphs from 2.5 README: A number of features are not supported in Python 2.5 anymore. Some support code is still present, but will be removed in Python 2.6. The following systems are still supported in Python 2.5, but support will be dropped in 2.6: - Systems using --with-wctype-functions - Win9x, WinME Following Microsoft's closing of Extended Support for Windows 98/ME (July 11, 2006), Python 2.6 will stop supporting these platforms. ---------- assignee: docs@python components: Documentation messages: 107458 nosy: docs@python, vojta.rylko priority: normal severity: normal status: open title: 2.6 README versions: Python 2.6 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8960> _______________________________________

2 1