DOC : added note about maintain ref to widgets

Added note to widget doc-strings that the user must maintain a reference
to the widgets to keep them responsive (if they get gc'd the call backs
go away).

Some random conversion to numpyboc

Closes #3105
I'm not sure about putting this in each of the widget subclass docstrings...