[Python-checkins] peps: clarify some wording based on feedback from Marcus Smith; note resolution of

[richard.jones]

http://hg.python.org/peps/rev/85b25c4fb26d
changeset:   4923:85b25c4fb26d
user:        Richard Jones <richard at mechanicalcat.net>
date:        Fri Jun 14 11:15:22 2013 +1000
summary:
  clarify some wording based on feedback from Marcus Smith; note resolution of Fedora issue

files:
  pep-0439.txt |  47 ++++++++++++++++++++++-----------------
  1 files changed, 26 insertions(+), 21 deletions(-)


diff --git a/pep-0439.txt b/pep-0439.txt
--- a/pep-0439.txt
+++ b/pep-0439.txt
@@ -63,14 +63,15 @@
 -----------------
 
 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 @@
    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 @@
 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 @@
 .. [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 @@
 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

-- 
Repository URL: http://hg.python.org/peps