gh-151138: Correct documented tempfile Windows temp directory search order

[Diwak4r]

Problem

The tempfile.gettempdir() docs incorrectly document the Windows temp directory search order.

Current docs claim:

C:\TEMP, C:\TMP, \TEMP, \TMP

Actual implementation (Lib/tempfile.py lines 192-194):

for envname in 'TMPDIR', 'TEMP', 'TMP':
    dirname = os.getenv(envname)
    if dirname: return dirname

On Windows, TEMP and TMP env vars point to %USERPROFILE%\AppData\Local\Temp (user temp) and %SYSTEMROOT%\Temp (system temp), not the hardcoded paths the docs claim.

Fixes #151138.

Fix

Update Doc/library/tempfile.rst to document the correct search order:

{USERPROFILE}\AppData\Local\Temp
{SYSTEMROOT}\Temp
c:	emp, c:	mp, 	emp, 	mp

This reflects actual runtime behavior: environment variables first, then hardcoded fallback paths.

Test

Documentation-only change. Verified docs build with make html.

[python-cla-bot]

The following commit authors need to sign the Contributor License Agreement:

• diwak4r.comp@gmail.com

[chatgpt-codex-connector]

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

[Copilot]

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33866842 | 📁 Comparing 73d28d5 against main (534b6b0)

  🔍 Preview build  

1 file changed

± library/tempfile.html

[StanFromIreland]

You'll have to sign the CLA before we can review.