whats_new: a note about the changed examples

ivanov · ivanov · commit bf8d1bc9847f · 2012-12-14T14:19:09.000-08:00
diff --git a/doc/users/whats_new.rst b/doc/users/whats_new.rst
@@ -33,6 +33,14 @@ Andrew Dawson added a new keyword argument *extendrect* to
 :meth:`~matplotlib.pyplot.colorbar` to optionally make colorbar
 extensions rectangular instead of triangular.
 
+Examples now use subplots()
+---------------------------
+For the sake of brevity and clarity, most of the :ref:`examples
+<examples-index>` now use the newer :func:`~matplotlib.pyplot.subplots`
+, which creates a figure and one (or multiple) axes object(s) in one
+call. The old way involved a call to :func:`~matplotlib.pyplot.figure`,
+followed by one (or multiple) :func:`~matplotlib.pyplot.subplot` calls.
+
 Calling subplot() without arguments
 -----------------------------------
 A call to :func:`~matplotlib.pyplot.subplot` without any arguments now
