- I clarified in the docs that CURLOPT_SEEKFUNCTION should return 0 on success

  and 1 on fatal errors. Previously it only mentioned non-zero on fatal
  errors. This is a slight change in meaning, but it follows what we've done
  elsewhere before and it opens up for LOTS of more useful return codes
  whenever we can think of them...

diff --git a/CHANGES b/CHANGES
index 5ce29473af3593429e9e119d19f52409806c1a2a..9e46861d148e59b5687c7925b31ca790d9afc105 100644 (file)
--- a/CHANGES
+++ b/CHANGES
@@ -7,6 +7,13 @@
                                   Changelog
 
 
+Daniel Stenberg (6 Apr 2009)
+- I clarified in the docs that CURLOPT_SEEKFUNCTION should return 0 on success
+  and 1 on fatal errors. Previously it only mentioned non-zero on fatal
+  errors. This is a slight change in meaning, but it follows what we've done
+  elsewhere before and it opens up for LOTS of more useful return codes
+  whenever we can think of them...
+
 Yang Tse (2 Apr 2009)
 - Fix curl_off_t definition for builds done using Sun compilers and a
   non-configured libcurl. In this case curl_off_t data type was gated

diff --git a/docs/libcurl/curl_easy_setopt.3 b/docs/libcurl/curl_easy_setopt.3
index 9599b65e6b2588982492dffafff1822545c6dad8..9de7ab6516df7cd35b78cf7efc7b53f66e1838b1 100644 (file)
--- a/docs/libcurl/curl_easy_setopt.3
+++ b/docs/libcurl/curl_easy_setopt.3
@@ -208,9 +208,10 @@ currently only one value is supported: \fICURLSOCKTYPE_IPCXN\fP for the
 primary connection (meaning the control connection in the FTP case). Future
 versions of libcurl may support more purposes. It passes the newly created
 socket descriptor so additional setsockopt() calls can be done at the user's
-discretion.  A non-zero return code from the callback function will signal an
-unrecoverable error to the library and it will close the socket and return
-\fICURLE_COULDNT_CONNECT\fP.  (Option added in 7.15.6.)
+discretion.  Return 0 (zero) from the callback on success. Return 1 from the
+callback function to signal an unrecoverable error to the library and it will
+close the socket and return \fICURLE_COULDNT_CONNECT\fP.  (Option added in
+7.15.6.)
 .IP CURLOPT_SOCKOPTDATA
 Pass a pointer that will be untouched by libcurl and passed as the first
 argument in the sockopt callback set with \fICURLOPT_SOCKOPTFUNCTION\fP.