Remove outdated docstring section in RendererBase.draw_text.

anntzer · anntzer · commit 25a56a2ae757 · 2024-06-12T11:11:19.000+02:00
The line of code mentioned in the docstring has been removed since e50ff69, back in 2004... Replace with a comment in the code, closer to the place relevant for metrics calculations.
diff --git a/lib/matplotlib/backend_bases.py b/lib/matplotlib/backend_bases.py
@@ -513,21 +513,7 @@ def draw_text(self, gc, x, y, s, prop, angle, ismath=False, mtext=None):
             If True, use mathtext parser. If "TeX", use tex for rendering.
         mtext : `~matplotlib.text.Text`
             The original text object to be rendered.
-
-        Notes
-        -----
-        **Note for backend implementers:**
-
-        When you are trying to determine if you have gotten your bounding box
-        right (which is what enables the text layout/alignment to work
-        properly), it helps to change the line in text.py::
-
-            if 0: bbox_artist(self, renderer)
-
-        to if 1, and then the actual bounding box will be plotted along with
-        your text.
         """
-
         self._draw_text_as_path(gc, x, y, s, prop, angle, ismath)
 
     def _get_text_path_transform(self, x, y, s, prop, angle, ismath):
@@ -604,6 +590,9 @@ def get_text_width_height_descent(self, s, prop, ismath):
 
         Whitespace at the start and the end of *s* is included in the reported width.
         """
+        # Note: Using the ``bbox`` property of Text objects, backend
+        # implementers can check their bounding box calculations (which impact
+        # text layout).
         fontsize = prop.get_size_in_points()
 
         if ismath == 'TeX':
