Hi, this is another little documentation patch. I made it to explicit the curl behaviour when using the --capath option, which may be not very clear to the users (see Debian bug #628697 [0]). Let me know if there's something wrong with it (e.g. you don't like the wording, etc...).
Cheers [0] http://bugs.debian.org/628697 -- perl -E'$_=q;$/= @{[@_]};and s;\S+;<inidehG ordnasselA>;eg;say~~reverse'
>From f36f00d541664623ef0f589c037bc4eeba96d54c Mon Sep 17 00:00:00 2001 From: Alessandro Ghedini <[email protected]> Date: Sat, 17 Dec 2011 15:04:57 +0100 Subject: [PATCH] docs: improve description of the --capath option Document the possibility of providing multiple values using the ":" separator, and the fact that the default value will be ignored if the option is used. --- docs/curl.1 | 16 +++++++++------- 1 files changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/curl.1 b/docs/curl.1 index 052b1dd..661532b 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -434,13 +434,15 @@ may be loaded. If this option is used several times, the last one will be used. .IP "--capath <CA certificate directory>" (SSL) Tells curl to use the specified certificate directory to verify the -peer. The certificates must be in PEM format, and if curl is built against -OpenSSL, the directory must have been processed using the c_rehash utility -supplied with OpenSSL. Using \fI--capath\fP can allow OpenSSL-powered curl to -make SSL-connections much more efficiently than using \fI--cacert\fP if the -\fI--cacert\fP file contains many CA certificates. - -If this option is used several times, the last one will be used. +peer. Multiple paths can be provided by separating them with ":" (e.g. +"path1:path2:path3"). The certificates must be in PEM format, and if curl +is built against OpenSSL, the directory must have been processed using the +c_rehash utility supplied with OpenSSL. Using \fI--capath\fP can allow +OpenSSL-powered curl to make SSL-connections much more efficiently than +using \fI--cacert\fP if the \fI--cacert\fP file contains many CA certificates. + +If this option is set, the default capath value will be ignored, and if it +is used several times, the last one will be used. .IP "-f, --fail" (HTTP) Fail silently (no output at all) on server errors. This is mostly done to better enable scripts etc to better deal with failed attempts. In -- 1.7.7.3
------------------------------------------------------------------- List admin: http://cool.haxx.se/list/listinfo/curl-library Etiquette: http://curl.haxx.se/mail/etiquette.html
