Add API notes

dstansby · dstansby · commit bc76b451bca8 · 2018-03-04T13:54:35.000Z
diff --git a/doc/api/next_api_changes/2018-02-20-DS-hold.rst b/doc/api/next_api_changes/2018-02-20-DS-hold.rst
@@ -0,0 +1,7 @@
+Hold machinery removed
+----------------------
+
+Setting or unsetting ``hold`` (deprecated in version 2.1) has now
+been completely removed. Matplotlib now always behaves as if ``hold=True``.
+To clear an axes you can manually use :meth:`~.axes.Axes.cla()`,
+or to clear an entire figure use :meth:`~.figure.Figure.clf()`.
