Fully switch from setup.py install to pip.

anntzer · anntzer · commit 4fe9110cc430 · 2017-10-06T00:05:11.000-07:00
diff --git a/INSTALL.rst b/INSTALL.rst
@@ -22,8 +22,8 @@ Installing an official release
 Matplotlib and most of its dependencies are all available as wheel
 packages for macOS, Windows and Linux distributions::
 
-  python -m pip install -U pip
-  python -m pip install -U matplotlib
+  python -mpip install -U pip
+  python -mpip install -U matplotlib
 
 .. note::
 
@@ -150,16 +150,14 @@ Python, NumPy, libpng and FreeType), you can build Matplotlib.
 ::
 
   cd matplotlib
-  python setup.py build
-  python setup.py install
+  python -mpip install .
 
-We provide a `setup.cfg
-<https://raw.githubusercontent.com/matplotlib/matplotlib/master/setup.cfg.template>`_
-file that goes with :file:`setup.py` which you can use to customize
-the build process. For example, which default backend to use, whether
-some of the optional libraries that Matplotlib ships with are
-installed, and so on.  This file will be particularly useful to those
-packaging Matplotlib.
+We provide a setup.cfg_ file which you can use to customize the build
+process. For example, which default backend to use, whether some of the
+optional libraries that Matplotlib ships with are installed, and so on.  This
+file will be particularly useful to those packaging Matplotlib.
+
+.. _setup.cfg: https://raw.githubusercontent.com/matplotlib/matplotlib/master/setup.cfg.template
 
 If you have installed prerequisites to nonstandard places and need to
 inform Matplotlib where they are, edit ``setupext.py`` and add the base
@@ -282,7 +280,7 @@ If you are using MacPorts, execute the following instead::
 After installing the above requirements, install Matplotlib from source by
 executing::
 
-  python setup.py install
+  python -mpip install .
 
 Note that your environment is somewhat important. Some conda users have
 found that, to run the tests, their PYTHONPATH must include
diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst
@@ -90,33 +90,32 @@ the env ``MPLLOCALFREETYPE`` as::
 
   export MPLLOCALFREETYPE=1
 
-or copy :file:`setup.cfg.template` to :file:`setup.cfg` and edit it to contain ::
+or copy :file:`setup.cfg.template` to :file:`setup.cfg` and edit it to contain
+::
 
   [test]
   local_freetype = True
 
-
 To install Matplotlib (and compile the c-extensions) run the following
 command from the top-level directory ::
 
-    pip install -v -e ./
+    pip install -ve .
 
 This installs Matplotlib in 'editable/develop mode', i.e., builds
 everything and places the correct link entries in the install
 directory so that python will be able to import Matplotlib from the
 source directory.  Thus, any changes to the ``*.py`` files will be
 reflected the next time you import the library.  If you change the
-c-extension source (which might happen if you change branches) you
+C-extension source (which might happen if you change branches) you
 will need to run::
 
    python setup.py build
 
-or re-run ``pip install -v -e ./``.
-
+or re-run ``pip install -ve .``.
 
 Alternatively, if you do ::
 
-  pip install -v ./
+  pip install -v .
 
 all of the files will be copied to the installation directory however,
 you will have to rerun this command every time the source is changed.
@@ -132,7 +131,6 @@ environment is set up properly::
 
   python tests.py
 
-
 .. _pytest: http://doc.pytest.org/en/latest/
 .. _pep8: https://pep8.readthedocs.io/en/latest/
 .. _mock: https://docs.python.org/dev/library/unittest.mock.html
diff --git a/doc/faq/troubleshooting_faq.rst b/doc/faq/troubleshooting_faq.rst
@@ -155,7 +155,7 @@ mode::
     rm -rf /path/to/site-packages/matplotlib*
     git clean -xdf
     git pull
-    python setup.py install > build.out
+    python -mpip install -v . > build.out
     python examples/pylab_examples/simple_plot.py --verbose-debug > run.out
 
 and post :file:`build.out` and :file:`run.out` to the `matplotlib-devel
