[New-bugs-announce] [issue21034] Python docs reference the Distribute package which has been deprecated in favor of Setuptools

[Jurko Gospodnetić]

New submission from Jurko Gospodnetić:

In the Python documentation note:

  http://docs.python.org/3.4/library/venv.html#venv-def

the paragraph:

> Common installation tools such as Distribute and pip work
> as expected with venvs - i.e. when a venv is active, they
> install Python packages into the venv without needing to
> be told to do so explicitly. Of course, you need to
> install them into the venv first: this could be done by
> running distribute_setup.py with the venv activated,
> followed by running easy_install pip. Alternatively, you
> could download the source tarballs and run python setup.py
> install after unpacking, with the venv activated.

refers to the Distribute package and its specifics (how it
should be installed) but that package has been deprecated
in favor of the setuptools package. I suggest to change it
to something like:

> Common installation tools such as setuptools and pip work
> as expected with venvs - i.e. when a venv is active, they
> install Python packages into the venv without needing to
> be told to do so explicitly. Of course, you need to
> install them into the venv first: this could be done by
> running setuptools project's ez_setup.py with the venv
> activated, followed by running easy_install pip.
> Alternatively, you could download the source tarballs and
> run python setup.py install after unpacking, with the venv
> activated.

I'm attaching a patch based on the current tip in CPython's
development repository.

Hope this helps.

Best regards,
  Jurko Gospodnetić

----------
assignee: docs at python
components: Documentation
files: fix_Distribute_reference_in_venv_docs.patch
keywords: patch
messages: 214554
nosy: Jurko.Gospodnetić, docs at python
priority: normal
severity: normal
status: open
title: Python docs reference the Distribute package which has been deprecated in favor of Setuptools
versions: Python 3.4, Python 3.5
Added file: http://bugs.python.org/file34582/fix_Distribute_reference_in_venv_docs.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue21034>
_______________________________________