Merge pull request #14770 from meeseeksmachine/auto-backport-of-pr-14759-on-v3.1.1-doc

timhoffm · web-flow · commit 6198af6dc25d · 2019-07-14T14:46:00.000+02:00
Backport PR #14759 on branch v3.1.1-doc (DOC: note about having to rebuild after switching to local freetype)
diff --git a/doc/devel/contributing.rst b/doc/devel/contributing.rst
@@ -106,7 +106,15 @@ Copy :file:`setup.cfg.template` to :file:`setup.cfg` and edit it to contain::
   tests = True
 
 or set the ``MPLLOCALFREETYPE`` environmental variable to any true
-value.
+value.  If you have previously built Matplotlib with a different
+version of Freetype, you will also need to remove the c/c++ build
+products.  Do this is to delete the ``build`` folder or ``git clean
+-xfd``.  If you are going to be regularly working on Matplotlib,
+consider putting ::
+
+   export MPLLOCALFREETYPE=1
+
+in your shell start up files.
 
 
 Installing Matplotlib in developer mode
