updated installing docs

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

Author: jdh2358

CHANGELOG

@@ -1,5 +1,7 @@
 New entries should be added at the top
 
+2004-08-05 Updated installing.html and INSTALL - JDH
+
 2004-08-01 backend_gtk.py: move all drawing code into the expose_event()
 
 2004-07-28 Added Greg's toolbar2 and backend_*agg patches - JDH

INSTALL

@@ -6,6 +6,16 @@ INTRODUCTION
   below.  Matplotlib is known to work on linux, unix, win32 and OS X
   platforms.
 
+  There are two kinds of matplotlib backends: vector based and raster
+  based.  The vector based backends, SVG and PS, produce ASCII text
+  output files *.svg and *.ps.  The core raster based renderer is the
+  http://antigrain.com (agg) backend.  This is a high quality 2D
+  library that supports fast antialiasing, alpha blending and much
+  more.  If you want to produce PNGs or GUI images that support all of
+  matplotlib's features, you should compile matplotlib with agg
+  support and use one of the GUI agg backends: GTKAgg, WXAgg, TkAgg or
+  FLTKAgg.   
+
 COMPILING
 
   You will need to have recent versions of freetype (>= 2.1.7), libpng
@@ -23,6 +33,11 @@ COMPILING
   don't want a particular backend or extension, you can set that flag
   to False.
 
+  As discussed above, most users will want to set 'BUILD_AGG = 1' and
+  one or more of the GUI backends to True.  Exceptions to this are if
+  you know you don't need a GUI (eg a web server) or you only want to
+  produce vector graphics. 
+
   If you have installed prerequisites to nonstandard places and need
   to inform matplotlib where they are, edit setupext.py an add the
   base dirs to the 'basedir' dictionary entry for your sys.platform.
@@ -108,10 +123,10 @@ PACKAGE MANAGERS: (rpms, apt, fink)
     packages at http://mentors.debian.net
 
 
-      * add this lines to your /etc/apt/sources.list: deb
-        http://mentors.debian.net/debian unstable main contrib
-        non-free deb-src http://mentors.debian.net/debian unstable
-        main contrib non-free
+      * add these lines to your /etc/apt/sources.list: 
+
+      deb http://mentors.debian.net/debian unstable main contrib non-free
+      deb-src http://mentors.debian.net/debian unstable main contrib non-free
 
       * then run:
         # apt-get update

TODO

@@ -512,11 +512,12 @@ ZeroDivisionError: SeparableTransformation::eval_scalars yin interval is zero; c
 
 -- update installing.html from INSTALL
 
--- rubberbanding broken on subplot_demo/gtk
+-- DONE rubberbanding broken on subplot_demo/gtk
 
--- add copy/deepcopy support for transforms
+-- PARTIAL - need to copy function type - add copy/deepcopy support
+   for transforms
 
--- text looks funky in SVG - stroke width?
+-- DONE (added stroke width) text looks funky in SVG - stroke width?
 
 -- blit on gtkagg after print is whacked
 

examples/pythonic_matplotlib.py

@@ -17,11 +17,11 @@
 case you will want to control the creation of all your figures,
 embedding them in application windows, etc.
 
-If you seen an example in the examples dir written in matlab
-interface, and you want to emulate that using the true python method
-calls, there is an easy mapping.  Many of those examples use 'set' to
-control figure properties.  Here's how to map those commands onto
-instance methods
+If you see an example in the examples dir written in matlab interface,
+and you want to emulate that using the true python method calls, there
+is an easy mapping.  Many of those examples use 'set' to control
+figure properties.  Here's how to map those commands onto instance
+methods
 
 The syntax of set is