Tidy up the markup. Only describe the new, post-2.0 behavior. Added the RETURN VALUES and ERRORS sections.
PR: 46365 Submitted by: gioria (original version) OK'ed by: alfred (older version)