[issue4488] Python Documentation not Newb Friendly

2008-12-06 Thread Georg Brandl
Georg Brandl <[EMAIL PROTECTED]> added the comment: You are quite right. I've given PIPE and STDOUT their own entries now in r67608. -- status: pending -> closed ___ Python tracker <[EMAIL PROTECTED]> ___

[issue4488] Python Documentation not Newb Friendly

2008-12-05 Thread Terry J. Reedy
Terry J. Reedy <[EMAIL PROTECTED]> added the comment: Yes, the new docs are much better. Methods are nicely identified in 2.6/3.0 docs that I checked. There is one category that is not: constants. For instance, the following is from the subprocess doc. "stdin, stdout and stderr specify the ex

[issue4488] Python Documentation not Newb Friendly

2008-12-02 Thread Georg Brandl
Georg Brandl <[EMAIL PROTECTED]> added the comment: Like Amaury said, I think this is fixed. -- resolution: -> fixed status: open -> pending ___ Python tracker <[EMAIL PROTECTED]> ___

[issue4488] Python Documentation not Newb Friendly

2008-12-02 Thread Amaury Forgeot d'Arc
Amaury Forgeot d'Arc <[EMAIL PROTECTED]> added the comment: Did you see that the current (=2.6) documentation has changed a lot? For example: http://docs.python.org/library/os.path.html#os.path.splitext It seems that most of your concerns have been addressed. (also, see the nice URL) I suggest

[issue4488] Python Documentation not Newb Friendly

2008-12-02 Thread Martin Meredith
Martin Meredith <[EMAIL PROTECTED]> added the comment: Well, I can't offer a patch (as I said - I'm a python n00b) - but I can offer suggestions. 1) show the functions as where they are - for example - splitext would be shown as os.path.splitext(arguments) 2) header titles for groups within the

[issue4488] Python Documentation not Newb Friendly

2008-12-02 Thread Tim Golden
Tim Golden <[EMAIL PROTECTED]> added the comment: What would be helpful would be a specific suggestion from the OP (or, better still, a doc patch) as to exactly what should change or at least what kind of words should go where. As it stands, this report highlights a real but quite general issu

[issue4488] Python Documentation not Newb Friendly

2008-12-02 Thread Martin Meredith
New submission from Martin Meredith <[EMAIL PROTECTED]>: I'm a new python user (developing in python) and I recently had a discussion with someone that my main issue with python is finding where the functions are that I need to use. An example (probably not the best) - I need to split a filename