https://github.com/python/cpython/commit/dd670fa7ca1db79d6daaac807ac924aa547257d0
commit: dd670fa7ca1db79d6daaac807ac924aa547257d0
branch: main
author: Steve Dower <steve.do...@python.org>
committer: zooba <steve.do...@microsoft.com>
date: 2025-05-08T19:30:01+01:00
summary:
Adds docs to help with troubleshooting pip installs. (GH-133692)
files:
M Doc/using/windows.rst
diff --git a/Doc/using/windows.rst b/Doc/using/windows.rst
index 74d6db5d7d1a98..c084392ca66d55 100644
--- a/Doc/using/windows.rst
+++ b/Doc/using/windows.rst
@@ -95,6 +95,9 @@ as ``python3.14.exe``) to be available. The directory will be
administrator. Click Start and search for "Edit environment variables for your
account" for the system settings page to add the path.
+Each Python runtime you install will have its own directory for scripts. These
+also need to be added to :envvar:`PATH` if you want to use them.
+
The Python install manager will be automatically updated to new releases. This
does not affect any installs of Python runtimes. Uninstalling the Python
install
manager does not uninstall any Python runtimes.
@@ -713,6 +716,16 @@ default).
your ``pythonw.exe`` and ``pyw.exe`` aliases are consistent with your
others.
"
+ "``pip`` gives me a ""command not found"" error when I type it in my
+ terminal.","Have you activated a virtual environment? Run the
+ ``.venv\Scripts\activate`` script in your terminal to activate.
+ "
+ "","The package may be available but missing the generated executable.
+ We recommend using the ``python -m pip`` command instead, or alternatively
+ the ``python -m pip install --force pip`` command will recreate the
+ executables and show you the path to add to :envvar:`PATH`. These scripts
are
+ separated for each runtime, and so you may need to add multiple paths.
+ "
.. _windows-embeddable:
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3/lists/python-checkins.python.org/
Member address: arch...@mail-archive.com
