From d5bfec70af0d53eed164c9fdec142ebe8fe5c81d Mon Sep 17 00:00:00 2001 From: Daniel Stenberg Date: Mon, 22 Dec 2008 13:07:13 +0000 Subject: [PATCH] - Anthony Bryan provided a set of patches that cleaned up manual language, corrected spellings and more. --- CHANGES | 5 +++ RELEASE-NOTES | 3 +- docs/curl-config.1 | 8 ++-- docs/curl.1 | 92 +++++++++++++++++++++--------------------- docs/libcurl/libcurl.3 | 10 ++--- lib/ssh.h | 6 +++ 6 files changed, 68 insertions(+), 56 deletions(-) diff --git a/CHANGES b/CHANGES index d5eebe13d..bd7434089 100644 --- a/CHANGES +++ b/CHANGES @@ -6,6 +6,11 @@ Changelog +Daniel Stenberg (22 Dec 2008) + +- Anthony Bryan provided a set of patches that cleaned up manual language, + corrected spellings and more. + Daniel Stenberg (20 Dec 2008) - Igor Novoseltsev fixed a bad situation for the multi_socket() API when doing pipelining, as libcurl could then easily get confused and A) work on the diff --git a/RELEASE-NOTES b/RELEASE-NOTES index 40dad0977..fff8f41a8 100644 --- a/RELEASE-NOTES +++ b/RELEASE-NOTES @@ -47,6 +47,7 @@ advice from friends like these: Yang Tse, Daniel Fandrich, Jim Meyering, Christian Krause, Andreas Wurf, Markus Koetter, Josef Wolf, Vlad Grachov, Pawel Kierski, Igor Novoseltsev, - Fred Machado, Ken Hirsch, Keshav Krity, Patrick Monnerat, Mark Karpeles + Fred Machado, Ken Hirsch, Keshav Krity, Patrick Monnerat, Mark Karpeles, + Anthony Bryan Thanks! (and sorry if I forgot to mention someone) diff --git a/docs/curl-config.1 b/docs/curl-config.1 index a8acf901b..a116e6ea4 100644 --- a/docs/curl-config.1 +++ b/docs/curl-config.1 @@ -28,7 +28,7 @@ curl-config \- Get information about a libcurl installation .B curl-config [options] .SH DESCRIPTION .B curl-config -displays information about a previous curl and libcurl installation. +displays information about the curl and libcurl installation. .SH OPTIONS .IP "--ca" Displays the built-in path to the CA cert bundle this libcurl uses. @@ -36,7 +36,7 @@ Displays the built-in path to the CA cert bundle this libcurl uses. Displays the compiler used to build libcurl. .IP "--cflags" Set of compiler options (CFLAGS) to use when compiling files that use -libcurl. Currently that is only thw include path to the curl include files. +libcurl. Currently that is only the include path to the curl include files. .IP "--checkfor [version]" Specify the oldest possible libcurl version string you want, and this script will return 0 if the current installation is new enough or it @@ -46,7 +46,7 @@ enough. (Added in 7.15.4) Lists what particular main features the installed libcurl was built with. At the time of writing, this list may include SSL, KRB4 or IPv6. Do not assume any particular order. The keywords will be separated by newlines. There may be -none, one or several keywords in the list. +none, one, or several keywords in the list. .IP "--help" Displays the available options. .IP "--libs" @@ -61,7 +61,7 @@ Lists what particular protocols the installed libcurl was built to support. At the time of writing, this list may include HTTP, HTTPS, FTP, FTPS, FILE, TELNET, LDAP, DICT. Do not assume any particular order. The protocols will be listed using uppercase and are separated by newlines. There may be none, -one or several protocols in the list. (Added in 7.13.0) +one, or several protocols in the list. (Added in 7.13.0) .IP "--static-libs" Shows the complete set of libs and other linker options you will need in order to link your application with libcurl statically. (Added in 7.17.1) diff --git a/docs/curl.1 b/docs/curl.1 index 9cc1ed7bd..cd9dba9d2 100644 --- a/docs/curl.1 +++ b/docs/curl.1 @@ -135,7 +135,7 @@ Pass the data to the HTTP server as a cookie. It is supposedly the data previously received from the server in a "Set-Cookie:" line. The data should be in the format "NAME1=VALUE1; NAME2=VALUE2". -If no '=' letter is used in the line, it is treated as a filename to use to +If no '=' symbol is used in the line, it is treated as a filename to use to read previously stored cookie lines from, which should be used in this session if they match. Using this method also activates the "cookie parser" which will make curl record incoming cookies too, which may be handy if you're using this @@ -197,7 +197,7 @@ If this option is used several times, the last specified file name will be used. .IP "-C/--continue-at " Continue/Resume a previous file transfer at the given offset. The given offset -is the exact number of bytes that will be skipped counted from the beginning +is the exact number of bytes that will be skipped, counting from the beginning of the source file before it is transferred to the destination. If used with uploads, the FTP server command SIZE will not be used by curl. @@ -228,7 +228,7 @@ of a form field you may use \fI--data-urlencode\fP. If any of these options is used more than once on the same command line, the data pieces specified will be merged together with a separating -&-letter. Thus, using '-d name=daniel -d skill=lousy' would generate a post +&-symbol. Thus, using '-d name=daniel -d skill=lousy' would generate a post chunk that looks like \&'name=daniel&skill=lousy'. If you start the data with the letter @, the rest should be a file name to @@ -256,11 +256,11 @@ curl using one of the following syntaxes: .RS .IP "content" This will make curl URL-encode the content and pass that on. Just be careful -so that the content doesn't contain any = or @ letters, as that will then make +so that the content doesn't contain any = or @ symbols, as that will then make the syntax match one of the other cases below! .IP "=content" This will make curl URL-encode the content and pass that on. The preceding = -letter is not included in the data. +symbol is not included in the data. .IP "name=content" This will make curl URL-encode the content part and pass that on. Note that the name part is expected to be URL-encoded already. @@ -286,8 +286,8 @@ difference. (FTP) Tell curl to disable the use of the EPRT and LPRT commands when doing active FTP transfers. Curl will normally always first attempt to use EPRT, then LPRT before using PORT, but with this option, it will use PORT right -away. EPRT and LPRT are extensions to the original FTP protocol, may not work -on all servers but enable more functionality in a better way than the +away. EPRT and LPRT are extensions to the original FTP protocol, and may not work +on all servers, but they enable more functionality in a better way than the traditional PORT command. Since curl 7.19.0, \fB--eprt\fP can be used to explicitly enable EPRT again @@ -326,7 +326,7 @@ engines. Note that not all (or none) of the engines may be available at run-time. .IP "--environment" (RISC OS ONLY) Sets a range of environment variables, using the names the -w -option supports, to easier allow extraction of useful information after having +option supports, to allow easier extraction of useful information after having run curl. .IP "--egd-file " (SSL) Specify the path name to the Entropy Gathering Daemon socket. The socket @@ -473,7 +473,7 @@ submit button. This causes curl to POST data using the Content-Type multipart/form-data according to RFC1867. This enables uploading of binary files etc. To force the 'content' part to be a file, prefix the file name with an @ sign. To just get the content part from a file, prefix the file name -with the letter <. The difference between @ and < is then that @ makes a file +with the symbol <. The difference between @ and < is then that @ makes a file get attached in the post as a file upload, while the < makes a text field and just get the contents for that text field from a file. @@ -732,7 +732,7 @@ re-send the following request using the same unmodified method. .IP "--location-trusted" (HTTP/HTTPS) Like \fI-L/--location\fP, but will allow sending the name + password to all hosts that the site may redirect to. This may or may not -introduce a security breach if the site redirects you do a site to which +introduce a security breach if the site redirects you to a site to which you'll send your authentication info (which is plaintext in the case of HTTP Basic authentication). @@ -776,7 +776,7 @@ Very similar to \fI--netrc\fP, but this option makes the .netrc usage (HTTP) Enables GSS-Negotiate authentication. The GSS-Negotiate method was designed by Microsoft and is used in their web applications. It is primarily meant as a support for Kerberos5 authentication but may be also used along -with another authentication methods. For more information see IETF draft +with another authentication method. For more information see IETF draft draft-brezak-spnego-http-04.txt. If you want to enable Negotiate for your proxy authentication, then use @@ -1201,7 +1201,7 @@ received by curl that is hidden in normal cases, and a line starting with '*' means additional info provided by curl. Note that if you only want HTTP headers in the output, \fI-i/--include\fP -might be option you're looking for. +might be the option you're looking for. If you think this option still doesn't give you enough details, consider using \fI--trace\fP or \fI--trace-ascii\fP instead. @@ -1255,12 +1255,12 @@ format from stdin you write "@-". The variables present in the output format will be substituted by the value or text that curl thinks fit, as described below. All variables are specified -as %{variable_name} and to output a normal % you just it them as +as %{variable_name} and to output a normal % you just write them as %%. You can output a newline by using \\n, a carriage return with \\r and a tab space with \\t. .B NOTE: -The %-letter is a special letter in the win32-environment, where all +The %-symbol is a special symbol in the win32-environment, where all occurrences of % must be doubled when using this option. The variables available at this point are: @@ -1456,7 +1456,7 @@ Sets the proxy server to use if no protocol-specific proxy is set. list of host names that shouldn't go through any proxy. If set to a asterisk \&'*' only, it matches all hosts. .SH EXIT CODES -There exists a bunch of different error codes and their corresponding error +There are a bunch of different error codes and their corresponding error messages that may appear during bad conditions. At the time of this writing, the exit codes are: .IP 1 @@ -1464,7 +1464,7 @@ Unsupported protocol. This build of curl has no support for this protocol. .IP 2 Failed to initialize. .IP 3 -URL malformat. The syntax was not correct. +URL malformed. The syntax was not correct. .IP 5 Couldn't resolve proxy. The given proxy host could not be resolved. .IP 6 @@ -1545,67 +1545,67 @@ Unknown TELNET option specified. .IP 49 Malformed telnet option. .IP 51 -The peer's SSL certificate or SSH MD5 fingerprint was not ok +The peer's SSL certificate or SSH MD5 fingerprint was not ok. .IP 52 The server didn't reply anything, which here is considered an error. .IP 53 -SSL crypto engine not found +SSL crypto engine not found. .IP 54 -Cannot set SSL crypto engine as default +Cannot set SSL crypto engine as default. .IP 55 -Failed sending network data +Failed sending network data. .IP 56 -Failure in receiving network data +Failure in receiving network data. .IP 58 -Problem with the local certificate +Problem with the local certificate. .IP 59 -Couldn't use specified SSL cipher +Couldn't use specified SSL cipher. .IP 60 -Peer certificate cannot be authenticated with known CA certificates +Peer certificate cannot be authenticated with known CA certificates. .IP 61 -Unrecognized transfer encoding +Unrecognized transfer encoding. .IP 62 -Invalid LDAP URL +Invalid LDAP URL. .IP 63 -Maximum file size exceeded +Maximum file size exceeded. .IP 64 -Requested FTP SSL level failed +Requested FTP SSL level failed. .IP 65 -Sending the data requires a rewind that failed +Sending the data requires a rewind that failed. .IP 66 -Failed to initialise SSL Engine +Failed to initialise SSL Engine. .IP 67 -The user name, password, or similar was not accepted and curl failed to log in +The user name, password, or similar was not accepted and curl failed to log in. .IP 68 -File not found on TFTP server +File not found on TFTP server. .IP 69 -Permission problem on TFTP server +Permission problem on TFTP server. .IP 70 -Out of disk space on TFTP server +Out of disk space on TFTP server. .IP 71 -Illegal TFTP operation +Illegal TFTP operation. .IP 72 -Unknown TFTP transfer ID +Unknown TFTP transfer ID. .IP 73 -File already exists (TFTP) +File already exists (TFTP). .IP 74 -No such user (TFTP) +No such user (TFTP). .IP 75 -Character conversion failed +Character conversion failed. .IP 76 -Character conversion functions required +Character conversion functions required. .IP 77 -Problem with reading the SSL CA cert (path? access rights?) +Problem with reading the SSL CA cert (path? access rights?). .IP 78 -The resource referenced in the URL does not exist +The resource referenced in the URL does not exist. .IP 79 -An unspecified error occurred during the SSH session +An unspecified error occurred during the SSH session. .IP 80 -Failed to shut down the SSL connection +Failed to shut down the SSL connection. .IP 82 -Could not load CRL file, missing or wrong format (added in 7.19.0) +Could not load CRL file, missing or wrong format (added in 7.19.0). .IP 83 -Issuer check failed (added in 7.19.0) +Issuer check failed (added in 7.19.0). .IP XX More error codes will appear here in future releases. The existing ones are meant to never change. diff --git a/docs/libcurl/libcurl.3 b/docs/libcurl/libcurl.3 index 9c48f7405..fb33a5e14 100644 --- a/docs/libcurl/libcurl.3 +++ b/docs/libcurl/libcurl.3 @@ -4,7 +4,7 @@ .SH NAME libcurl \- client-side URL transfers .SH DESCRIPTION -This is an short overview on how to use libcurl in your C programs. There are +This is a short overview on how to use libcurl in your C programs. There are specific man pages for each function mentioned in here. There are also the \fIlibcurl-easy(3)\fP man page, the \fIlibcurl-multi(3)\fP man page, the \fIlibcurl-share(3)\fP man page and the \fIlibcurl-tutorial(3)\fP man page for @@ -25,14 +25,14 @@ the option of using the "easy" interface, or the "multi" interface. The easy interface is a synchronous interface with which you call \fIcurl_easy_perform(3)\fP and let it perform the transfer. When it is -completed, the function return and you can continue. More details are found in +completed, the function returns and you can continue. More details are found in the \fIlibcurl-easy(3)\fP man page. The multi interface on the other hand is an asynchronous interface, that you call and that performs only a little piece of the transfer on each invoke. It is perfect if you want to do things while the transfer is in progress, or similar. The multi interface allows you to select() on libcurl action, and -even to easily download multiple files simultaneously using a single thread. See further deails in the \fIlibcurl-multi(3)\fP man page. +even to easily download multiple files simultaneously using a single thread. See further details in the \fIlibcurl-multi(3)\fP man page. You can have multiple easy handles share certain data, even if they are used in different threads. This magic is setup using the share interface, as @@ -106,7 +106,7 @@ do as many of your file transfers as possible using the same curl handle. When you call \fIcurl_easy_cleanup(3)\fP, all the possibly open connections held by libcurl will be closed and forgotten. -Note that the options set with \fIcurl_easy_setopt(3)\fP will be used in on +Note that the options set with \fIcurl_easy_setopt(3)\fP will be used on every repeated \fIcurl_easy_perform(3)\fP call. .SH "GLOBAL CONSTANTS" @@ -161,7 +161,7 @@ and has a place to call the libcurl functions. Note that if multiple modules in the program use libcurl, they all will separately call the libcurl functions, and that's OK because only the first \fIcurl_global_init()\fP and the last \fIcurl_global_cleanup()\fP in a -program changes anything. (libcurl uses a reference count in static +program change anything. (libcurl uses a reference count in static memory). In a C++ module, it is common to deal with the global constant diff --git a/lib/ssh.h b/lib/ssh.h index a8a9f5267..c271a06af 100644 --- a/lib/ssh.h +++ b/lib/ssh.h @@ -30,9 +30,15 @@ #endif #if (LIBSSH2_VERSION_NUM >= 0x001300) +/* libssh2 0.19 was the planned release version for a while before it was + decided to instead become 1.0. Thus >= 0x001300 should still work fine + for snapshots done during the 0.19 days as well as things released once + it was bumped to 1.0 */ # define HAVE_LIBSSH2_SESSION_BLOCK_DIRECTIONS 1 +# define HAVE_LIBSSH2_SFTP_SEEK2 1 #else # undef HAVE_LIBSSH2_SESSION_BLOCK_DIRECTIONS +# undef HAVE_LIBSSH2_SFTP_SEEK2 1 #endif extern const struct Curl_handler Curl_handler_scp;