Mailman 3 May 2010 - docs

[issue8648] The UTF-7 codec functions are undocumented
by Daniel Stutzbach Dec. 26, 2010

Dec. 26, 2010

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: The UTF-7 codec functions are undocumented: PyUnicode_DecodeUTF7Stateful PyUnicode_DecodeUTF7 PyUnicode_EncodeUTF7 ---------- assignee: docs@python components: Documentation messages: 105207 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: The UTF-7 codec functions are undocumented versions: Python 2.6, Python 3.1 _______________________________________ Python … [View More]

4 4

[issue8851] pkgutil document needs more markups
by MATSUI Tetsushi Dec. 15, 2010

Dec. 15, 2010

New submission from MATSUI Tetsushi <mft(a)users.sourceforge.net>: The library reference of pkgutil is only sparsely marked up. The attached patch is against 2.6 version, because I'm currently working with 2.6. Since a part of markups (namely :pep:'s) has already been done for 3.2 version, the patch cannot be applied directly to that version, and I haven't checked the versions in between. ---------- assignee: docs@python components: Documentation files: pkgutil.diff keywords: patch … [View More]

2 3

[issue8647] PyUnicode_GetMax is undocumented
by Daniel Stutzbach Nov. 20, 2010

Nov. 20, 2010

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: Here's the relevant signature: /* Get the maximum ordinal for a Unicode character. */ PyAPI_FUNC(Py_UNICODE) PyUnicode_GetMax(void); ---------- assignee: docs@python components: Documentation messages: 105206 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: PyUnicode_GetMax is undocumented versions: Python 2.7, Python 3.2 … [View More]

5 6

[issue8645] PyUnicode_AsEncodedObject is undocumented
by Daniel Stutzbach Nov. 20, 2010

Nov. 20, 2010

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: PyUnicode_AsEncodedObject is undocumented. It has the same signature as PyUnicode_AsEncodedString, although they do slightly different things based on a brief source code inspection (I'm not clear on what that difference is though). ---------- assignee: docs@python components: Documentation messages: 105203 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: … [View More]

4 5

[issue8649] Py_UNICODE_* functions are undocumented
by Daniel Stutzbach Nov. 16, 2010

Nov. 16, 2010

New submission from Daniel Stutzbach <daniel(a)stutzbachenterprises.com>: Python provides several functions for manipulating raw Py_UNICODE strings, but they aren't documented. Below are their signatures. PyAPI_FUNC(size_t) Py_UNICODE_strlen(const Py_UNICODE *u); PyAPI_FUNC(Py_UNICODE*) Py_UNICODE_strcpy( Py_UNICODE *s1, const Py_UNICODE *s2); PyAPI_FUNC(Py_UNICODE*) Py_UNICODE_strncpy( Py_UNICODE *s1, const Py_UNICODE *s2, size_t n); PyAPI_FUNC(int) Py_UNICODE_strcmp( … [View More]

5 5

[issue8855] Shelve documentation lacks security warning
by Longpoke Oct. 17, 2010

Oct. 17, 2010

New submission from Longpoke <longpoke(a)gmail.com>: Loading a shelve can cause arbitrary code to be executed [1] and other black magic (because it's backed by Pickle). Shouldn't there be a big fat warning at the top of the shelve documentation page? Unless you're like me and assume anything to do with serialization in any language is insecure until proved otherwise, you aren't going to intuitively think there is anything wrong with "unshelving" untrusted data (unless you already know … [View More]

3 3

[issue8811] fixing sqlite3 docs for py3k
by Shashwat Anand Oct. 17, 2010

Oct. 17, 2010

New submission from Shashwat Anand <anand.shashwat(a)gmail.com>: The docs of sqlite3 for python 3.0 and 3.1 seems to be written for python 2.6 and hence wrong at many places. like, >>> for member in r: print member However the docs for sqlite3 in py3k trunk seems fine. The sqlite3 doc in py3k trunk should be used in these places. http://docs.python.org/release/3.0.1/library/sqlite3.html http://docs.python.org/release/3.1/library/sqlite3.html ---------- assignee: docs@… [View More]

3 6

[issue8686] "This isn't defined beyond that" phrase is not friendly to non-native English speakers.
by INADA Naoki Oct. 17, 2010

Oct. 17, 2010

New submission from INADA Naoki <songofacandy(a)gmail.com>: http://docs.python.org/library/difflib.html#difflib.SequenceMatcher.quick_r… > This isn’t defined beyond that it is an upper bound on ratio(), and is faster to compute. "beyond" is a bit confusing because it also means "over" and this sentence refers upper bound. I think "This isn't defined in detail more than..." is easier. ---------- assignee: docs@python components: Documentation messages: 105498 nosy: docs@python, … [View More]

7 8

[issue8556] Confusing string formatting examples
by Jeff McNeil Oct. 17, 2010

Oct. 17, 2010

New submission from Jeff McNeil <jeff(a)jmcneil.net>: I was going through the string formatting examples this evening and noticed this: print '%(language)s has %(#)03d quote types.' % \ {'language': "Python", "#": 2} The example uses a '#' as a map key. This is somewhat misleading as if we had simply left the parenthesis off, the '#' would have been interpreted as an alternate conversion flag. Should be updated to use a more verbose (and less confusing) dictionary key. -----… [View More]

4 5

[issue8834] Define order of Misc/ACKS entries
by Alexander Belopolsky Aug. 10, 2010

Aug. 10, 2010

New submission from Alexander Belopolsky <belopolsky(a)users.sourceforge.net>: This is a semi-serious feature request following a brief discussion on #python-dev IRC. Brett Cannon pointed out on python-checkins list [1] that the names should be alphabetized. However, given that the names are international, it is not obvious what it means. I propose to add a comment at the top of Misc/ACKS that the list is maintained in "rough alphabetical order" but not define it any further. [1] … [View More]

6 10