|
From: <md...@us...> - 2008-05-30 19:28:57
|
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.
|