Attached for review.  The first patch conslidates the documentation of
all of _arguments' options in one place; that patch is 90% moving text
around and 10% minor text changes.  The second patch divides the long
help docstring into "subsections".