Dear all,

when including plots in sphinx documents, like:

.. plot:: plot.py

   Caption not working!

According to documentation, this should include the caption, however
make html will fail because of a RuntimeError("plot:: directive can't have both args and content"), which is raised in line 671 of plot_directive.py.

Removing that line fixes the problem for me, but I wonder why was that restriction implemented in the first place.