updated README and INSTALL

svn path=/trunk/matplotlib/; revision=109

Author: jdh2358

API_CHANGES

@@ -27,6 +27,11 @@ API changes at 0.42
   * After getting Text handled in a backend independent fashion, the
     import process is much cleaner since there are no longer cyclic
     dependencies
+
+  * matplotlib.matlab._get_current_fig_manager renamed to
+    matplotlib.matlab.get_current_fig_manager to allow user access to
+    the GUI window attribute, eg figManager.window for GTK and
+    figManager.frame for wx
 
 
 

INSTALL

@@ -1,33 +1,12 @@
-matplotlib requires python 2.2+, Numeric and pygtk 1.99.16, which
-requires GTK2.
+matplotlib requires python 2.2+, and Numeric-22+.  The other
+requirements are backend dependent
 
-If these dependencies are satisfied, just do the usual thing:
+If these requirements are satisfied, just do the usual thing:
 
   > python setup.py install
 
-I have installed and tested this on linux and several win32 platforms,
-but it should run anywhere that Numeric and pygtk run.
+The latest install instructions can be found at
+http://matplotlib.sourceforge.net/installing.html.
 
-If you want to use matplotlib interactively from the prompt, see the
-file INTERACTIVE.
-
-Redhat Users:
-
-  GTK2 became the default with the Redhat Linux 8 series.  If you're
-  distro is older than that, you'll need to upgrade your desktop,
-  upgrade your gtk libs, or upgrade your distro.
-
-
-Windows Users:
-
-   Windows users should consult
-   http://www.mapr.ucl.ac.be/~gustin/win32_ports for information about
-   pygtk for win32.  Basically, you need to install the GTK+ 2.2
-   runtime and pygtk-1.99.16, both of which have friendly windows
-   installers.  After you install the runtime, you may need to add the
-   bin and lib subdirs of your install dir to your PATH.
-
-
-If you have any questions, email me at 
-John Hunter <jdhunter@ace.bsd.uchicago.edu> or post to
-comp.lang.python, which I read frequently.
+The backend specific requirements (eg, for GTK, GD, PS or WX) can be
+found at http://matplotlib.sourceforge.net/backends.html

Makefile

@@ -2,6 +2,9 @@
 # Copyright (C) 2003  <jdhunter@ace.bsd.uchicago.edu>
 # $Header$
 # $Log$
+# Revision 1.13  2004/01/27 16:18:08  jdh2358
+# updated README and INSTALL
+#
 # Revision 1.12  2004/01/26 18:27:46  jdh2358
 # more ps and text API fixes
 #
@@ -73,8 +76,7 @@ RELEASE = matplotlib-${VERSION}
 clean: 
 	${PYTHON} setup.py clean;\
 	find . \( -name "*~" -o -name "*.pyc" \) | xargs rm -f;\
-	find examples -name "*.png"  | xargs rm -f;\
-	find matplotlib -name "*.png"  | xargs rm -f;
+	find examples \(-o -name "*.png" -o -name "*.ps"  -o -name "*.jpg" -o -name "*.eps" \) | xargs rm -f
 
 htmldocs: 
 	rm -rf htdocs/matplotlib;\

README

@@ -1,37 +1,68 @@
 INTRODUCTION:
 
-   matplotlib is a pure python plotting library designed to bring
-   publication quality plotting to python with a syntax familiar to
-   matlab users.  Although the goal of publication quality is not yet
-   attained (see GOALS), the library does produce high quality 2D
-   plots.  All of the plotting commands can be accessed either via a
-   functional interface familiar to matlab users or an object oriented
-   interface familiar to python users.
-   
+
+   matplotlib is a pure python 2D plotting library with a Matlab?
+   syntax which produces publication quality figures using in a
+   variety of hardcopy formats (PNG, JPG, TIFF, PS) and interactive
+   GUI environments (WX, GTK) across platforms. matplotlib can be used
+   in python scripts, interactively from the python shell (ala matlab
+   or mathematica), in web application servers generating dynamic
+   charts, or embedded in GTK or WX applications; see backends.
+
+  matplotlib trys to make easy things easy and hard things
+  possible. You can generate plots, histograms, power spectra, bar
+  charts, errorcharts, scatterplots, etc, with just a few lines of
+  code. For example, to make a histogram of data in x, you simply need
+  to type
+
+  >>> hist(x, 100)   # use 100 bins
+  
+
+  For the power user, you have full control of line styles, font
+  properties, axes properties, etc, via an object oriented interface
+  or via a handle graphics interface familiar to matlab users. A
+  summary of the goals of matplotlib and the progress so far can be
+  found here.
 
 REQUIREMENTS:
 
-   python 2.2+, pygtk-1.99.16 (requires GTK2) and Numeric-22+
+   python 2.2+, and Numeric-22+.  Other requirements are backend
+   dependent.  See http://matplotlib.sourceforge.net/backends.html
 
 INSTALL
 
-  If you have the requirements, just do 'python setup.py install'.  
+  If you have the requirements, just do 'python setup.py install'.
+
+
+  Quick start install instructions can be found here -
+  http://matplotlib.sourceforge.net/installing.html
+
+  For backend specific install information see
+  http://matplotlib.sourceforge.net/backends.html
 
   If you want to use matplotlib interactively from the prompt, see
-  INTERACTIVE
+  http://matplotlib.sourceforge.net/interactive.html
 
 
 EXAMPLES
 
-  See the examples in the examples dir.
+  See the examples in the examples dir.  To see examples scripts with
+  the outputs they produce, see
+  http://matplotlib.sourceforge.net/screenshots.html
 
 AUTHOR
 
   John D. Hunter <jdhunter@ace.bsd.uchicago.edu>
-  Copyright (c) 2002 John D. Hunter; All Rights Reserved
+  Copyright (c) 2002-2004 John D. Hunter; All Rights Reserved.
+
+  Jeremy O'Donoghue wrote the wx backend
+
+  See http://matplotlib.sourceforge.net/credits.html for additionaly
+  contributors
 
 LICENSE
 
   Based on that of python 2.2.  See the LICENSE file that ships with
-  the matplotlib source code
+  the matplotlib source code or
+  http://matplotlib.sourceforge.net/license.html
 

examples/simple_plot.py

@@ -6,7 +6,9 @@
 
 xlabel('time (s)')
 ylabel('voltage (mV)')
-title('About as simple as it gets, folks')
+t = title('About as simple as it gets, folks', verticalalignment='bottom')
+t.set_y(0.99)
+
 #grid(True)
 #set(gca(), 'xticks', (0,.2,.7))
 savefig('test2.eps')

setup.py

@@ -9,7 +9,7 @@
 data.extend(glob.glob('images/*.xpm'))
 
 setup(name="matplotlib",
-      version= '0.42',
+      version= '0.42g',
       description = "Matlab style python plotting package",
       author = "John D. Hunter",
       author_email="jdhunter@ace.bsd.uchicago.edu",