Tarek Ziadé <ziade.tarek@gmail.com> added the comment: site definitely needs more documentation about the per-user site-packages. We need to add a section about that. I am adding Christian to the nosy list, since he added those feature. I can work on a section sometimes next week and propose a patch here btw. ---------- nosy: +christian.heimes _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8617> _______________________________________

Éric Araujo <merwok@netwok.org> added the comment: I have started to work on this; I’ll have one or two patches ready in a few weeks. ---------- assignee: docs@python -> eric.araujo versions: -Python 3.1 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8617> _______________________________________

Changes by Éric Araujo <merwok@netwok.org>: ---------- keywords: +needs review stage: needs patch -> patch review _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8617> _______________________________________

Roundup Robot <devnull@psf.upfronthosting.co.za> added the comment: New changeset b3f72b6450f1 by Éric Araujo in branch '2.7': Improve documentation for PEP 370 support in site module (#8617). http://hg.python.org/cpython/rev/b3f72b6450f1 ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8617> _______________________________________

Maxim Doucet <maxim.doucet@gmail.com> added the comment: Shouldn't there be an update of the 2.6 documentation too? After your patch, the 2.7 reflects the existence of the "--user" option (see http://docs.python.org/release/2.7.3/install/index.html#alternate-installati...) but not the 2.6 documentation (http://docs.python.org/release/2.6.8/install/index.html#alternate-installati...). In my personal experience, I used the "--home" option with python 2.6 to mimic what "--user" does and it took me 2 weeks to, by chance, stumble upon http://www.python.org/dev/peps/pep-0370/ which informed me that the "--user" option was originally available for python 2.6. If it had been on the 2.6 documentation, it would have been easier and more coherent IMHO. ---------- nosy: +maximd _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8617> _______________________________________

Éric Araujo <merwok@netwok.org> added the comment: BTW it appears that many people use the most recent 2.7 documentation even if they are using 2.6, because the doc is better and there are notes which tell you if something was changed or added in 2.7. For PEP 370 there are notes in the doc of the site module and the environment variables but I forgot to add one to the distutils doc; I will do that. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue8617> _______________________________________