This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ncoghlan
Recipients docs@python, dstufft, eric.araujo, ncoghlan, pitrou
Date 2014-10-23.22:10:13
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1414102214.35.0.622633237328.issue22711@psf.upfronthosting.co.za>
In-reply-to
Content
No, I won't stop closing this issue, because reverting to advertising the legacy installation and distribution docs through a top level docs home page link is *never going to happen* (although I'll note again that direct links into the legacy docs have been explicitly preserved).

If you have concerns that the API reference docs for distutils and setuptools are too hard to locate from packaging.python.org, then the appropriate place to file an issue is at https://github.com/pypa/python-packaging-user-guide/issues

If you have concerns with the setuptools docs, then the place to file issues is https://bitbucket.org/pypa/setuptools/issues. pip injects setuptools into all of its setup.py invocations in order to ensure modern metadata is generated, even on older versions of Python. This is one of the reasons the legacy docs are thoroughly misleading - vanilla distutils will be used only if you run setup.py directly (without pip), and the script itself imports distutils rather than setuptools. If you *do* run setup.py that way, then many now expected features of the Python packaging ecosystem like API entry point declarations, command line wrapper generation and packaging dependency declarations won't be available, as they're setuptools features, rather than distutils ones.

If you'd like more detail on all the things that are sufficiently outdated in the legacy distribution and installation docs to make them actively misleading, then the place to ask for that information is the distutils-sig mailing list, not the CPython issue tracker.
History
Date User Action Args
2014-10-23 22:10:14ncoghlansetrecipients: + ncoghlan, pitrou, eric.araujo, docs@python, dstufft
2014-10-23 22:10:14ncoghlansetmessageid: <1414102214.35.0.622633237328.issue22711@psf.upfronthosting.co.za>
2014-10-23 22:10:14ncoghlanlinkissue22711 messages
2014-10-23 22:10:13ncoghlancreate