matplotlib
diff --git a/‎.flake8
-1 b/‎.flake8
-1
diff --git a/‎.git_archival.txt
+1 b/‎.git_archival.txt
+1
diff --git a/‎.gitattributes
+1-1 b/‎.gitattributes
+1-1
diff --git a/‎.gitignore
+2 b/‎.gitignore
+2
diff --git a/‎MANIFEST.in
-23 b/‎MANIFEST.in
-23
diff --git a/‎doc/conf.py
+1-1 b/‎doc/conf.py
+1-1
diff --git a/‎doc/devel/contributing.rst
+1-1 b/‎doc/devel/contributing.rst
+1-1
diff --git a/‎doc/devel/release_guide.rst
+5-5 b/‎doc/devel/release_guide.rst
+5-5
diff --git a/‎lib/matplotlib/__init__.py
+2-4 b/‎lib/matplotlib/__init__.py
+2-4
@@ -35,7 +35,6 @@ exclude =
     doc/gallery
     doc/tutorials
     # External files.
-    versioneer.py
     tools/gh_api.py
     tools/github_stats.py
     .tox
 
@@ -0,0 +1 @@
+ref-names: $Format:%D$
@@ -2,4 +2,4 @@
 *.ppm binary
 *.svg binary
 *.svg linguist-language=true
-lib/matplotlib/_version.py export-subst
+.git_archival.txt export-subst
@@ -42,6 +42,8 @@ pip-wheel-metadata/*
 # tox testing tool
 .tox
 setup.cfg
+# generated by setuptools_scm
+lib/matplotlib/_version.py
 
 # OS generated files #
 ######################
 
@@ -196,7 +196,7 @@ def _check_dependencies():
 try:
     SHA = subprocess.check_output(
         ['git', 'describe', '--dirty']).decode('utf-8').strip()
-# Catch the case where git is not installed locally, and use the versioneer
+# Catch the case where git is not installed locally, and use the setuptools_scm
 # version number instead
 except (subprocess.CalledProcessError, FileNotFoundError):
     SHA = matplotlib.__version__
 
@@ -385,7 +385,7 @@ New modules and files: installation
 
 * If you have added new files or directories, or reorganized existing
   ones, make sure the new files are included in the match patterns in
-  :file:`MANIFEST.in`, and/or in *package_data* in :file:`setup.py`.
+  in *package_data* in :file:`setupext.py`.
 
 C/C++ extensions
 ----------------
 
@@ -178,14 +178,12 @@ Finally, push the tag to GitHub::
 
 Congratulations, the scariest part is done!
 
-.. [#] The tarball that is provided by GitHub is produced using `git
-       archive <https://git-scm.com/docs/git-archive>`__.  We use
-       `versioneer <https://github.com/warner/python-versioneer>`__
-       which uses a format string in
+.. [#] The tarball that is provided by GitHub is produced using `git archive`_.
+       We use setuptools_scm_ which uses a format string in
        :file:`lib/matplotlib/_version.py` to have ``git`` insert a
        list of references to exported commit (see
        :file:`.gitattributes` for the configuration).  This string is
-       then used by ``versioneer`` to produce the correct version,
+       then used by ``setuptools_scm`` to produce the correct version,
        based on the git tag, when users install from the tarball.
        However, if there is a branch pointed at the tagged commit,
        then the branch name will also be included in the tarball.
@@ -197,6 +195,8 @@ Congratulations, the scariest part is done!
 
           git archive v2.0.0 -o matplotlib-2.0.0.tar.gz --prefix=matplotlib-2.0.0/
 
+.. _git archive: https://git-scm.com/docs/git-archive
+.. _setuptools_scm: https://github.com/pypa/setuptools_scm
 
 If this is a final release, also create a 'doc' branch (this is not
 done for pre-releases)::
 
@@ -111,11 +111,9 @@
 
 import numpy
 
-# Get the version from the _version.py versioneer file. For a git checkout,
+# Get the version from the _version.py setuptools_scm file. For a git checkout,
 # this is computed based on the number of commits since the last tag.
-from ._version import get_versions
-__version__ = str(get_versions()['version'])
-del get_versions
+from ._version import version as __version__
 
 _log = logging.getLogger(__name__)