... and delete trailing whitespace

Fixes #1484

clang 5.0 complains:
possible misuse of comma operator here [-Wcomma]

... using the docs/cmdline-opts/gen.pl script, so that we get all the
command line option documentation from the same source.

The generation of the list has to be done manually and pasted into the
source code.

Closes #1465

... to also make it update when we remove files, like we did for
--environment in commit a8e388dd.

The first argument to select is an int, while curl_socket_t is
unsigned long long when using WinSock. It's ignored anyway [1].

[1] https://msdn.microsoft.com/en-us/library/windows/desktop/ms740141.aspx

...to render properly nroff.

... and USE_ENVIRONMENT and --environment. It was once added for RISC OS
support and its platform specific behavior has been annoying ever
since. Added in commit c3c8bbd3, mostly unchanged since
then. Most probably not actually used for years.

Closes #1463

The definition of TRUE was introduced in
4a728747 and is not used anymore since
e664cd58.
The usage of intptr_t was removed in
32e38b8f.

This fixes missing-variable-declarations warnings when building with
clang.

Commit 80a87e8a broke 'make dist' as it can't handle installing from
absolute target names. Rearranged the dependencies so the absolute name
is used for building but the relative name is use for distributing.

Uploads data to an FTP site, directly from memory.

Closes #1451

The module contains a more comprehensive set of trust information than
supported by nss-pem, because libnssckbi.so also includes information
about distrusted certificates.

Reviewed-by: Kai Engert
Closes #1414

$< is only allowed in implicit rules in some non-GNU makes (e.g. BSD,
AIX) so avoid use elsewhere by referencing the dependent curl.1 file
directly instead. This is somewhat tricky because the file is supplied
in the packaged tar ball (but not in git) but must still be able to be
rebuilt when its dependencies change. The right thing must happen in
both tar ball and git source trees, as well as in both in-tree and
out-of-tree builds.

Reported-by: Alex Bligh
Bug: https://curl.haxx.se/mail/lib-2017-04/0044.html

- Change documented param type to char ** from incorrect long *.

--without-ssl is needed instead of --with-winssl.

and mention specific issues where they are discussed

Closes #1382

Closes https://github.com/curl/curl/pull/1375

For some reason, CMake 2.8.12.2 did not expand the list argument in a
single DEPENDS argument. Remove the quotes, so it gets expanded into
multiple arguments for add_custom_command and add_custom_target.

Fixes https://github.com/curl/curl/issues/1370
Closes #1372