Include method arguments in documentation

This makes it obvious what the code blocks refer to in the
documentation.

See #75, rubygems/rubygems#786