clarify some wording based on feedback from Marcus Smith; note resolution of Fedora issue

This commit is contained in:
Richard Jones 2013-06-14 11:15:22 +10:00
parent 6fb6ffac74
commit cef78b42ae
1 changed files with 26 additions and 21 deletions

View File

@ -63,14 +63,15 @@ The pip bootstrap
-----------------
The Python installation includes an executable called "pip3" (see PEP 394 for
naming rationale etc.) that attempts to import pip machinery. If it can
then the pip command proceeds as normal. If it cannot it will bootstrap pip by
downloading the pip implementation wheel file. Once installed, the pip command
proceeds as normal.
naming rationale etc.) that attempts to import pip machinery. If it can then
the pip command proceeds as normal. If it cannot it will bootstrap pip by
downloading the pip implementation wheel file. Once installed, the pip
command proceeds as normal. Once the bootstrap process is complete the "pip3"
command is no longer the bootstrap but rather the full pip command.
A boostrap is used in the place of a the full pip code so that we
don't have to bundle pip and also the install tool is upgradeable
outside of the regular Python upgrade timeframe and processes.
A boostrap is used in the place of a the full pip code so that we don't have
to bundle pip and also pip is upgradeable outside of the regular Python
upgrade timeframe and processes.
To avoid issues with sudo we will have the bootstrap default to
installing the pip implementation to the per-user site-packages
@ -114,13 +115,12 @@ would use the "-i" (Base URL of Python Package Index) argument to the
it) and display further instructions for downloading and installing
the file manually.
Manual installation of the pip implementation will be supported
through the manual download of the wheel file and "pip3 install
<downloaded wheel file>".
This installation will not perform standard pip installation steps of
saving the file to a cache directory or updating any local database of
installed files.
Some users may have no Internet access suitable for fetching the pip
implementation file. Manual installation of the pip implementation will be
supported through the manual download of the wheel file and "pip3 install
<downloaded wheel file>". This installation - since it uses only the bootstrap
code - will not perform standard pip installation steps of saving the file to
a cache directory or updating any local database of installed files.
The download of the pip implementation install file should be performed
securely. The transport from pypi.python.org will be done over HTTPS but the CA
@ -195,16 +195,16 @@ issue tracker [2]_
Risks
=====
The Fedora variant of Linux has had a separate program called "pip" (a
Perl package installer) available for install for some time. The
current Python "pip" program is installed as "pip-python". It is
hoped that the Fedora community will resolve this issue by renaming
the Perl installer.
The key that is used to sign the pip implementation download might be
compromised and this PEP currently proposes no mechanism for key
revocation.
There is a Perl package installer also named "pip". It is quite rare and not
commonly used. The Fedora variant of Linux has historically named Python's
"pip" as "python-pip" and Perl's "pip" as "perl-pip". This policy has been
altered[3] so that future Fedora installations will use the name "pip" for
Python's "pip". Existing installations will still have the old name for the
Python "pip", though the potential for confusion is now much reduced.
References
@ -216,6 +216,9 @@ References
.. [2] pip issue tracking work needed for this PEP
https://github.com/pypa/pip/issues/863
.. [3] Fedora's python-pip package does not provide /usr/bin/pip
https://bugzilla.redhat.com/show_bug.cgi?id=958377
Acknowledgments
===============
@ -223,7 +226,9 @@ Acknowledgments
Nick Coghlan for his thoughts on the proposal and dealing with the Red
Hat issue.
Jannis Leidel and Carl Meyer for their thoughts.
Jannis Leidel and Carl Meyer for their thoughts. Marcus Smith for feedback.
Marcela Mašláňová for resolving the Fedora issue.
Copyright