Re: [CLI] Broken links on CLI site + PR

Looks like I sent this prematurely, discoverd a few more issues in the 
docs, so I created a patch to address some more broken links and 
deprecated method usage in the documentation.

This also (re-?)adds an overloaded method in HelpFormatter which was 
omitted when the newer implementation was created in the 
org.apache.commons.cli.help package. The overloaded method is a lot 
simpler to call, and it fixes a part of the documentation that was 
broken (because it was using the old syntax which will now work again).

I'm not sure if I fixed the broken links in the right way. It seems like 
the old links might have been meant to point at the latest release: 
javadocs/api-release, but as near as I can tell no versioned javadocs 
are published, so those links now all point at apidocs/ and seem to work.

PR is available on github: 
https://github.com/apache/commons-cli/pull/424/changes

Thanks,

  - Elric