Document undocumented public items

Perhaps depending on #605.
Oops. That made me realize that this actually replaced the method that was documented above it, `getButtons()`. Improved the description. Thanks. Cool?