opts: added some DEFAULT and RETURN VALUE sections
curl_easy_setopt.3: fixed the error code for an unsupported option
opts: Fixed some typos
opts: Document the socket callback function parameters
nss: do not abort on connection failure

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

reported-by: upstream tests 305 and 404
nss: make the fallback to SSLv3 work again

This feature was unintentionally disabled by commit ff92fcfb.
tool: call PR_Cleanup() on exit if NSPR is used

This prevents valgrind from reporting possibly lost memory that NSPR
uses for file descriptor cache and other globally allocated internal
data structures.
opts: fixed some CURLOPT references so they get turned into links
progress callback: skip last callback update on errors

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
curl.1: minor language fix

Bug: http://curl.haxx.se/mail/archive-2014-07/0006.html
Document type of argument for CURLOPT_ADDRESS_SCOPE.
Document type of argument for CURLOPT_COPYPOSTFIELDS.
Document type of argument for CURLOPT_ERRORBUFFER.
Document type of argument for CURLOPT_FOLLOWLOCATION.
example: use correct type (long) for CURLOPT_FOLLOWLOCATION
tool: call PL_ArenaFinish() on exit if NSPR is used

This prevents valgrind from reporting still reachable memory allocated
by NSPR arenas (mainly the freelist).

Reported-by: Hubert Kario
tool: oops, forgot to include <plarenas.h>

... that contains the declaration of PL_ArenaFinish()
nss: let nss_{cache,load}_crl return CURLcode
nss: make crl_der allocated on heap

... and spell it as crl_der instead of crlDER
nss: fix a memory leak when CURLOPT_CRLFILE is used