Opened 16 years ago

Closed 16 years ago

Last modified 15 years ago

#5688 closed (duplicate)

missing word in Windows install instructions

Reported by: epnichols@… Owned by: anonymous
Component: Documentation Version: dev
Severity: Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: yes
Easy pickings: no UI/UX: no

Description

Item 4 of the following has a bug. the command to run is python setup.py install -- running "setup.py install" actually runs as a Windows shell script for a while and then gives an error message.


Installing an official release

  1. Download the latest release from our download page.
  2. Untar the downloaded file (e.g. tar xzvf Django-NNN.tar.gz, where NNN is the version number of the latest release). If you’re using Windows, you can download the command-line tool bsdtar to do this, or you can use a GUI-based tool such as 7-zip.
  3. Change into the directory created in step 2 (e.g. cd Django-NNN).
  4. If you’re using Linux, Mac OS X or some other flavor of Unix, enter the command sudo python setup.py install at the shell prompt. If you’re using Windows, start up a command shell with administrator privileges and run the command setup.py install.

Attachments (1)

5688.diff (639 bytes ) - added by Matt Boersma 16 years ago.
Corrects Windows install command

Download all attachments as: .zip

Change History (11)

by Matt Boersma, 16 years ago

Attachment: 5688.diff added

Corrects Windows install command

comment:1 by Matt Boersma, 16 years ago

Has patch: set
Owner: changed from nobody to Matt Boersma
Status: newassigned
Triage Stage: UnreviewedReady for checkin
Version: 0.96SVN

Good catch--"setup.py install" won't work on Windows without prefixing it with "python". One-word patch is attached for SVN, since we don't fix old docs.

in reply to:  1 ; comment:2 by Nick Efford, 16 years ago

Replying to mboersma:

Good catch--"setup.py install" won't work on Windows without prefixing it with "python". One-word patch is attached for SVN, since we don't fix old docs.

Hang on, are you sure about this?

On my Windows installation of Python, the install directory isn't added to your path but an association is made between .py files and the Python executable. Hence typing python followed by anything won't normally work, but running foo.py by typing its name should do the right thing.

in reply to:  2 comment:3 by anonymous, 16 years ago

Hang on, are you sure about this?

On my Windows installation of Python, the install directory isn't added to your path but an association is made between .py files and the Python executable. Hence typing python followed by anything won't normally work, but running foo.py by typing its name should do the right thing.

In the "old days", command-line behavior was different between 95-based Windows and NT-based Windows; 95 wouldn't let you do "somescript.py" on the command-line but NT would (and were this really got interesting was piping stdin/stdout.)

I'm not sure what the default behavior after a Windows Python install is these days, but I much prefer adding bin to my path and doing "python somescript.py" to keep things consistent (with my other junk done on OS X.)

comment:4 by Malcolm Tredinnick, 16 years ago

Patch needs improvement: set
Triage Stage: Ready for checkinAccepted

So there seems to be some disagreement as to whether this is necessary or not.

What is the standard behaviour if you install Python using python.org's installer on a recent version of Windows (say vista and/or the version before that)? I'm not interested in how it is possible to customise things. What happens in the absolutely standard case? If somebody has to read those commands and follow them word for word, then they aren't going to be able to puzzle out the subtleties of what used to happen versus now. So we have to be very clear. If things changed at some point in Windows and we know when, we can note that, too.

At the moment, I'm not comfortable making this change because it may or may not make things worse. So can somebody with access to Windows please confirm what the normal behaviour would be. Do you need to type "python" or does it make things worse?

comment:5 by Eric Nichols <epnichols@…>, 16 years ago

I was running Windows XP, without customizing anything. If I type the name of a python file, *.py, windows tried to run it as a windows shell script, not as a python script. So, in this case, it starts to run because some commands in the file look like valid shell commands, but then I get a weird error message somewhere in the file. In my standard setup, typing python first is necessary.

This happens a few times in the installation instructions; this was just the first place I noticed it. The instructions switch back and forth a bit between including vs. not including "python".

comment:6 by Matt Boersma, 16 years ago

Owner: changed from Matt Boersma to anonymous
Status: assignednew

For me on Windows XP with Python 2.5.1, typing the name of a python file at the command prompt doesn't do anything. I always must prefix it with "python." YMMV,

comment:7 by James Bennett, 16 years ago

Resolution: duplicate
Status: newclosed

I'm going to dupe this for #4878, which aims to generally improve the docs for installing on Windows.

comment:8 by thor574, 15 years ago

I see this has not been fixed in the documentation still, it is really fast to fix, just add word "python" in front of "python.py install".

comment:9 by thor574, 15 years ago

Correction:
I see this has not been fixed in the documentation still, it is really fast to fix, just add word "path-to-python-dir/python" in front of "python.py install".
(I use Vista)

comment:10 by thor574, 15 years ago

It is now hard to admit it also works without what I just said. It works even better (clean display output). I would delete my two comments if I could.

Note: See TracTickets for help on using tickets.
Back to Top