Mailman 3 June 2010 - docs

[issue8939] Use C type names (PyUnicode etc; ) in the C API docs
by STINNER Victor 19 Jun '10

19 Jun '10

STINNER Victor <victor.stinner(a)haypocalc.com> added the comment: r82084 (in 3.2 and r82085 in 3.1) fixes some of the reported issues. ---------- _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8939> _______________________________________

1 0

[issue9024] PyDateTime_IMPORT macro incorrectly marked up
by Tim Golden 18 Jun '10

18 Jun '10

Changes by Tim Golden <mail(a)timgolden.me.uk>: ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python stage: -> patch review versions: +Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9024> _______________________________________

1 0

[issue8937] SimpleHTTPServer should contain usage example
by anatoly techtonik 18 Jun '10

18 Jun '10

New submission from anatoly techtonik <techtonik(a)gmail.com>: Currently SimpleHTTPServer docs contains phrase "For example usage, see the implementation of the test() function." with no reference where this test() function is located. This is not user friendly. ---------- assignee: docs@python components: Documentation messages: 107304 nosy: docs@python, techtonik priority: normal severity: normal status: open title: SimpleHTTPServer should contain usage example versions: Python 2.6, Python 2.7 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue8937> _______________________________________

2 6

[issue3874] documentation bug: HTMLParser needs to document unknown_decl
by Fred L. Drake, Jr. 18 Jun '10

18 Jun '10

Changes by Fred L. Drake, Jr. <fdrake(a)acm.org>: ---------- versions: +Python 3.1, Python 3.2 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue3874> _______________________________________

1 0

[issue3874] documentation bug: HTMLParser needs to document unknown_decl
by Terry J. Reedy 18 Jun '10

18 Jun '10

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: Documentation issues should be component: documentation rather than library. When submitting one, please at least indicate the module or class concerned. I have never heard of 'unknown_decl' function. Preferably, indicate the specific section you want modified, by version, number and name. Best is to submit a suggested text to be inserted. You may know better than most issue reviewers what should be said. Someone else will add markup and possibly edit. If you respond, this will be reopened. Please indicate whether this issue applies to 3.x and add 3.1 and 3.2 if it does. ---------- assignee: -> docs@python components: +Documentation -Library (Lib) nosy: +docs@python, tjreedy status: open -> pending versions: +Python 2.6, Python 2.7 -Python 2.5 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue3874> _______________________________________

2 1

[issue4452] Incorrect docstring of os.setpgrp
by Senthil Kumaran 18 Jun '10

18 Jun '10

Senthil Kumaran <orsenthil(a)gmail.com> added the comment: The docstring "Make this process the process group leader" is proper for setpgrp. Fixed in r82047, r82048, r82049 and r82050. ---------- resolution: -> fixed stage: -> committed/rejected status: open -> closed _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue4452> _______________________________________

1 0

[issue4452] Incorrect docstring of os.setpgrp
by Senthil Kumaran 18 Jun '10

18 Jun '10

Senthil Kumaran <orsenthil(a)gmail.com> added the comment: Yes, its valid doc change request. Thought it means the same, the minor docstring improvement can be done. ---------- nosy: +orsenthil _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue4452> _______________________________________

1 0

[issue459007] Document sys.path on Windows
by Tal Einat 17 Jun '10

17 Jun '10

Tal Einat <taleinat(a)users.sourceforge.net> added the comment: Wow, this has been on hold for ages! I know I could have used this information in the past, and several people have asked me about this. Perhaps there should be a place in the documentations which explains how sys.path is populated, with detailed explanations for different platforms? With some guidance as per the right place in the docs for this, I'll gladly work on this. Note that I'm not an expert on this issue, I just plan to gather information form several places and write up a single nice documentation page. ---------- nosy: +taleinat _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue459007> _______________________________________

1 0

[issue4452] Incorrect docstring of os.setpgrp
by Terry J. Reedy 17 Jun '10

17 Jun '10

Terry J. Reedy <tjreedy(a)udel.edu> added the comment: os.setpgrp is unix only, I am windows only ;-(. However, the 3.1 manual says "Call the system call setpgrp() or setpgrp(0, 0)() depending on which version is implemented (if any). " Given the name of the function and the above, I suspect the OP is correct. The change is small enough that I might not bother with 2.6 and 3.1. ---------- assignee: -> docs@python components: +Documentation nosy: +docs@python, tjreedy versions: +Python 2.7, Python 3.1, Python 3.2 -Python 2.4, Python 2.5, Python 3.0 _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue4452> _______________________________________

1 0

[issue9002] Add a pointer on where to find a better description of PyFile_FromFd arguments
by Renato Cunha 16 Jun '10

16 Jun '10

New submission from Renato Cunha <renato(a)renatocunha.com>: Even though the "File Objects" section in py3k documentation makes it clear that the functions there listed are just wrappers over the io module, it took me a bit to find which function PyFile_FromFd was wrapping. So, what about making it clear that PyFile_FromFd wraps io.open? The attached patch tries to do that. (It assumes that my previous patch, from issue #9001, will get accepted, as it builds on it.) ---------- assignee: docs@python components: Documentation files: py3k-pyfile-from-fd-io-module.diff keywords: patch messages: 107881 nosy: docs@python, trovao priority: normal severity: normal status: open title: Add a pointer on where to find a better description of PyFile_FromFd arguments type: feature request versions: Python 3.2, Python 3.3 Added file: http://bugs.python.org/file17678/py3k-pyfile-from-fd-io-module.diff _______________________________________ Python tracker <report(a)bugs.python.org> <http://bugs.python.org/issue9002> _______________________________________

3 2