cURL / Mailing Lists / curl-users / Single Mail

curl-users

man curl review

From: Anthony Bryan <anthonybryan_at_gmail.com>
Date: Mon, 6 Aug 2012 03:27:38 -0400

I'm going to send in a patch, but I had a couple questions first after
reading the man page again:

       -6, --ipv6
              If libcurl is capable of resolving an address to multiple IP
              versions (which it is if it is IPv6-capable), this option tells
              libcurl to resolve names to IPv6 addresses only. default sta‐
              tistics.

---should "default statistics." be at the end there?

If this option is used several times, the last one will be used. IP
"--data-ascii <data>" See \fI-d, --data\fP.

---looks like this should be like this so it formats correctly when
the man page is generated.

If this option is used several times, the last one will be used.

.IP "--data-ascii <data>" See \fI-d, --data\fP.

       --digest
              (HTTP) Enables HTTP Digest authentication. This is a authentica‐
              tion that prevents the password from being sent over the wire in
---"This is an authentication..." (method? scheme?)

             If this option is used several times, the following occurrences
              make no difference.
---"If this option is used several times, only the first one is used." ?

"an FTP" -> "a FTP"

--metalink
"hashe" -> "hash" doh!
--metalink & --include should be underlined

some commands show which protocol they concern at the beginning (HTTP)
etc, while others state in prose at the end ("This option is only for
SCP and SFTP transfers."):

       -I, --head
              (HTTP/FTP/FILE) Fetch the HTTP-header only!

       --hostpubmd5 <md5>
              Pass a string containing 32 hexadecimal digits. The string
              should be the 128 bit MD5 checksum of the remote host's public
              key, curl will refuse the connection with the host unless the
              md5sums match. This option is only for SCP and SFTP transfers.
              (Added in 7.17.1)

could we do this a uniform way? I like the protocol at the beginning myself.

              It means
              you need several entries if you want to provide address for the
              same host but different ports.
--- I think this should be "provide an address" if it should singular
address or "provide addresses" if this should be plurl

       -S, --show-error
              When used with -s it makes curl show an error message if it
              fails.
--- -s should be underlined

(( Anthony Bryan ... Metalink [ http://www.metalinker.org ]
  )) Easier, More Reliable, Self Healing Downloads

-------------------------------------------------------------------
List admin: http://cool.haxx.se/list/listinfo/curl-users
FAQ: http://curl.haxx.se/docs/faq.html
Etiquette: http://curl.haxx.se/mail/etiquette.html
Received on 2012-08-06