Fix documentation for Gem::Requirement

REFACTOR comments were added but not acted upon.  I have no idea what
they mean anymore, so they've been removed.

This restores documentation for Gem::Requirement as the REFACTOR
comments were not hidden in the comment for the method.

Also, restore Gem::Requirment documentation, it was hidden above
requires.