When an error has been detected, skip the final forced call to the
progress callback by making sure to pass the current return code
variable in the Curl_done() call in the CURLM_STATE_DONE state.

This avoids the "extra" callback that could occur even if you returned
error from the progress callback.

Bug: http://curl.haxx.se/mail/lib-2014-06/0062.html
Reported by: Jonathan Cardoso Machado

This prevents valgrind from reporting possibly lost memory that NSPR
uses for file descriptor cache and other globally allocated internal
data structures.

This feature was unintentionally disabled by commit ff92fcfb.

... due to calling SSL_VersionRangeGet() with NULL file descriptor

reported-by: upstream tests 305 and 404

mainly to improve how the web versions render

... by using the "\fIopt(3)\fP" syntax they will be linked properly when
the web version of the page is generated.

c-ares now does support IPv6;
avoid implying threaded resolver is Windows-only;
two referenced source files were renamed in 7de2f927

... to the always-copy-char *-argument.

And fix some minor mistakes.

With all the new individual option man pages created, this now refers to
each separate one instead of duplicaing the info. Also makes this page
easier to overview.

shorten descriptions, mostly refer to the separate descriptions

... and fixed mancheck to ignore obsolete options

Now all current options have their own man pages.

To be further discussed, debated and edited

This is consistent with the existing obsolete error code naming
convention.