improvements to installation faq

ddale · ddale · commit ee03853b9574 · 2008-06-14T14:32:13.000Z
svn path=/trunk/matplotlib/; revision=5539
diff --git a/doc/faq/installing_faq.rst b/doc/faq/installing_faq.rst
@@ -43,37 +43,42 @@ If you are still having trouble, see :ref:`reporting-problems`.
 How do I cleanly rebuild and reinstall everything?
 ==================================================
 
-# TODO: include for binary installs 
+1. Delete the caches from your :ref:`.matplotlib configuration directory
+<locating-matplotlib-config-dir>`.
 
-Unfortunately::
+The next steps depend on your platform and installation method.
 
-    python setup.py clean
+Easy Install
+------------
 
-does not properly clean the build directory, and does nothing to the
-install directory.  To cleanly rebuild:
+2. Run::
+
+     easy_install -m PackageName
+
+3. Delete any .egg files or directories from your `installation directory
+   <locating-matplotlib-install>`.
 
-    * delete the ``build`` directory in the source tree
-    * delete ``site-packages/matplotlib`` directory in the Python
-      installation.  The location of ``site-packages`` is
-      platform-specific.  You can find out where matplotlib is installed by doing::
 
-          > python -c 'import matplotlib; print matplotlib.__file__'
+Windows installer
+-----------------
 
-      and then making sure you remove the matplotlib directory (and
-      any matplotlib*.egg files) you find there.
+2. Use :menuselection:`Start --> Control Panel` to start the :program:`Add and
+Remove Software` utility.
 
-    * you may also want to clear some of the cache data that
-      matplotlib stores in your ``.matplotlib`` directory.  You can
-      find the location of this directory by doing::
+Source install
+--------------
 
-          import matplotlib
-          print matplotlib.get_configdir()
+Unfortunately::
+
+    python setup.py clean
+
+does not properly clean the build directory, and does nothing to the
+install directory.  To cleanly rebuild:
 
-      A typical location for the config directory is :file:`.matplotlib`, and the following
-      caches may need to be cleared after a major update::
+2. Delete the ``build`` directory in the source tree
+3. Delete any matplotlib directories or eggs from your `installation directory
+   <locating-matplotlib-install>`
 
-          rm -rf ~/.matplotlib/tex.cache
-	  rm -rf ~/.matplotlib/fontManager.cache
 
 Backends
 ========
