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.
-------------------------------------------------------------------------
This SF.net email is sponsored by: Microsoft
Defy all challenges. Microsoft(R) Visual Studio 2008.
http://clk.atdmt.com/MRT/go/vse0120000070mrt/direct/01/
_______________________________________________
Matplotlib-checkins mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/matplotlib-checkins
