Browse Source

docs: remove use of the word 'very'

It is mostly superfluous. proselint would complain.

Closes #11818
Daniel Stenberg 8 months ago
parent
commit
945db0d958

+ 2 - 2
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.

+ 1 - 1
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",

+ 2 - 2
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 */

+ 2 - 2
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 */

+ 2 - 2
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 */

+ 2 - 2
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 */

+ 1 - 1
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 \"\" *");
 

+ 1 - 1
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);

+ 1 - 1
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);

+ 1 - 1
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);

+ 1 - 1
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);

+ 4 - 4
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    "<ursel@example.org>"
 #define SENDER_ADDR  "<kurt@example.org>"
@@ -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);
   }

+ 3 - 3
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);

+ 4 - 4
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    "<sender@example.org>"
 #define TO_ADDR      "<addressee@example.net>"
@@ -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);
   }

+ 3 - 3
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);
 

+ 1 - 1
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);

+ 3 - 2
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);
 

+ 3 - 3
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);

+ 2 - 2
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

+ 2 - 2
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

+ 2 - 2
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

+ 5 - 6
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],
 [

+ 4 - 4
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,