Is this information incorrect?
This line seems to preclude ever getting to the below code to process
the caption.
https://github.com/matplotlib/matplotlib/blob/master/lib/matplotlib/sphinxext/plot_directive.py#L601
I think the proper fix is to make :caption: an option.
Skipper