Clean up std.getopt docs

After browsing the docs using ddox it is obvious that the standard of "one line short summary and the following lines for in depth descriptions" is not followed in phobos. This commit is mostly to see if such a fixes are wanted/accepted at all.
Merge pull request #1855 from jcd/std-getopt-docclean

Clean up std.getopt docs