Document the deprecation of pyvenv in favor of `python3 -m venv`

[stevepiercy]

BPO	27285
Nosy	@brettcannon, @ned-deily, @bitdancer, @berkerpeksag, @vadmium, @stevepiercy
Files	pyvenv-to-venv.patch: pyvenv-to-venv.patch pyvenv-to-venv.update-susp-ignored.csv.patch: Update tools/susp-ignored.csv to properly ignore updated docstring

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/brettcannon'
closed_at = <Date 2016-07-11.18:28:31.993>
created_at = <Date 2016-06-10.07:49:04.109>
labels = ['easy', 'type-feature', 'docs']
title = 'Document the deprecation of pyvenv in favor of `python3 -m venv`'
updated_at = <Date 2016-07-16.07:29:19.253>
user = 'https://github.com/stevepiercy'

bugs.python.org fields:

activity = <Date 2016-07-16.07:29:19.253>
actor = 'python-dev'
assignee = 'brett.cannon'
closed = True
closed_date = <Date 2016-07-11.18:28:31.993>
closer = 'ned.deily'
components = ['Documentation']
creation = <Date 2016-06-10.07:49:04.109>
creator = 'stevepiercy'
dependencies = []
files = ['43598', '43681']
hgrepos = ['346']
issue_num = 27285
keywords = ['patch', 'easy']
message_count = 23.0
messages = ['268104', '268105', '268106', '268124', '268133', '268134', '268135', '268136', '268981', '269005', '269466', '269495', '269649', '269678', '269997', '269998', '270004', '270144', '270156', '270195', '270196', '270257', '270545']
nosy_count = 8.0
nosy_names = ['brett.cannon', 'ned.deily', 'r.david.murray', 'docs@python', 'python-dev', 'berker.peksag', 'martin.panter', 'stevepiercy']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue27285'
versions = ['Python 3.6']

[stevepiercy]

Per https://bugs.python.org/issue25154 pyvenv is deprecated in favor of python3 -m venv. The docs for Python 3.5+ need to be updated accordingly.

[berkerpeksag]

It's actually deprecated in Python 3.6: https://docs.python.org/dev/whatsnew/3.6.html#deprecated-features

[stevepiercy]

I saw the patch in 3.6, yet the discussion in issue bpo-25154 called for deprecation in 3.5.1. Was deprecation of pyvenv supposed to be implemented in 3.5.1?

I couldn't find any other relevant discussion, so apologies for jumping in uninformed.

[brettcannon]

Basically I changed my mind about adding the code deprecation in 3.5.1 since it wasn't fair to people to run into that in a bugfix release. Documenting the deprecation, though, can happen in Python 3.5.1 as well as updating the documentation of the venv module to only use python3 -m venv which I missed the first time through.

[stevepiercy]

I forgot to include the specific URL to update:
https://docs.python.org/3/installing/

There may be other places.

[stevepiercy]

One more.
https://docs.python.org/3/library/venv.html

Should that be updated for 3.5.1 as well as 3.6?

[stevepiercy]

See also:
pypa/packaging.python.org#242

[brettcannon]

Documenting the deprecation in 3.5 is fine.