SF.net SVN: matplotlib: [5331] trunk/matplotlib/doc/faq

[<md...@us...>]

Revision: 5331
          http://matplotlib.svn.sourceforge.net/matplotlib/?rev=5331&view=rev
Author:   mdboom
Date:     2008-05-30 12:28:56 -0700 (Fri, 30 May 2008)

Log Message:
-----------
Adding some FAQs

Modified Paths:
--------------
    trunk/matplotlib/doc/faq/index.rst
    trunk/matplotlib/doc/faq/installing_faq.rst

Added Paths:
-----------
    trunk/matplotlib/doc/faq/troubleshooting_faq.rst

Modified: trunk/matplotlib/doc/faq/index.rst
===================================================================
--- trunk/matplotlib/doc/faq/index.rst	2008-05-30 19:24:37 UTC (rev 5330)
+++ trunk/matplotlib/doc/faq/index.rst	2008-05-30 19:28:56 UTC (rev 5331)
@@ -12,5 +12,6 @@
 .. toctree::
 
    installing_faq.rst
+   troubleshooting_faq.rst
    plotting_faq.rst
 

Modified: trunk/matplotlib/doc/faq/installing_faq.rst
===================================================================
--- trunk/matplotlib/doc/faq/installing_faq.rst	2008-05-30 19:24:37 UTC (rev 5330)
+++ trunk/matplotlib/doc/faq/installing_faq.rst	2008-05-30 19:28:56 UTC (rev 5331)
@@ -1,7 +1,23 @@
-****************
-Installation FAQ
-****************
+==================
+ Installation FAQ
+==================
 
+How do I report a compilation problem?
+======================================
 
+See :ref:`reporting_problems`.
 
+How do I cleanly rebuild and reinstall everything?
+==================================================
 
+Unfortunately::
+
+    python setup.py clean
+
+does not properly clean the build directory, and does nothing to the
+install directory.  To cleanly rebuild:
+
+    * 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.

Added: trunk/matplotlib/doc/faq/troubleshooting_faq.rst
===================================================================
--- trunk/matplotlib/doc/faq/troubleshooting_faq.rst	                        (rev 0)
+++ trunk/matplotlib/doc/faq/troubleshooting_faq.rst	2008-05-30 19:28:56 UTC (rev 5331)
@@ -0,0 +1,45 @@
+===================
+Troubleshooting FAQ
+===================
+
+.. _reporting_problems:
+
+How do I report a problem?
+==========================
+
+If you are having a problem with matplotlib, search the mailing
+lists first: There's a good chance someone else has already run into
+your problem.
+
+If not, please provide the following information in your e-mail to the
+mailing list:
+
+  * your operating system
+  * matplotlib version
+  * where you obtained matplotlib (e.g. your Linux distribution's
+    packages or the matplotlib Sourceforge site)
+  * any customizations to your ``matplotlibrc`` file
+  * if the problem is reproducible, please try to provide a minimal,
+    standalone Python script that demonstrates the problem
+
+If you compiled matplotlib yourself, please also provide 
+
+  * any changes you have made to ``setup.py`` or ``setupext.py``
+  * the output of::
+
+      rm -rf build
+      python setup.py build
+
+    The beginning of the build output contains lots of details about your
+    platform that are useful for the matplotlib developers to diagnose
+    your problem.  
+
+Including this information in your first e-mail to the mailing list
+will save a lot of time.
+
+You will likely get a faster response writing to the mailing list than
+filing a bug in the bug tracker.  Most developers check the bug
+tracker only periodically.  If your problem has been determined to be
+a bug and can not be quickly solved, you may be asked to file a bug in
+the tracker so the issue doesn't get lost.
+


This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site.