Add information about numpy copies. Add suggested replacement for offset_copy().

mdboom · mdboom · commit 4838fbe8b9cc · 2008-06-27T13:33:33.000Z
svn path=/trunk/matplotlib/; revision=5687
diff --git a/API_CHANGES b/API_CHANGES
@@ -55,6 +55,11 @@ TRANSFORMS REFACTORING
     See transforms.py for a description of the design of the new
     transformation framework.
 
+    For efficiency, many of these functions return views into Numpy
+    arrays.  This means that if you hold on to a reference to them,
+    their contents may change.  If you want to store a snapshot of
+    their current values, use the Numpy array method copy().
+
     The view intervals are now stored only in one place -- in the Axes
     instance, not in the formatter instances as well.  This means
     formatters must get their limits from their Axis, which in turn
@@ -122,6 +127,8 @@ TRANSFORMS REFACTORING
 
       Transform.inverse_xy_tup(points)		Transform.inverted().transform(points)
 
+      offset_copy(trans, x, y)                  trans + Affine2D().translate(x, y)
+
     axes.py
       Axes.get_position()			Axes.get_position()
         [Axes.get_position() used to return a list of points, not it
