[issue14770] Minor documentation fixes

2012-05-13 Thread Ezio Melotti
Ezio Melotti added the comment: I addressed Éric comments and committed the patch. -- resolution: -> fixed stage: patch review -> committed/rejected status: open -> closed ___ Python tracker _

[issue14770] Minor documentation fixes

2012-05-13 Thread Roundup Robot
Roundup Robot added the comment: New changeset bf3cb58dcfe7 by Ezio Melotti in branch '2.7': #14770: backport a couple of changes from 3.x. http://hg.python.org/cpython/rev/bf3cb58dcfe7 -- ___ Python tracker _

[issue14770] Minor documentation fixes

2012-05-13 Thread Roundup Robot
Roundup Robot added the comment: New changeset 9d2a1f35421d by Ezio Melotti in branch '2.7': #14770: improve the library FAQ. http://hg.python.org/cpython/rev/9d2a1f35421d New changeset 7a046f1ddd07 by Ezio Melotti in branch '3.2': #14770: improve the library FAQ. http://hg.python.org/cpython/r

[issue14770] Minor documentation fixes

2012-05-10 Thread Éric Araujo
Éric Araujo added the comment: A lot of good editions! +``$PATH``:: Would it be worth using :envvar:`PATH` here? Python-specific envvars (e.g. PYTHONPATH) are documented and can be linked to, maybe a small entry to explain common envvars like HOME and PATH would be a useful addition for n

[issue14770] Minor documentation fixes

2012-05-10 Thread Ezio Melotti
Ezio Melotti added the comment: Addressed 5) and 8). -- Added file: http://bugs.python.org/file25520/issue14770-2.diff ___ Python tracker ___ ___

[issue14770] Minor documentation fixes

2012-05-10 Thread Georg Brandl
Georg Brandl added the comment: Re 5: the sentence needs to be rephrased in any case, because it's ungrammatical Re 8: it's not text, it's code, so it needs to go in code markup -- nosy: +georg.brandl ___ Python tracker

[issue14770] Minor documentation fixes

2012-05-10 Thread Ezio Melotti
Ezio Melotti added the comment: Attached a patch that addresses these problems: 1) done; 2) done; 3) I think "naive" is correct here (i.e. a naive program won't take care of flushing); 4) I remove the list of modules and left the link to the wiki page; 5) In the rst source there's a note that

[issue14770] Minor documentation fixes

2012-05-10 Thread Michael Foord
New submission from Michael Foord : A bunch of minor fixes for the documentation suggested by Kurt Robinson to the webmaster email address: Below, you will find 15 snippets from the Python 2.7.2 Library and Extension FAQ (http://docs.python.org/faq/library.html), categorized by problem type, a