Fix Sphinx warning in widgets

And improve the rendering of the docstring somewhat

The merge of #3502 raised an additional Sphinx warning causing the docs to fail (https://travis-ci.org/matplotlib/matplotlib/builds/40764942)