summaryrefslogtreecommitdiffstats
path: root/Doc/using
diff options
context:
space:
mode:
authorBrian Curtin <brian@python.org>2012-08-19 16:22:20 (GMT)
committerBrian Curtin <brian@python.org>2012-08-19 16:22:20 (GMT)
commita86f18537441c8828caa49cf60a8349acd05deac (patch)
treeaf549239073bc4d14a163db2bc8e4aad8ade6092 /Doc/using
parent47ec25d2f6d1b3aeb148bf6f88fee1c0b51dccdb (diff)
downloadcpython-a86f18537441c8828caa49cf60a8349acd05deac.zip
cpython-a86f18537441c8828caa49cf60a8349acd05deac.tar.gz
cpython-a86f18537441c8828caa49cf60a8349acd05deac.tar.bz2
Fixes #14668. Mention Windows Path manipulation option in the installer.
Diffstat (limited to 'Doc/using')
-rw-r--r--Doc/using/windows.rst30
1 files changed, 21 insertions, 9 deletions
diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
index 921335e..51152df 100644
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -82,6 +82,8 @@ In order to run Python flawlessly, you might have to change certain environment
settings in Windows.
+.. _setting-envvars:
+
Excursus: Setting environment variables
---------------------------------------
@@ -133,18 +135,28 @@ Consult :command:`set /?` for details on this behaviour.
Finding the Python executable
-----------------------------
+.. versionchanged:: 3.3
+
Besides using the automatically created start menu entry for the Python
-interpreter, you might want to start Python in the DOS prompt. To make this
-work, you need to set your :envvar:`%PATH%` environment variable to include the
-directory of your Python distribution, delimited by a semicolon from other
-entries. An example variable could look like this (assuming the first two
-entries are Windows' default)::
+interpreter, you might want to start Python in the command prompt. As of
+Python 3.3, the installer has an option to set that up for you.
+
+At the "Customize Python 3.3" screen, an option called
+"Add python.exe to search path" can be enabled to have the installer place
+your installation into the :envvar:`%PATH%`. This allows you to type
+:command:`python` to run the interpreter. Thus, you can also execute your
+scripts with command line options, see :ref:`using-on-cmdline` documentation.
+
+If you don't enable this option at install time, you can always re-run the
+installer to choose it.
- C:\WINDOWS\system32;C:\WINDOWS;C:\Python25
+The alternative is manually modifying the :envvar:`%PATH%` using the
+directions in :ref:`setting-envvars`. You need to set your :envvar:`%PATH%`
+environment variable to include the directory of your Python distribution,
+delimited by a semicolon from other entries. An example variable could look
+like this (assuming the first two entries are Windows' default)::
-Typing :command:`python` on your command prompt will now fire up the Python
-interpreter. Thus, you can also execute your scripts with command line options,
-see :ref:`using-on-cmdline` documentation.
+ C:\WINDOWS\system32;C:\WINDOWS;C:\Python33
Finding modules