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
And maybe turn the whole sentence into:

``To guarantee that a widget remains responsive and not garbage-collected, a reference to the object should be maintained by the user.``