[issue13030] Be more generic when identifying the Windows main dir in installation doc
New submission from Sandro Tosi <sandro.tosi@gmail.com>: Given I have no knowledge of the windows system, I'm just proxying http://mail.python.org/pipermail/docs/2011-September/005793.html :
Under: http://docs.python.org/install/index.html#inst-how-install-works
It notes "Windows prefix\Lib\site-packages C:\PythonXY\Lib\site-packages" for default values on Windows. In the paragraph following the table is the text: "prefix and exec-prefix stand for the directories that Python is installed to, and where it finds its libraries at run-time. They are always the same under Windows, and very often the same under Unix and Mac OS X. " I don't know if it's hardcoded into Python distributions to use C, but it's not correct. The correct way to identify what most people think of as C is via the %SYSTEMROOT% environment variable, so the path described would be "%SYSTEMROOT%\PythonXY\Lib\site-packages" (This is still not the correct way to do things on Windows, but it at least shouldn't break on systems with a %SYSTEMROOT% other than C. I've seen configurations like that on systems which boot multiple versions of Windows.) <<< ---------- assignee: docs@python components: Documentation messages: 144422 nosy: brian.curtin, docs@python, sandro.tosi, tim.golden priority: normal severity: normal stage: needs patch status: open title: Be more generic when identifying the Windows main dir in installation doc type: behavior versions: Python 2.7, Python 3.2, Python 3.3 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13030> _______________________________________
Terry J. Reedy <tjreedy@udel.edu> added the comment: Windows does not require that executables be on any particular 'drive'. ---------- nosy: +terry.reedy _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13030> _______________________________________
Éric Araujo <merwok@netwok.org> added the comment: Terry, are you saying that the report is not a bug or that some part of the message is valid and some other part not? I can’t see clearly what I should do. Sandro: You can nosy me to all bugs for distutils docs: Doc/distutils, Doc/install, Doc/packaging, Doc/library/packaging.* (and also related docs like site, using, sysconfig) ---------- nosy: +eric.araujo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13030> _______________________________________
Terry J. Reedy <tjreedy@udel.edu> added the comment: I said exactly what I said ;-). Upon looking further (following the links), I see that 'install' refers to the disutils setup program install command option. What you should do is make the doc accurate and clear. What 'accurate' means is for you to say, but not having used install, the doc is not too clear to me. The table headings 'Standard installation location' (of what?) and 'Default value' (for what program?) both seem a bit ambiguous, or rather they seem reversed to me. I would label the columns 'Default module directory' and 'Standard Python location'. That said, I hope that the actual default module installation directory for install is the actual site-packages directory on my machine, based on where I actually put python, and not the non-existent standard location, which I did not use but which is what the text seems to say (but which would be a behavior design bug to me). MARTIN: below is the question for you. The issue raised by the off-tracker OP, Michael Mol, is a different one about how the .msi installer works and whether this doc is correctly describing how it works. The question is whether the default python install directory built into pythonxy...msi is literally "C:\PythonXY\Lib\site-packages" or whether it is actually "%SYSTEMROOT%\PythonXY\Lib\site-packages". Mr. Mol claims that the latter, or something else (unspecified), is better. ---------- nosy: +loewis _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13030> _______________________________________
Éric Araujo <merwok@netwok.org> added the comment:
The table headings 'Standard installation location' (of what?) Of software projects using distutils.
and 'Default value' (for what program?) For a CPython without changes to the default build configuration.
both seem a bit ambiguous, or rather they seem reversed to me. I would label the columns 'Default module directory' and 'Standard Python location'. Well, no: the first column does not contain real paths, but templates with placeholders like prefix and X.Y. The second column gives the path with the placeholders replaced by their default value.
That said, I hope that the actual default module installation directory for install is the actual site-packages directory on my machine, based on where I actually put python, Yes.
and not the non-existent standard location, which I did not use but which is what the text seems to say (but which would be a behavior design bug to me). “Default” means “if you haven’t made any change to the build/install configuration of Python”.
Do these replies make sense? If so, I can rephrase them as a doc patch. ---------- _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13030> _______________________________________
Tim Golden added the comment: This is essentially superseded now by the work done over on distutils-sig and by the PyPA. (Which has included considering the differeng terminology of installation vs other paths on Windows vs Unix). ---------- resolution: -> wont fix stage: needs patch -> resolved status: open -> closed _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13030> _______________________________________
participants (4)
-
Sandro Tosi -
Terry J. Reedy
-
Tim Golden
-
Éric Araujo