update CHANGELOG, api_changes.rst for new handling of extend kwarg

efiring · efiring · commit 0c347f3379b5 · 2012-07-24T09:56:13.000-10:00
diff --git a/CHANGELOG b/CHANGELOG
@@ -1,3 +1,10 @@
+2012-07-24 Contourf handles the extend kwarg by mapping the extended
+           ranges outside the normed 0-1 range so that they are
+           handled by colormap colors determined by the set_under
+           and set_over methods.  Previously the extended ranges
+           were mapped to 0 or 1 so that the "under" and "over"
+           colormap colors were ignored. - EF
+
 2012-06-24 Make use of mathtext in tick labels configurable - DSD
 
 2012-06-05 Images loaded through PIL are now ordered correctly - CG
diff --git a/doc/api/api_changes.rst b/doc/api/api_changes.rst
@@ -14,6 +14,16 @@ For new features that were added to matplotlib, please see
 Changes in 1.2.x
 ================
 
+* In :meth:`~matplotlib.axes.Axes.contourf`, the handling of the *extend*
+  kwarg has changed.  Formerly, the extended ranges were mapped
+  after to 0, 1 after being normed, so that they always corresponded
+  to the extreme values of the colormap.  Now they are mapped
+  outside this range so that they correspond to the special
+  colormap values determined by the
+  :meth:`~matplotlib.colors.Colormap.set_under` and
+  :meth:`~matplotlib.colors.Colormap.set_over` methods, which
+  default to the colormap end points.
+
 * The new rc parameter ``savefig.format`` replaces ``cairo.format`` and
   ``savefig.extension``, and sets the default file format used by
   :meth:`matplotlib.figure.Figure.savefig`.
