[Python-checkins] cpython: Fixes #14668. Mention Windows Path manipulation option in the installer.

[brian.curtin]

http://hg.python.org/cpython/rev/b07a408b0291
changeset:   78653:b07a408b0291
user:        Brian Curtin <brian at python.org>
date:        Sun Aug 19 11:22:20 2012 -0500
summary:
  Fixes #14668. Mention Windows Path manipulation option in the installer.

files:
  Doc/using/windows.rst |  30 +++++++++++++++++++++---------
  1 files changed, 21 insertions(+), 9 deletions(-)


diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -82,6 +82,8 @@
 settings in Windows.
 
 
+.. _setting-envvars:
+
 Excursus: Setting environment variables
 ---------------------------------------
 
@@ -133,18 +135,28 @@
 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.
 
-    C:\WINDOWS\system32;C:\WINDOWS;C:\Python25
+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.
 
-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.
+If you don't enable this option at install time, you can always re-run the
+installer to choose it.
+
+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)::
+
+    C:\WINDOWS\system32;C:\WINDOWS;C:\Python33
 
 
 Finding modules

-- 
Repository URL: http://hg.python.org/cpython