[issue24124] Two versions of instructions for installing Python modules

[Irit Katriel]

Irit Katriel  added the comment:

The legacy doc has this message in it now, so I think we can close this issue 
and trust Steve to deal with it along with the rest of distutils.


   The entire ``distutils`` package has been deprecated and will be
   removed in Python 3.12. This documentation is retained as a
   reference only, and will be removed with the package. See the
   :ref:`What's New ` entry for more information.

--
nosy: +iritkatriel, steve.dower
resolution:  -> not a bug
stage:  -> resolved
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue24124] Two versions of instructions for installing Python modules

[Nick Coghlan]

Nick Coghlan added the comment:

As far as I'm aware, it's only confusing if you're poking around in the source 
tree, rather than using the built docs at docs.python.org (where the link to 
the legacy docs is now hidden away inside the distutils module docs).

The legacy docs remain in place to preserve existing deep links and because 
they're the only current documentation of various distutils details that are 
needed to *implement* tools like pip and setuptools.

In a more ideal world, we'd have a distutils expert with the time to go through 
the legacy docs, cull the outdated stuff, and lift the rest up into the 
distutils module documentation, but all the folks that might plausibly have the 
expertise to do that also have far more interesting things to do with their 
time :(

--

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24124
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue24124] Two versions of instructions for installing Python modules

[Ned Deily]

Changes by Ned Deily n...@acm.org:


--
nosy: +ncoghlan

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24124
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue24124] Two versions of instructions for installing Python modules

[Skip Montanaro]

New submission from Skip Montanaro:

I was hunting around the current website for notes on installing Python. 
Couldn't find any (BTW), so I looked in the Python source. Imagine my surprise 
to find two apparently overlapping files describing how to build Python modules:

./Doc/install/index.rst
./Doc/installing/index.rst

The former is marked Legacy version. The latter seems to cover mostly 
installation of third-party modules using tools like pip. The former covers 
distutils.  Oddly enough, the legacy version seems to have been updated more 
recently than the presumably current version. Do we really need to keep both 
versions around at this point? Should they be merged into a single document? If 
they are to both be retained, should the legacy version be marked as such more 
clearly and refer readers to the pip/pyvenv/virtualenv version?

--
assignee: docs@python
components: Documentation
messages: 242555
nosy: docs@python, skip.montanaro
priority: normal
severity: normal
status: open
title: Two versions of instructions for installing Python modules
versions: Python 3.5

___
Python tracker rep...@bugs.python.org
http://bugs.python.org/issue24124
___
___
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com