Mailman 3 November 2010 - docs

[issue10446] pydoc3 links to 2.x library reference
by Alexander Belopolsky 17 Nov '10

17 Nov '10

Changes by Alexander Belopolsky <belopolsky(a)users.sourceforge.net>: ---------- nosy: +docs@python _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10446> _______________________________________

1 0

FAQs collection is duplicated
by Alexander Belopolsky 17 Nov '10

17 Nov '10

As far as I can tell, http://www.python.org/doc/faq/ (linked to from FAQs part on the main docs index) and http://www.python.org/doc/faq/ (linked to from the FAQs navigation sidebar entry) contain more or less the same material. Do we need both?

3 3

Beeping is not the a good way to check command line editing support
by Pavel Tankov 17 Nov '10

17 Nov '10

On page: http://docs.python.org/tutorial/interpreter.html there is this paragraph: The interpreter’s line-editing features usually aren’t very sophisticated. On Unix, whoever installed the interpreter may have enabled support for the GNU readline library, which adds more elaborate interactive editing and history features. Perhaps the quickest check to see whether command line editing is supported is typing Control-P to the first Python prompt you get. If it beeps, you have command line editing; see Appendix Interactive Input Editing and History Substitution for an introduction to the keys. If nothing appears to happen, or if ^P is echoed, command line editing isn’t available; you’ll only be able to use backspace to remove characters from the current line. The beeping is not very adequate way to judge whether one has command line editing supported, because most people disable the beep whatsoever on their Lunux installations (or turn the beep voume to zero). Since I am a beginner, I can't propose a replacement text for the documentation. HTH -- Pavel Tankov

1 0

sqlite3 Binary description is missing
by Wolfgang Kerzendorf 17 Nov '10

17 Nov '10

Dear Doc-Team, First of all for providing such a thorough and incredibly useful documentation. I have one minor suggestion: It would be useful to insert a section about inserting binary data into the sqlite database with sqlite3.Binary(). Cheers Wolfgang

1 0

"Data" used as singular
by Alexander Belopolsky 17 Nov '10

17 Nov '10

""" All data in a Python program is represented by objects or by relations between objects. """ http://docs.python.org/dev/reference/datamodel.html#objects-values-and-types s/is/are/

2 1

sys.maxunicode documentation is imprecise
by Alexander Belopolsky 16 Nov '10

16 Nov '10

""" sys.maxunicode An integer giving the largest supported code point for a Unicode character. The value of this depends on the configuration option that specifies whether Unicode characters are stored as UCS-2 or UCS-4. """ http://docs.python.org/dev/library/sys.html#sys.maxunicode The term "Unicode character" is imprecise. A better term is "Unicode code unit" as used in Data model/Sequences/Strings section. Also "sys.maxunicode" is not hyperlinked in Data model page. http://docs.python.org/dev/reference/datamodel.html#objects-values-and-types

1 0

[issue10318] "make altinstall" installs many files with incorrect shebangs
by Jesús Cea Avión 16 Nov '10

16 Nov '10

Changes by Jesús Cea Avión <jcea(a)jcea.es>: ---------- nosy: +jcea _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10318> _______________________________________

1 0

[issue10433] Document unique behavior of 'getgroups' on OSX
by R. David Murray 16 Nov '10

16 Nov '10

Changes by R. David Murray <rdmurray(a)bitdance.com>: ---------- nosy: +michael.foord _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue10433> _______________________________________

1 0

[issue9076] Add C-API documentation for PyUnicode_AsDecodedObject/Unicode and PyUnicode_AsEncodedObject/Unicode
by Georg Brandl 16 Nov '10

16 Nov '10

Georg Brandl <georg(a)python.org> added the comment: Documenting Unicode C APIs is now tracked in #10435. ---------- nosy: +georg.brandl resolution: -> out of date status: open -> closed superseder: -> Document unicode C-API in reST _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9076> _______________________________________

1 0

[issue8649] Py_UNICODE_* functions are undocumented
by Daniel Stutzbach 16 Nov '10

16 Nov '10

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( const Py_UNICODE *s1, const Py_UNICODE *s2); PyAPI_FUNC(Py_UNICODE*) Py_UNICODE_strchr( const Py_UNICODE *s, Py_UNICODE c ); ---------- assignee: docs@python components: Documentation messages: 105214 nosy: docs@python, stutzbach priority: normal severity: normal stage: needs patch status: open title: Py_UNICODE_* functions are undocumented versions: Python 2.7, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8649> _______________________________________

5 5