Mailman 3 July 2010 - docs

[issue8472] itertools.filterfalse() function missing
by Éric Araujo July 4, 2010

July 4, 2010

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

1 0

[issue8910] Write a text file explaining why Lib/test/data exists
by Éric Araujo July 4, 2010

July 4, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: Benjamin, is it too late? ---------- nosy: +benjamin.peterson versions: +Python 2.6, Python 2.7, Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8910> _______________________________________

1 0

Documenting that dis is an implementation detail
by Éric Araujo July 4, 2010

July 4, 2010

Hello documenters >From a python-dev thread: Martin v. Löwis: > The dis module is deliberately (*) not part of the Python language and > standard library; it's an implementation detail (as is the func_code > attribute, and the code object). [...] > > (*) Unfortunately, the documentation fails to mention that, probably > because it's too obvious. Maciej Fijalkowski > Even more, Jython and IronPython don't have Python bytecode at all and > they're considered python implementations. The dis documentation should mention that it’s not authoritative for Python, just a tool for CPython. I may be able to propose a patch this week-end. Do we need to open a bug report to track other mentions of bytecode that fail to mention it’s an implementation detail? Regards

1 1

Interested in Contributing
by Steven McGrew July 4, 2010

July 4, 2010

In the interest of making myself useful this summer, I would like to contribute to the Python documentation. Having used many obscure Python libraries in my projects, I have noticed a distinct lack of good documentation and code examples for some modules (especially some of the XML parsers out there), and I want to make using Python easier for other people. I have not written documentation before, but I am willing to learn ReStructuredText and I consider myself to be a competent programmer. If you have any suggestions for how I could get started or could point me in the write direction of the python doc community, I would greatly appreciate it. -Steven McGrew

2 1

spelling typo in 2to3 module description
by Richard Mathar July 4, 2010

July 4, 2010

In http://docs.python.org/library/2to3.html#2to3fixer-long the name of the fixer "raises" should be "raise" , singular of the word. -- Richard J. Mathar cell phone (+49) (0) 177 3834227 (E-plus) Sterrewacht Universiteit Leiden Fax (+31) (0) 71 527 5819 Postbus 9513 2300RA Leiden E-mail mathar(a)strw.leidenuniv.nl r.j.mathar(a)umail.leidenuniv.nl The Netherlands URL http://www.strw.leidenuniv.nl/~mathar office: Niels Bohrweg 2, 2333 CA Leiden, H104

2 2

[issue1576313] os.execvp[e] on win32 fails for current directory
by R. David Murray July 3, 2010

July 3, 2010

R. David Murray <rdmurray(a)bitdance.com> added the comment: The unix model should be followed (requiring an explicit reference to the current directory if it is not already in PATH), rather than the insecure Windows behavior, and this is indeed the current situation. The current behavior is documented ("a full or relative path"), but a footnote that this differs from the msvcrt behavior would probably be a useful addition. So I'm changing this to a doc bug. (I have verified that ./ works, I have not verified the msvcrt behavior.) ---------- assignee: -> docs@python components: +Documentation -Windows nosy: +r.david.murray stage: unit test needed -> needs patch type: feature request -> behavior versions: +Python 3.1 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1576313> _______________________________________

1 0

[issue1576313] os.execvp[e] on win32 fails for current directory
by anatoly techtonik July 3, 2010

July 3, 2010

anatoly techtonik <techtonik(a)gmail.com> added the comment: There should be one uniform behavior on all platforms if Python is crossplatoform. As far as I can understand this issue - unix os.execv() requires "./" to be present to execute anything from current directory. On windows it is enough to specify just filename, but os.execv() doesn't work in this way - is that right and the issue is to make behavior of os.execv() like on windows? The current behavior definitely needs to be documented. ---------- nosy: +docs@python, techtonik versions: +Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue1576313> _______________________________________

1 0

[issue459007] Document sys.path on Windows
by Catalin Iacob July 2, 2010

July 2, 2010

Changes by Catalin Iacob <iacobcatalin(a)gmail.com>: ---------- nosy: +catalin _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue459007> _______________________________________

1 0

[issue8939] Use C type names (PyUnicode etc; ) in the C API docs
by Éric Araujo July 1, 2010

July 1, 2010

Éric Araujo <merwok(a)netwok.org> added the comment: To avoid the strange-looking “a PyUnicodeObject object”, one can write “an instance of PyUnicodeObject”. Victor, have you kept the ```` around 0 and 1? ---------- resolution: -> accepted stage: -> patch review _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8939> _______________________________________

2 1

[issue8939] Use C type names (PyUnicode etc; ) in the C API docs
by Daniel Stutzbach July 1, 2010

July 1, 2010

Daniel Stutzbach <daniel(a)stutzbachenterprises.com> added the comment: +1 on using the full name, PyUnicodeObject The shorthand "PyUnicode" is too easy to confuse with Py_UNICODE (an actual type). ---------- nosy: +stutzbach _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8939> _______________________________________

1 0