From: Daniel Stenberg Date: Thu, 7 Sep 2023 17:53:49 +0000 (+0200) Subject: docs: remove use of the word 'very' X-Git-Tag: curl-8_3_0~19 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=945db0d958f171a5992e087c0ea64baeca62a005;p=thirdparty%2Fcurl.git docs: remove use of the word 'very' It is mostly superfluous. proselint would complain. Closes #11818 --- diff --git a/docs/cmdline-opts/http3.d b/docs/cmdline-opts/http3.d index 1f6326fce1..89aedd6894 100644 --- a/docs/cmdline-opts/http3.d +++ b/docs/cmdline-opts/http3.d @@ -21,7 +21,7 @@ This option allows a user to avoid using the Alt-Svc method of upgrading to HTTP/3 when you know that the target speaks HTTP/3 on the given host and port. When asked to use HTTP/3, curl will issue a separate attempt to use older HTTP -versions with a slight delay, so if the HTTP/3 transfer fails or is very slow, -curl will still try to proceed with an older HTTP version. +versions with a slight delay, so if the HTTP/3 transfer fails or is slow, curl +will still try to proceed with an older HTTP version. Use --http3-only for similar functionality *without* a fallback. diff --git a/docs/examples/cookie_interface.c b/docs/examples/cookie_interface.c index 131ef65429..557b57dc2e 100644 --- a/docs/examples/cookie_interface.c +++ b/docs/examples/cookie_interface.c @@ -98,7 +98,7 @@ main(void) snprintf(nline, sizeof(nline), "%s\t%s\t%s\t%s\t%.0f\t%s\t%s", ".example.com", "TRUE", "/", "FALSE", difftime(time(NULL) + 31337, (time_t)0), - "PREF", "hello example, i like you very much!"); + "PREF", "hello example, i like you!"); res = curl_easy_setopt(curl, CURLOPT_COOKIELIST, nline); if(res != CURLE_OK) { fprintf(stderr, "Curl curl_easy_setopt failed: %s\n", diff --git a/docs/examples/ephiperfifo.c b/docs/examples/ephiperfifo.c index f0ee0a1be5..0ce68de5dd 100644 --- a/docs/examples/ephiperfifo.c +++ b/docs/examples/ephiperfifo.c @@ -386,8 +386,8 @@ static void new_conn(char *url, GlobalInfo *g) rc = curl_multi_add_handle(g->multi, conn->easy); mcode_or_die("new_conn: curl_multi_add_handle", rc); - /* note that the add_handle() will set a time-out to trigger very soon so - that the necessary socket_action() call will be called by this app */ + /* note that the add_handle() will set a time-out to trigger soon so that + the necessary socket_action() call will be called by this app */ } /* This gets called whenever data is received from the fifo */ diff --git a/docs/examples/evhiperfifo.c b/docs/examples/evhiperfifo.c index 2a361b94a1..17bff2b65a 100644 --- a/docs/examples/evhiperfifo.c +++ b/docs/examples/evhiperfifo.c @@ -364,8 +364,8 @@ static void new_conn(char *url, GlobalInfo *g) rc = curl_multi_add_handle(g->multi, conn->easy); mcode_or_die("new_conn: curl_multi_add_handle", rc); - /* note that the add_handle() will set a time-out to trigger very soon so - that the necessary socket_action() call will be called by this app */ + /* note that the add_handle() will set a time-out to trigger soon so that + the necessary socket_action() call will be called by this app */ } /* This gets called whenever data is received from the fifo */ diff --git a/docs/examples/ghiper.c b/docs/examples/ghiper.c index b30afd1609..5a4f4a7057 100644 --- a/docs/examples/ghiper.c +++ b/docs/examples/ghiper.c @@ -323,8 +323,8 @@ static void new_conn(char *url, GlobalInfo *g) rc = curl_multi_add_handle(g->multi, conn->easy); mcode_or_die("new_conn: curl_multi_add_handle", rc); - /* note that the add_handle() will set a time-out to trigger very soon so - that the necessary socket_action() call will be called by this app */ + /* note that the add_handle() will set a time-out to trigger soon so that + the necessary socket_action() call will be called by this app */ } /* This gets called by glib whenever data is received from the fifo */ diff --git a/docs/examples/hiperfifo.c b/docs/examples/hiperfifo.c index 06cb13878b..9fba341bb6 100644 --- a/docs/examples/hiperfifo.c +++ b/docs/examples/hiperfifo.c @@ -358,8 +358,8 @@ static void new_conn(char *url, GlobalInfo *g) rc = curl_multi_add_handle(g->multi, conn->easy); mcode_or_die("new_conn: curl_multi_add_handle", rc); - /* note that the add_handle() will set a time-out to trigger very soon so - that the necessary socket_action() call will be called by this app */ + /* note that the add_handle() will set a time-out to trigger soon so that + the necessary socket_action() call will be called by this app */ } /* This gets called whenever data is received from the fifo */ diff --git a/docs/examples/imap-lsub.c b/docs/examples/imap-lsub.c index 9cb87fe9a3..cf45a5fc2d 100644 --- a/docs/examples/imap-lsub.c +++ b/docs/examples/imap-lsub.c @@ -50,7 +50,7 @@ int main(void) /* This is just the server URL */ curl_easy_setopt(curl, CURLOPT_URL, "imap://imap.example.com"); - /* Set the LSUB command. Note the syntax is very similar to that of a LIST + /* Set the LSUB command. Note the syntax is similar to that of a LIST command. */ curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "LSUB \"\" *"); diff --git a/docs/examples/imap-ssl.c b/docs/examples/imap-ssl.c index 51d2d1d913..e920720c01 100644 --- a/docs/examples/imap-ssl.c +++ b/docs/examples/imap-ssl.c @@ -73,7 +73,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L); #endif - /* Since the traffic will be encrypted, it is very useful to turn on debug + /* Since the traffic will be encrypted, it is useful to turn on debug * information within libcurl to see what is happening during the * transfer */ curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L); diff --git a/docs/examples/imap-tls.c b/docs/examples/imap-tls.c index 5a47e4de20..d98f5ef9f9 100644 --- a/docs/examples/imap-tls.c +++ b/docs/examples/imap-tls.c @@ -73,7 +73,7 @@ int main(void) * for more information. */ curl_easy_setopt(curl, CURLOPT_CAINFO, "/path/to/certificate.pem"); - /* Since the traffic will be encrypted, it is very useful to turn on debug + /* Since the traffic will be encrypted, it is useful to turn on debug * information within libcurl to see what is happening during the * transfer */ curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L); diff --git a/docs/examples/pop3-ssl.c b/docs/examples/pop3-ssl.c index b9a758833e..e72cf6f38d 100644 --- a/docs/examples/pop3-ssl.c +++ b/docs/examples/pop3-ssl.c @@ -72,7 +72,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L); #endif - /* Since the traffic will be encrypted, it is very useful to turn on debug + /* Since the traffic will be encrypted, it is useful to turn on debug * information within libcurl to see what is happening during the * transfer */ curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L); diff --git a/docs/examples/pop3-tls.c b/docs/examples/pop3-tls.c index 976ce4ab2e..04e6e3b71f 100644 --- a/docs/examples/pop3-tls.c +++ b/docs/examples/pop3-tls.c @@ -72,7 +72,7 @@ int main(void) * for more information. */ curl_easy_setopt(curl, CURLOPT_CAINFO, "/path/to/certificate.pem"); - /* Since the traffic will be encrypted, it is very useful to turn on debug + /* Since the traffic will be encrypted, it is useful to turn on debug * information within libcurl to see what is happening during the * transfer */ curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L); diff --git a/docs/examples/smtp-authzid.c b/docs/examples/smtp-authzid.c index f13d6113d3..dc24d7f4d5 100644 --- a/docs/examples/smtp-authzid.c +++ b/docs/examples/smtp-authzid.c @@ -39,7 +39,7 @@ */ /* The libcurl options want plain addresses, the viewable headers in the mail - * can very well get a full name as well. + * can get a full name as well. */ #define FROM_ADDR "" #define SENDER_ADDR "" @@ -151,9 +151,9 @@ int main(void) * should be able to reuse this connection for additional messages * (setting CURLOPT_MAIL_FROM and CURLOPT_MAIL_RCPT as required, and * calling curl_easy_perform() again. It may not be a good idea to keep - * the connection open for a very long time though (more than a few - * minutes may result in the server timing out the connection), and you do - * want to clean up in the end. + * the connection open for a long time though (more than a few minutes may + * result in the server timing out the connection), and you do want to + * clean up in the end. */ curl_easy_cleanup(curl); } diff --git a/docs/examples/smtp-expn.c b/docs/examples/smtp-expn.c index 6d896d42dd..e61b6b4eee 100644 --- a/docs/examples/smtp-expn.c +++ b/docs/examples/smtp-expn.c @@ -69,9 +69,9 @@ int main(void) curl_slist_free_all(recipients); /* curl will not send the QUIT command until you call cleanup, so you - * should be able to reuse this connection for additional requests. It - * may not be a good idea to keep the connection open for a very long time - * though (more than a few minutes may result in the server timing out the + * should be able to reuse this connection for additional requests. It may + * not be a good idea to keep the connection open for a long time though + * (more than a few minutes may result in the server timing out the * connection) and you do want to clean up in the end. */ curl_easy_cleanup(curl); diff --git a/docs/examples/smtp-mail.c b/docs/examples/smtp-mail.c index 1ad178b9f0..742787824f 100644 --- a/docs/examples/smtp-mail.c +++ b/docs/examples/smtp-mail.c @@ -36,7 +36,7 @@ */ /* The libcurl options want plain addresses, the viewable headers in the mail - * can very well get a full name as well. + * can get a full name as well. */ #define FROM_ADDR "" #define TO_ADDR "" @@ -139,9 +139,9 @@ int main(void) * should be able to reuse this connection for additional messages * (setting CURLOPT_MAIL_FROM and CURLOPT_MAIL_RCPT as required, and * calling curl_easy_perform() again. It may not be a good idea to keep - * the connection open for a very long time though (more than a few - * minutes may result in the server timing out the connection), and you do - * want to clean up in the end. + * the connection open for a long time though (more than a few minutes may + * result in the server timing out the connection), and you do want to + * clean up in the end. */ curl_easy_cleanup(curl); } diff --git a/docs/examples/smtp-mime.c b/docs/examples/smtp-mime.c index 9c46fe901c..36703a1d82 100644 --- a/docs/examples/smtp-mime.c +++ b/docs/examples/smtp-mime.c @@ -154,9 +154,9 @@ int main(void) * should be able to reuse this connection for additional messages * (setting CURLOPT_MAIL_FROM and CURLOPT_MAIL_RCPT as required, and * calling curl_easy_perform() again. It may not be a good idea to keep - * the connection open for a very long time though (more than a few - * minutes may result in the server timing out the connection), and you do - * want to clean up in the end. + * the connection open for a long time though (more than a few minutes may + * result in the server timing out the connection), and you do want to + * clean up in the end. */ curl_easy_cleanup(curl); diff --git a/docs/examples/smtp-ssl.c b/docs/examples/smtp-ssl.c index 1c099a4354..89708408d7 100644 --- a/docs/examples/smtp-ssl.c +++ b/docs/examples/smtp-ssl.c @@ -146,7 +146,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_READDATA, &upload_ctx); curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L); - /* Since the traffic will be encrypted, it is very useful to turn on debug + /* Since the traffic will be encrypted, it is useful to turn on debug * information within libcurl to see what is happening during the * transfer */ curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L); diff --git a/docs/examples/smtp-tls.c b/docs/examples/smtp-tls.c index a3564912a9..83aab69cbb 100644 --- a/docs/examples/smtp-tls.c +++ b/docs/examples/smtp-tls.c @@ -148,8 +148,9 @@ int main(void) curl_easy_setopt(curl, CURLOPT_READDATA, &upload_ctx); curl_easy_setopt(curl, CURLOPT_UPLOAD, 1L); - /* Since the traffic will be encrypted, it is very useful to turn on debug - * information within libcurl to see what is happening during the transfer. + /* Since the traffic will be encrypted, it is useful to turn on debug + * information within libcurl to see what is happening during the + * transfer. */ curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L); diff --git a/docs/examples/smtp-vrfy.c b/docs/examples/smtp-vrfy.c index 4396e0fdb8..70da41b065 100644 --- a/docs/examples/smtp-vrfy.c +++ b/docs/examples/smtp-vrfy.c @@ -69,9 +69,9 @@ int main(void) curl_slist_free_all(recipients); /* curl will not send the QUIT command until you call cleanup, so you - * should be able to reuse this connection for additional requests. It - * may not be a good idea to keep the connection open for a very long time - * though (more than a few minutes may result in the server timing out the + * should be able to reuse this connection for additional requests. It may + * not be a good idea to keep the connection open for a long time though + * (more than a few minutes may result in the server timing out the * connection) and you do want to clean up in the end. */ curl_easy_cleanup(curl); diff --git a/docs/examples/synctime.c b/docs/examples/synctime.c index 1c0579a08b..fcf25d9411 100644 --- a/docs/examples/synctime.c +++ b/docs/examples/synctime.c @@ -41,7 +41,7 @@ * * Synchronising your computer clock via Internet time server usually relies * on DAYTIME, TIME, or NTP protocols. These protocols provide good accurate - * time synchronization but it does not work very well through a + * time synchronization but it does not work well through a * firewall/proxy. Some adjustment has to be made to the firewall/proxy for * these protocols to work properly. * @@ -54,7 +54,7 @@ * 2. Webserver system time must in sync with the NTP time server, * or at least provide an accurate time keeping. * 3. Webserver HTTP header does not provide the milliseconds units, - * so there is no way to get very accurate time. + * so there is no way to get an accurate time. * 4. This software could only provide an accuracy of +- a few seconds, * as Round-Trip delay time is not taken into consideration. * Compensation of network, firewall/proxy delay cannot be simply divide diff --git a/docs/libcurl/curl_easy_escape.3 b/docs/libcurl/curl_easy_escape.3 index 55a0eaa3ef..cbae642dd5 100644 --- a/docs/libcurl/curl_easy_escape.3 +++ b/docs/libcurl/curl_easy_escape.3 @@ -42,8 +42,8 @@ the input \fIstring\fP to find out the size. This function does not accept input strings longer than \fBCURL_MAX_INPUT_LENGTH\fP (8 MB). Since 7.82.0, the \fBcurl\fP parameter is ignored. Prior to that there was -per-handle character conversion support for some very old operating systems -such as TPF, but it was otherwise ignored. +per-handle character conversion support for some old operating systems such as +TPF, but it was otherwise ignored. You must \fIcurl_free(3)\fP the returned string when you are done with it. .SH ENCODING diff --git a/docs/libcurl/curl_easy_unescape.3 b/docs/libcurl/curl_easy_unescape.3 index 9be1a95454..e948a9f303 100644 --- a/docs/libcurl/curl_easy_unescape.3 +++ b/docs/libcurl/curl_easy_unescape.3 @@ -48,8 +48,8 @@ only return a value up to \fIINT_MAX\fP so no longer string can be returned in this parameter. Since 7.82.0, the \fBcurl\fP parameter is ignored. Prior to that there was -per-handle character conversion support for some very old operating systems -such as TPF, but it was otherwise ignored. +per-handle character conversion support for some old operating systems such as +TPF, but it was otherwise ignored. You must \fIcurl_free(3)\fP the returned string when you are done with it. .SH EXAMPLE diff --git a/docs/libcurl/libcurl.m4 b/docs/libcurl/libcurl.m4 index 2e215222cc..e4a518b5ce 100644 --- a/docs/libcurl/libcurl.m4 +++ b/docs/libcurl/libcurl.m4 @@ -51,12 +51,11 @@ # Users may override the detected values by doing something like: # LIBCURL="-lcurl" LIBCURL_CPPFLAGS="-I/usr/myinclude" ./configure # -# For the sake of sanity, this macro assumes that any libcurl that is -# found is after version 7.7.2, the first version that included the -# curl-config script. Note that it is very important for people -# packaging binary versions of libcurl to include this script! -# Without curl-config, we can only guess what protocols are available, -# or use curl_version_info to figure it out at runtime. +# For the sake of sanity, this macro assumes that any libcurl that is found is +# after version 7.7.2, the first version that included the curl-config script. +# Note that it is important for people packaging binary versions of libcurl to +# include this script! Without curl-config, we can only guess what protocols +# are available, or use curl_version_info to figure it out at runtime. AC_DEFUN([LIBCURL_CHECK_CONFIG], [ diff --git a/docs/libcurl/symbols.pl b/docs/libcurl/symbols.pl index a92d4ec2e8..1105ae66b6 100755 --- a/docs/libcurl/symbols.pl +++ b/docs/libcurl/symbols.pl @@ -23,10 +23,10 @@ # ########################################################################### # -# Experience has shown that the symbols-in-versions file is very useful to -# applications that want to build with a wide range of libcurl versions. -# It is however easy to get it wrong and the source gets a bit messy with all -# the fixed numerical comparisons. +# Experience has shown that the symbols-in-versions file is useful to +# applications that want to build with a wide range of libcurl versions. It +# is however easy to get it wrong and the source gets a bit messy with all the +# fixed numerical comparisons. # # The point of this script is to provide an easy-to-use macro for libcurl- # using applications to do preprocessor checks for specific libcurl defines,