Skip to content

Commit 23b9cb7

Browse files
authored
gh-143963: Update "Using Python on Windows" document
Add more solutions for troubleshooting.
1 parent e4c596d commit 23b9cb7

File tree

1 file changed

+15
-0
lines changed

1 file changed

+15
-0
lines changed

Doc/using/windows.rst

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -812,6 +812,11 @@ default).
812812
The operating system includes this entry once by default, after other
813813
user paths. If removed, shortcuts will not be found.
814814

815+
* -
816+
- If you are sure your :envvar:`PATH` variable works right, reopen the
817+
terminal you're using. Perhaps :envvar:`PATH` was modified when the terminal
818+
was still running, and the terminal has not got it updated.
819+
815820
* - ``py`` gives me a "command not found" error when I type it in my terminal.
816821
- Did you :ref:`install the Python install manager <pymanager>`?
817822

@@ -828,6 +833,11 @@ default).
828833
The operating system includes this entry once by default, after other
829834
user paths. If removed, shortcuts will not be found.
830835

836+
* -
837+
- If you are sure your :envvar:`PATH` variable works right, reopen the
838+
terminal you're using. Perhaps :envvar:`PATH` was modified when the terminal
839+
was still running, and the terminal has not got it updated.
840+
831841
* - ``py`` gives me a "can't open file" error when I type commands in my
832842
terminal.
833843
- This usually means you have the legacy launcher installed and
@@ -877,6 +887,11 @@ default).
877887
These scripts are separated for each runtime, and so you may need to
878888
add multiple paths.
879889

890+
* -
891+
- If you are sure your :envvar:`PATH` variable works right, reopen the
892+
terminal you're using. Perhaps :envvar:`PATH` was modified when the terminal
893+
was still running, and the terminal has not got it updated.
894+
880895
* - Typing ``script-name.py`` in the terminal opens in a new window.
881896
- This is a known limitation of the operating system. Either specify ``py``
882897
before the script name, create a batch file containing ``@py "%~dpn0.py" %*``

0 commit comments

Comments
 (0)