Rename annotate parameter to match upstream

ksunden · ksunden · commit 8417223d5678 · 2020-03-05T10:03:41.000-06:00
Run boilerplate.py

change version rename takes effect

Co-Authored-By: Thomas A Caswell &lt;tcaswell@gmail.com&gt;

Release note of variable change

Rebased onto newer master
diff --git a/doc/api/next_api_changes/2019-08-12-KS.rst b/doc/api/next_api_changes/2019-08-12-KS.rst
@@ -0,0 +1,9 @@
+Changes in parameter names
+``````````````````````````
+
+The parameter ``s`` to `.Axes.annotate` renamed to ``text``, matching
+`Annotation`.
+This change propegates to ``pyplot.annotate``.
+
+The old parameter name remains supported for `.Axes.annotate`, but
+support for it will be dropped in a future Matplotlib release.
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -754,9 +754,10 @@ def text(self, x, y, s, fontdict=None, **kwargs):
         self._add_text(t)
         return t
 
+    @cbook._rename_parameter("3.2", "s", "text")
     @docstring.dedent_interpd
-    def annotate(self, s, xy, *args, **kwargs):
-        a = mtext.Annotation(s, xy, *args, **kwargs)
+    def annotate(self, text, xy, *args, **kwargs):
+        a = mtext.Annotation(text, xy, *args, **kwargs)
         a.set_transform(mtransforms.IdentityTransform())
         if 'clip_on' in kwargs:
             a.set_clip_path(self.patch)
diff --git a/lib/matplotlib/pyplot.py b/lib/matplotlib/pyplot.py
@@ -2214,8 +2214,8 @@ def angle_spectrum(
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
 @docstring.copy(Axes.annotate)
-def annotate(s, xy, *args, **kwargs):
-    return gca().annotate(s, xy, *args, **kwargs)
+def annotate(text, xy, *args, **kwargs):
+    return gca().annotate(text, xy, *args, **kwargs)
 
 
 # Autogenerated by boilerplate.py.  Do not edit as changes will be lost.
