These two items are now actually implemented:

11.1 Content-Disposition
11.5 ftp wildcard download

... and GnuTLS connects are non-blocking, TFTP is better
integrated as a "real" protocol and RTSP is supported.

Since commit c2888604 by Jerome Vouillon

It's not quite fair to list TFTP is a "crappy" member of the
libcurl family so I removed its mentioning.

--proto tells curl to use the listed protocols for its initial
retrieval

--proto-redir tells curl to use the listed protocols after a
redirect

Also tweaked comments in certain examples using curl_multi_fdset().

curl_multi_timeout(3) is simply the wrong function to use
if you're using the multi_socket API and this document now
states this pretty clearly to help guiding users.

Test coverage included. Thanks to Massimo Callegari for the bug report

CURLOPT_HEADERFUNCTION and CURLOPT_WRITEFUNCTION more consistent

- SMTP falls back to RFC821 HELO when EHLO fails (and SSL is not required).
- Use of true local host name (i.e.: via gethostname()) when available, as default argument to SMTP HELO/EHLO.
- Test case 804 for HELO fallback.

  properly in angle brackets. Recipients provided with CURLOPT_MAIL_RCPT now
  get angle bracket wrapping automatically by libcurl unless the recipient
  starts with an angle bracket as then the app is assumed to deal with that
  properly on its own.

replaced tabs with spaces

  http://curl.haxx.se/mail/lib-2009-10/0024.html
  http://curl.haxx.se/bug/view.cgi?id=2944325

removed trailing whitespace

  (http://curl.haxx.se/bug/view.cgi?id=2951319)