default and cancel button support. Docs fixes

Added support for default_button and cancel_button to most (all) GUI
elements.

Updated docs.  Fixed some reStructured text formatting and suppressed
the module-level documentation.