This is a little complicated because thesedo have a default value in__init__, but not in theirset_<attr> method... but the way the docstring is constructed takes the descriptions from the setters.

Ithink we may be able to do some appending of default values where that table gets constructed (though I have not looked at all the places that code is used/all the docstrings it interacts with, which could result in confusing doubleDefault: ... sections if there already is one). However, it is several layers deep in how it is constructed, so may not be trivial to do so (not the least because you somehow need to thread through where to take the defaults from, and that isn't there now:

• _docstring._ArtistPropertiesSubstitution
• `_docstring._ArtistKwdocLoader
• artist.kwdoc
• artist.ArtistInspector
• artist.ArtistInspector.pprint_setters

So in short, not trivial, but probably possible... would need careful consideration of how these pieces interact though (and would include changing some "public" (though potentially should be private) APIs to do it).

See also#22699 which provides a mechanism for potentially adding/modifying the info that gets put into the table. (It is currently marked as "proof of concept", and has not been merged, though has had some positive response)

This is a little complicated because thesedo have a default value in__init__, but not in theirset_<attr> method... but the way the docstring is constructed takes the descriptions from the setters.

@ksunden@StefRe as an interim measure, how would you feel about giving the setter methods the same defaults as those parameters?

how would you feel about giving the setter methods the same defaults as those parameters?

I think making an API change just for documentation purposes is not the way to go (also, a setter without an argument isn't a setter anymore, I'd expect such a method be calledreset...).

... probably possible... would need careful consideration of how these pieces interact though (and would include changing some "public" (though potentially should be private) APIs to do it).

@ksunden as@StefRe objected to that, I reverted back to the way he likes it. While setting out along your advice, I came across the mystery as to why the docstring athttps://github.com/matplotlib/matplotlib/blob/main/lib/matplotlib/text.py#L125 doesn't appear anywhere inhttps://matplotlib.org/devdocs/api/_as_gen/matplotlib.pyplot.text.html -- so that led me to discover the top of that doc page comes fromhttps://github.com/matplotlib/matplotlib/blob/main/lib/matplotlib/axes/_axes.py#L633 so I clarified the alignment parameter defaults there instead of the table.

Review please?

Thanks@jsalsman and congratulations on your first merged PR! Hope to see you around!