Merge pull request matplotlib#24688 from oscargus/quiverdoc

Deprecate quiver_doc and barbs_doc class members

Author: timhoffm

doc/api/next_api_changes/deprecations/24688-OG.rst

@@ -0,0 +1,5 @@
+``Quiver.quiver_doc`` and ``Barbs.barbs_doc``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+... are deprecated. These are the doc-string and should not be accessible as
+a named class member.

lib/matplotlib/quiver.py

@@ -722,7 +722,7 @@ def _h_arrows(self, length):
         # Mask handling is deferred to the caller, _make_verts.
         return X, Y
 
-    quiver_doc = _quiver_doc
+    quiver_doc = _api.deprecated("3.7")(property(lambda self: _quiver_doc))
 
 
 _barbs_doc = r"""
@@ -1179,4 +1179,4 @@ def set_offsets(self, xy):
         super().set_offsets(xy)
         self.stale = True
 
-    barbs_doc = _barbs_doc
+    barbs_doc = _api.deprecated("3.7")(property(lambda self: _barbs_doc))