[issue13030] Be more generic when identifying the Windows main dir in installation doc

[Tim Golden]

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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13030] Be more generic when identifying the Windows main dir in installation doc

[Éric Araujo]

Éric Araujo  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13030] Be more generic when identifying the Windows main dir in installation doc

[Terry J. Reedy]

Terry J. Reedy  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13030] Be more generic when identifying the Windows main dir in installation doc

[Éric Araujo]

Éric Araujo  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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13030] Be more generic when identifying the Windows main dir in installation doc

[Terry J. Reedy]

Terry J. Reedy  added the comment:

Windows does not require that executables be on any particular 'drive'.

--
nosy: +terry.reedy

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue13030] Be more generic when identifying the Windows main dir in installation doc

[Sandro Tosi]

New submission from Sandro Tosi :

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 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com