merge

pep-0439.txt

@@ -22,7 +22,7 @@ users.
 
 This PEP does not propose to include the pip implementation in the
 Python standard library.  Nor does it propose to implement any package
-management or installation mechanisms beyond those provided by PEPs
+management or installation mechanisms beyond those provided by PEP
 427 ("The Wheel Binary Package Format 1.0") and TODO distlib PEP.
 
 
@@ -62,11 +62,11 @@ publishing packages`_.
 The pip bootstrap
 -----------------
 
-The Python installation includes an executable called "pip" 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.
+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.
 
 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
@@ -84,9 +84,9 @@ The bootstrap process will proceed as follows:
 
 1. The user system has Python (3.4+) installed.  In the "scripts"
    directory of the Python installation there is the bootstrap script
-   called "pip".
-2. The user will invoke a pip command, typically "pip install
-   <package>", for example "pip install Django".
+   called "pip3".
+2. The user will invoke a pip command, typically "pip3 install
+   <package>", for example "pip3 install Django".
 3. The boostrap script will attempt to import the pip implementation.
    If this succeeds, the pip command is processed normally.
 4. On failing to import the pip implementation the bootstrap notifies
@@ -94,7 +94,7 @@ The bootstrap process will proceed as follows:
    latest download wheel file (see PEP 427.)
 5. Upon downloading the file it is installed using the distlib
    installation machinery for wheel packages.  Upon completing the
-   installation the user is notified that "pip has been upgraded."
+   installation the user is notified that "pip3 has been upgraded."
    TODO how is it verified?
 6. The pip tool may now import the pip implementation and continues to
    process the requested user command normally.
@@ -102,7 +102,7 @@ The bootstrap process will proceed as follows:
 Users may be running in an environment which cannot access the public
 Internet and are relying solely on a local package repository.  They
 would use the "-i" (Base URL of Python Package Index) argument to the
-"pip install" command.  This use case will be handled by:
+"pip3 install" command.  This use case will be handled by:
 
 1. Recognising the command-line arguments that specify alternative or
    additional locations to discover packages and attempting to
@@ -115,7 +115,7 @@ would use the "-i" (Base URL of Python Package Index) argument to the
    the file manually.
 
 Manual installation of the pip implementation will be supported
-through the manual download of the wheel file and "pip install
+through the manual download of the wheel file and "pip3 install
 <downloaded wheel file>".
 
 This installation will not perform standard pip installation steps of
@@ -130,10 +130,10 @@ risk we will use the embedded signature support in the wheel format to validate
 the downloaded file.
 
 Beyond those arguments controlling index location and download
-options, the "pip" boostrap command may support further standard pip
+options, the "pip3" boostrap command may support further standard pip
 options for verbosity, quietness and logging.
 
-The "--no-install" option to the "pip" command will not affect the
+The "--no-install" option to the "pip3" command will not affect the
 bootstrapping process.
 
 setuptools