Skip to content

gh-124113: Clarify venv target directory reuse#151419

Merged
FFY00 merged 3 commits into
python:mainfrom
harjothkhara:codex/gh-124113-venv-docs
Jun 22, 2026
Merged

gh-124113: Clarify venv target directory reuse#151419
FFY00 merged 3 commits into
python:mainfrom
harjothkhara:codex/gh-124113-venv-docs

Conversation

@harjothkhara

@harjothkhara harjothkhara commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

Clarifies the venv docs for the case where the target directory already exists:

  • an existing directory is reused, not rejected;
  • reuse doesn't leave the directory untouched — venv may create, update, or replace files in it, so a dedicated directory is best;
  • --clear deletes all contents of the target directory (including files venv didn't create) before creating the environment.

Docs-only, no behavior change. Per the maintainer direction in gh-135604, the intended fix here is this clarification rather than a behavior change.

Disclosure: AI-assisted wording; I've reviewed it.

@read-the-docs-community

read-the-docs-community Bot commented Jun 12, 2026

Copy link
Copy Markdown

Documentation build overview

📚 cpython-previews | 🛠️ Build #33117766 | 📁 Comparing de5f11a against main (f4f1020)

  🔍 Preview build  

1 file changed
± library/venv.html

@harjothkhara harjothkhara marked this pull request as ready for review June 12, 2026 19:41
@FFY00 FFY00 merged commit 614e3ec into python:main Jun 22, 2026
36 checks passed
@github-project-automation github-project-automation Bot moved this from Todo to Done in Docs PRs Jun 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation in the Doc dir skip news

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

2 participants