DOC: Show and correct default alignment parameters in text.py (#27346)

jsalsman · web-flow · commit 60d2f95bdb7f · 2023-12-13T12:09:26.000+01:00
* Show and correct default alignment parameters in text.py For issue [Doc]: text alignment defaults #27345 * Update text.py: line too long * Show defaults in text_alignment.py * Make setter method defaults match new docstrings in text.py See #27346 (review) * IDL text alignment set_ method defaults for text.pyi * revert interface defaults in text.pyi * revert defaults in alignment set_ methods text.py did change the order of allowed arguments for set_verticalalignment per @StefRe * Document text alignment defaults in _axes.py Because this is where the header at https://matplotlib.org/devdocs/api/_as_gen/matplotlib.pyplot.text.html comes from. * rm trailing whitespace in _axes.py
diff --git a/galleries/examples/text_labels_and_annotations/text_alignment.py b/galleries/examples/text_labels_and_annotations/text_alignment.py
@@ -4,7 +4,8 @@
 ==============
 
 Texts are aligned relative to their anchor point depending on the properties
-``horizontalalignment`` and ``verticalalignment``.
+``horizontalalignment`` (default: ``left``) and ``verticalalignment``
+(default: ``baseline``.)
 
 .. redirect-from:: /gallery/pyplots/text_layout
 
diff --git a/lib/matplotlib/axes/_axes.py b/lib/matplotlib/axes/_axes.py
@@ -632,7 +632,10 @@ def text(self, x, y, s, fontdict=None, **kwargs):
         """
         Add text to the Axes.
 
-        Add the text *s* to the Axes at location *x*, *y* in data coordinates.
+        Add the text *s* to the Axes at location *x*, *y* in data coordinates,
+        with a default ``horizontalalignment`` on the ``left`` and
+        ``verticalalignment`` at the ``baseline``. See
+        :doc:`/gallery/text_labels_and_annotations/text_alignment`.
 
         Parameters
         ----------
diff --git a/lib/matplotlib/text.py b/lib/matplotlib/text.py
@@ -123,7 +123,7 @@ def __init__(self,
 
         The text is aligned relative to the anchor point (*x*, *y*) according
         to ``horizontalalignment`` (default: 'left') and ``verticalalignment``
-        (default: 'bottom'). See also
+        (default: 'baseline'). See also
         :doc:`/gallery/text_labels_and_annotations/text_alignment`.
 
         While Text accepts the 'label' keyword argument, by default it is not
@@ -1251,7 +1251,7 @@ def set_verticalalignment(self, align):
 
         Parameters
         ----------
-        align : {'bottom', 'baseline', 'center', 'center_baseline', 'top'}
+        align : {'baseline', 'bottom', 'center', 'center_baseline', 'top'}
         """
         _api.check_in_list(
             ['top', 'bottom', 'center', 'baseline', 'center_baseline'],
