diff options
Diffstat (limited to 'docs/examples')
56 files changed, 153 insertions, 152 deletions
diff --git a/docs/examples/README.md b/docs/examples/README.md index c83846566..78577f84f 100644 --- a/docs/examples/README.md +++ b/docs/examples/README.md @@ -16,14 +16,14 @@ Most examples should build fine using a command line like this: `curl-config --cc --cflags --libs` -o example example.c -Some compilers don't like having the arguments in this order but instead +Some compilers do not like having the arguments in this order but instead want you do reorganize them like: `curl-config --cc` -o example example.c `curl-config --cflags --libs` **Please** do not use the `curl.se` site as a test target for your libcurl applications/experiments. Even if some of the examples use that site -as a URL at some places, it doesn't mean that the URLs work or that we expect +as a URL at some places, it does not mean that the URLs work or that we expect you to actually torture our website with your tests! Thanks. ## Examples diff --git a/docs/examples/anyauthput.c b/docs/examples/anyauthput.c index 47b713a6c..cbb963390 100644 --- a/docs/examples/anyauthput.c +++ b/docs/examples/anyauthput.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -154,7 +154,7 @@ int main(int argc, char **argv) /* set user name and password for the authentication */ curl_easy_setopt(curl, CURLOPT_USERPWD, "user:password"); - /* Now run off and do what you've been told! */ + /* Now run off and do what you have been told! */ res = curl_easy_perform(curl); /* Check for errors */ if(res != CURLE_OK) diff --git a/docs/examples/chkspeed.c b/docs/examples/chkspeed.c index f9e6f13d6..bc5387d77 100644 --- a/docs/examples/chkspeed.c +++ b/docs/examples/chkspeed.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -156,7 +156,7 @@ int main(int argc, char *argv[]) /* send all data to this function */ curl_easy_setopt(curl_handle, CURLOPT_WRITEFUNCTION, WriteCallback); - /* some servers don't like requests that are made without a user-agent + /* some servers do not like requests that are made without a user-agent field, so we provide one */ curl_easy_setopt(curl_handle, CURLOPT_USERAGENT, "libcurl-speedchecker/" CHKSPEED_VERSION); @@ -206,7 +206,7 @@ int main(int argc, char *argv[]) /* cleanup curl stuff */ curl_easy_cleanup(curl_handle); - /* we're done with libcurl, so clean it up */ + /* we are done with libcurl, so clean it up */ curl_global_cleanup(); return 0; diff --git a/docs/examples/cookie_interface.c b/docs/examples/cookie_interface.c index fb76ae927..9168247cf 100644 --- a/docs/examples/cookie_interface.c +++ b/docs/examples/cookie_interface.c @@ -104,7 +104,7 @@ main(void) return 1; } - /* HTTP-header style cookie. If you use the Set-Cookie format and don't + /* HTTP-header style cookie. If you use the Set-Cookie format and do not specify a domain then the cookie is sent for any domain and will not be modified, likely not what you intended. Starting in 7.43.0 any-domain cookies will not be exported either. For more information refer to the diff --git a/docs/examples/curlgtk.c b/docs/examples/curlgtk.c index 51f4b458a..c14e4823e 100644 --- a/docs/examples/curlgtk.c +++ b/docs/examples/curlgtk.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (c) 2000 - 2020 David Odin (aka DindinX) for MandrakeSoft + * Copyright (c) 2000 - 2021 David Odin (aka DindinX) for MandrakeSoft */ /* <DESC> * use the libcurl in a gtk-threaded application @@ -96,7 +96,7 @@ int main(int argc, char **argv) gtk_widget_show_all(Window); if(!g_thread_create(&my_thread, argv[1], FALSE, NULL) != 0) - g_warning("can't create the thread"); + g_warning("cannot create the thread"); gdk_threads_enter(); gtk_main(); diff --git a/docs/examples/ephiperfifo.c b/docs/examples/ephiperfifo.c index 97e1fb5f0..af13169f3 100644 --- a/docs/examples/ephiperfifo.c +++ b/docs/examples/ephiperfifo.c @@ -224,7 +224,7 @@ static void timer_cb(GlobalInfo* g, int revents) err = read(g->tfd, &count, sizeof(uint64_t)); if(err == -1) { - /* Note that we may call the timer callback even if the timerfd isn't + /* Note that we may call the timer callback even if the timerfd is not * readable. It's possible that there are multiple events stored in the * epoll buffer (i.e. the timer may have fired multiple times). The * event count is cleared after the first call so future events in the @@ -503,7 +503,7 @@ int main(int argc, char **argv) curl_multi_setopt(g.multi, CURLMOPT_TIMERFUNCTION, multi_timer_cb); curl_multi_setopt(g.multi, CURLMOPT_TIMERDATA, &g); - /* we don't call any curl_multi_socket*() function yet as we have no handles + /* we do not call any curl_multi_socket*() function yet as we have no handles added! */ fprintf(MSG_OUT, "Entering wait loop\n"); diff --git a/docs/examples/evhiperfifo.c b/docs/examples/evhiperfifo.c index 5222f8d03..07cfada43 100644 --- a/docs/examples/evhiperfifo.c +++ b/docs/examples/evhiperfifo.c @@ -439,7 +439,7 @@ int main(int argc, char **argv) curl_multi_setopt(g.multi, CURLMOPT_TIMERFUNCTION, multi_timer_cb); curl_multi_setopt(g.multi, CURLMOPT_TIMERDATA, &g); - /* we don't call any curl_multi_socket*() function yet as we have no handles + /* we do not call any curl_multi_socket*() function yet as we have no handles added! */ ev_loop(g.loop, 0); diff --git a/docs/examples/fileupload.c b/docs/examples/fileupload.c index eb484e9c0..afea64316 100644 --- a/docs/examples/fileupload.c +++ b/docs/examples/fileupload.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -38,11 +38,11 @@ int main(void) fd = fopen("debugit", "rb"); /* open file to upload */ if(!fd) - return 1; /* can't continue */ + return 1; /* cannot continue */ /* to get the file size */ if(fstat(fileno(fd), &file_info) != 0) - return 1; /* can't continue */ + return 1; /* cannot continue */ curl = curl_easy_init(); if(curl) { diff --git a/docs/examples/fopen.c b/docs/examples/fopen.c index 932140e3e..02ab11905 100644 --- a/docs/examples/fopen.c +++ b/docs/examples/fopen.c @@ -135,7 +135,7 @@ static int fill_buffer(URL_FILE *file, size_t want) CURLMcode mc; /* curl_multi_fdset() return code */ /* only attempt to fill buffer if transactions still running and buffer - * doesn't exceed required size already + * does not exceed required size already */ if((!file->still_running) || (file->buffer_pos > want)) return 0; diff --git a/docs/examples/ftpget.c b/docs/examples/ftpget.c index 300a2821c..ad9a383e7 100644 --- a/docs/examples/ftpget.c +++ b/docs/examples/ftpget.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -40,7 +40,7 @@ static size_t my_fwrite(void *buffer, size_t size, size_t nmemb, void *stream) /* open file for writing */ out->stream = fopen(out->filename, "wb"); if(!out->stream) - return -1; /* failure, can't open file to write */ + return -1; /* failure, cannot open file to write */ } return fwrite(buffer, size, nmemb, out->stream); } diff --git a/docs/examples/ftpsget.c b/docs/examples/ftpsget.c index 44ae3ffae..9fcbceda8 100644 --- a/docs/examples/ftpsget.c +++ b/docs/examples/ftpsget.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -42,7 +42,7 @@ static size_t my_fwrite(void *buffer, size_t size, size_t nmemb, /* open file for writing */ out->stream = fopen(out->filename, "wb"); if(!out->stream) - return -1; /* failure, can't open file to write */ + return -1; /* failure, cannot open file to write */ } return fwrite(buffer, size, nmemb, out->stream); } diff --git a/docs/examples/ftpupload.c b/docs/examples/ftpupload.c index 7ed7634ae..1b7bbf26a 100644 --- a/docs/examples/ftpupload.c +++ b/docs/examples/ftpupload.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -119,7 +119,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, (curl_off_t)fsize); - /* Now run off and do what you've been told! */ + /* Now run off and do what you have been told! */ res = curl_easy_perform(curl); /* Check for errors */ if(res != CURLE_OK) diff --git a/docs/examples/getinmemory.c b/docs/examples/getinmemory.c index 120ceac3b..fcb97eab0 100644 --- a/docs/examples/getinmemory.c +++ b/docs/examples/getinmemory.c @@ -81,7 +81,7 @@ int main(void) /* we pass our 'chunk' struct to the callback function */ curl_easy_setopt(curl_handle, CURLOPT_WRITEDATA, (void *)&chunk); - /* some servers don't like requests that are made without a user-agent + /* some servers do not like requests that are made without a user-agent field, so we provide one */ curl_easy_setopt(curl_handle, CURLOPT_USERAGENT, "libcurl-agent/1.0"); @@ -109,7 +109,7 @@ int main(void) free(chunk.memory); - /* we're done with libcurl, so clean it up */ + /* we are done with libcurl, so clean it up */ curl_global_cleanup(); return 0; diff --git a/docs/examples/ghiper.c b/docs/examples/ghiper.c index d58adb1e6..9ebc056fd 100644 --- a/docs/examples/ghiper.c +++ b/docs/examples/ghiper.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -427,7 +427,7 @@ int main(int argc, char **argv) curl_multi_setopt(g->multi, CURLMOPT_TIMERFUNCTION, update_timeout_cb); curl_multi_setopt(g->multi, CURLMOPT_TIMERDATA, g); - /* we don't call any curl_multi_socket*() function yet as we have no handles + /* we do not call any curl_multi_socket*() function yet as we have no handles added! */ g_main_loop_run(gmain); diff --git a/docs/examples/hiperfifo.c b/docs/examples/hiperfifo.c index 6a41b309a..5af990071 100644 --- a/docs/examples/hiperfifo.c +++ b/docs/examples/hiperfifo.c @@ -447,13 +447,13 @@ int main(int argc, char **argv) curl_multi_setopt(g.multi, CURLMOPT_TIMERFUNCTION, multi_timer_cb); curl_multi_setopt(g.multi, CURLMOPT_TIMERDATA, &g); - /* we don't call any curl_multi_socket*() function yet as we have no handles + /* we do not call any curl_multi_socket*() function yet as we have no handles added! */ event_base_dispatch(g.evbase); - /* this, of course, won't get called since only way to stop this program is - via ctrl-C, but it is here to show how cleanup /would/ be done. */ + /* this, of course, will not get called since only way to stop this program + is via ctrl-C, but it is here to show how cleanup /would/ be done. */ clean_fifo(&g); event_del(&g.timer_event); event_base_free(g.evbase); diff --git a/docs/examples/htmltidy.c b/docs/examples/htmltidy.c index d250cb9de..73ac6fb88 100644 --- a/docs/examples/htmltidy.c +++ b/docs/examples/htmltidy.c @@ -60,7 +60,7 @@ void dumpNode(TidyDoc doc, TidyNode tnod, int indent) printf(">\n"); } else { - /* if it doesn't have a name, then it's probably text, cdata, etc... */ + /* if it does not have a name, then it's probably text, cdata, etc... */ TidyBuffer buf; tidyBufInit(&buf); tidyNodeGetText(doc, child, &buf); diff --git a/docs/examples/http2-download.c b/docs/examples/http2-download.c index 6ba82f35b..cb0ef13ac 100644 --- a/docs/examples/http2-download.c +++ b/docs/examples/http2-download.c @@ -37,7 +37,7 @@ #include <curl/mprintf.h> #ifndef CURLPIPE_MULTIPLEX -/* This little trick will just make sure that we don't enable pipelining for +/* This little trick will just make sure that we do not enable pipelining for libcurls old enough to not have this symbol. It is _not_ defined to zero in a recent libcurl header. */ #define CURLPIPE_MULTIPLEX 0 diff --git a/docs/examples/http2-pushinmemory.c b/docs/examples/http2-pushinmemory.c index 7610ccc35..a9c364859 100644 --- a/docs/examples/http2-pushinmemory.c +++ b/docs/examples/http2-pushinmemory.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -103,7 +103,7 @@ static int server_push_callback(CURL *parent, (void)num_headers; /* unused */ if(pushindex == MAX_FILES) - /* can't fit anymore */ + /* cannot fit anymore */ return CURL_PUSH_DENY; /* write to this buffer */ diff --git a/docs/examples/http2-serverpush.c b/docs/examples/http2-serverpush.c index 3d32f2245..b7c16371a 100644 --- a/docs/examples/http2-serverpush.c +++ b/docs/examples/http2-serverpush.c @@ -35,7 +35,7 @@ #include <curl/curl.h> #ifndef CURLPIPE_MULTIPLEX -#error "too old libcurl, can't do HTTP/2 server push!" +#error "too old libcurl, cannot do HTTP/2 server push!" #endif static @@ -180,7 +180,7 @@ static int server_push_callback(CURL *parent, /* here's a new stream, save it in a new file for each new push */ out = fopen(filename, "wb"); if(!out) { - /* if we can't save it, deny it */ + /* if we cannot save it, deny it */ fprintf(stderr, "Failed to create output file for push\n"); return CURL_PUSH_DENY; } diff --git a/docs/examples/http2-upload.c b/docs/examples/http2-upload.c index 9485825b3..742177f69 100644 --- a/docs/examples/http2-upload.c +++ b/docs/examples/http2-upload.c @@ -39,7 +39,7 @@ #include <curl/mprintf.h> #ifndef CURLPIPE_MULTIPLEX -/* This little trick will just make sure that we don't enable pipelining for +/* This little trick will just make sure that we do not enable pipelining for libcurls old enough to not have this symbol. It is _not_ defined to zero in a recent libcurl header. */ #define CURLPIPE_MULTIPLEX 0 @@ -124,7 +124,7 @@ int my_trace(CURL *handle, curl_infotype type, known_offset = 1; } secs = epoch_offset + tv.tv_sec; - now = localtime(&secs); /* not thread safe but we don't care */ + now = localtime(&secs); /* not thread safe but we do not care */ curl_msnprintf(timebuf, sizeof(timebuf), "%02d:%02d:%02d.%06ld", now->tm_hour, now->tm_min, now->tm_sec, (long)tv.tv_usec); diff --git a/docs/examples/http3.c b/docs/examples/http3.c index d462d2acc..8553e3ac8 100644 --- a/docs/examples/http3.c +++ b/docs/examples/http3.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -35,7 +35,7 @@ int main(void) if(curl) { curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); - /* Forcing HTTP/3 will make the connection fail if the server isn't + /* Forcing HTTP/3 will make the connection fail if the server is not accessible over QUIC + HTTP/3 on the given host and port. Consider using CURLOPT_ALTSVC instead! */ curl_easy_setopt(curl, CURLOPT_HTTP_VERSION, (long)CURL_HTTP_VERSION_3); diff --git a/docs/examples/httpcustomheader.c b/docs/examples/httpcustomheader.c index 7a1e1d855..f431177f2 100644 --- a/docs/examples/httpcustomheader.c +++ b/docs/examples/httpcustomheader.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -45,7 +45,7 @@ int main(void) chunk = curl_slist_append(chunk, "Host: example.com"); /* Add a header with "blank" contents to the right of the colon. Note that - we're then using a semicolon in the string we pass to curl! */ + we are then using a semicolon in the string we pass to curl! */ chunk = curl_slist_append(chunk, "X-silly-header;"); /* set our custom set of headers */ diff --git a/docs/examples/httpput-postfields.c b/docs/examples/httpput-postfields.c index 83c2d1f00..eb74eb9d7 100644 --- a/docs/examples/httpput-postfields.c +++ b/docs/examples/httpput-postfields.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -67,7 +67,7 @@ int main(int argc, char **argv) headers = curl_slist_append(headers, "Content-Type: literature/classic"); curl_easy_setopt(curl, CURLOPT_HTTPHEADER, headers); - /* pass on content in request body. When CURLOPT_POSTFIELDSIZE isn't used, + /* pass on content in request body. When CURLOPT_POSTFIELDSIZE is not used, curl does strlen to get the size. */ curl_easy_setopt(curl, CURLOPT_POSTFIELDS, olivertwist); @@ -82,7 +82,7 @@ int main(int argc, char **argv) name, not only a directory */ curl_easy_setopt(curl, CURLOPT_URL, url); - /* Now run off and do what you've been told! */ + /* Now run off and do what you have been told! */ res = curl_easy_perform(curl); /* Check for errors */ if(res != CURLE_OK) diff --git a/docs/examples/httpput.c b/docs/examples/httpput.c index 8365ab208..90749da2d 100644 --- a/docs/examples/httpput.c +++ b/docs/examples/httpput.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -104,7 +104,7 @@ int main(int argc, char **argv) curl_easy_setopt(curl, CURLOPT_INFILESIZE_LARGE, (curl_off_t)file_info.st_size); - /* Now run off and do what you've been told! */ + /* Now run off and do what you have been told! */ res = curl_easy_perform(curl); /* Check for errors */ if(res != CURLE_OK) diff --git a/docs/examples/https.c b/docs/examples/https.c index 6dbf8bd0c..675441a17 100644 --- a/docs/examples/https.c +++ b/docs/examples/https.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -39,7 +39,7 @@ int main(void) #ifdef SKIP_PEER_VERIFICATION /* - * If you want to connect to a site who isn't using a certificate that is + * If you want to connect to a site who is not using a certificate that is * signed by one of the certs in the CA bundle you have, you can skip the * verification of the server's certificate. This makes the connection * A LOT LESS SECURE. @@ -53,7 +53,7 @@ int main(void) #ifdef SKIP_HOSTNAME_VERIFICATION /* - * If the site you're connecting to uses a different host name that what + * If the site you are connecting to uses a different host name that what * they have mentioned in their server certificate's commonName (or * subjectAltName) fields, libcurl will refuse to connect. You can skip * this check, but this will make the connection less secure. diff --git a/docs/examples/imap-append.c b/docs/examples/imap-append.c index deeed43d2..78ecc8d01 100644 --- a/docs/examples/imap-append.c +++ b/docs/examples/imap-append.c @@ -101,7 +101,7 @@ int main(void) * SELECT to ensure you are creating the message in the OUTBOX. */ curl_easy_setopt(curl, CURLOPT_URL, "imap://imap.example.com/100"); - /* In this case, we're using a callback function to specify the data. You + /* In this case, we are using a callback function to specify the data. You * could just use the CURLOPT_READDATA option to specify a FILE pointer to * read from. */ curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source); diff --git a/docs/examples/imap-ssl.c b/docs/examples/imap-ssl.c index ce890c97b..e43639e16 100644 --- a/docs/examples/imap-ssl.c +++ b/docs/examples/imap-ssl.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -51,7 +51,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_URL, "imaps://imap.example.com/INBOX/;UID=1"); - /* If you want to connect to a site who isn't using a certificate that is + /* If you want to connect to a site who is not using a certificate that is * signed by one of the certs in the CA bundle you have, you can skip the * verification of the server's certificate. This makes the connection * A LOT LESS SECURE. @@ -63,7 +63,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); #endif - /* If the site you're connecting to uses a different host name that what + /* If the site you are connecting to uses a different host name that what * they have mentioned in their server certificate's commonName (or * subjectAltName) fields, libcurl will refuse to connect. You can skip * this check, but this will make the connection less secure. */ diff --git a/docs/examples/imap-store.c b/docs/examples/imap-store.c index d39c6eadf..9a87a7993 100644 --- a/docs/examples/imap-store.c +++ b/docs/examples/imap-store.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -62,7 +62,7 @@ int main(void) curl_easy_strerror(res)); else { /* Set the EXPUNGE command, although you can use the CLOSE command if you - * don't want to know the result of the STORE */ + * do not want to know the result of the STORE */ curl_easy_setopt(curl, CURLOPT_CUSTOMREQUEST, "EXPUNGE"); /* Perform the second custom request */ diff --git a/docs/examples/imap-tls.c b/docs/examples/imap-tls.c index d80f54d64..d8b587d66 100644 --- a/docs/examples/imap-tls.c +++ b/docs/examples/imap-tls.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -50,14 +50,14 @@ int main(void) curl_easy_setopt(curl, CURLOPT_URL, "imap://imap.example.com/INBOX/;UID=1"); - /* In this example, we'll start with a plain text connection, and upgrade + /* In this example, we will start with a plain text connection, and upgrade * to Transport Layer Security (TLS) using the STARTTLS command. Be careful * of using CURLUSESSL_TRY here, because if TLS upgrade fails, the transfer * will continue anyway - see the security discussion in the libcurl * tutorial for more details. */ curl_easy_setopt(curl, CURLOPT_USE_SSL, (long)CURLUSESSL_ALL); - /* If your server doesn't have a valid certificate, then you can disable + /* If your server does not have a valid certificate, then you can disable * part of the Transport Layer Security protection by setting the * CURLOPT_SSL_VERIFYPEER and CURLOPT_SSL_VERIFYHOST options to 0 (false). * curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); diff --git a/docs/examples/multi-app.c b/docs/examples/multi-app.c index 76c25750b..58ad03f81 100644 --- a/docs/examples/multi-app.c +++ b/docs/examples/multi-app.c @@ -58,7 +58,7 @@ int main(void) for(i = 0; i<HANDLECOUNT; i++) handles[i] = curl_easy_init(); - /* set the options (I left out a few, you'll get the point anyway) */ + /* set the options (I left out a few, you will get the point anyway) */ curl_easy_setopt(handles[HTTP_HANDLE], CURLOPT_URL, "https://example.com"); curl_easy_setopt(handles[FTP_HANDLE], CURLOPT_URL, "ftp://example.com"); diff --git a/docs/examples/multi-debugcallback.c b/docs/examples/multi-debugcallback.c index af79e56df..b173b724f 100644 --- a/docs/examples/multi-debugcallback.c +++ b/docs/examples/multi-debugcallback.c @@ -135,7 +135,7 @@ int main(void) http_handle = curl_easy_init(); - /* set the options (I left out a few, you'll get the point anyway) */ + /* set the options (I left out a few, you will get the point anyway) */ curl_easy_setopt(http_handle, CURLOPT_URL, "https://www.example.com/"); curl_easy_setopt(http_handle, CURLOPT_DEBUGFUNCTION, my_trace); diff --git a/docs/examples/multi-event.c b/docs/examples/multi-event.c index ebe9513ed..6da85134b 100644 --- a/docs/examples/multi-event.c +++ b/docs/examples/multi-event.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -153,7 +153,7 @@ static int start_timeout(CURLM *multi, long timeout_ms, void *userp) } else { if(timeout_ms == 0) - timeout_ms = 1; /* 0 means directly call socket_action, but we'll do it + timeout_ms = 1; /* 0 means directly call socket_action, but we will do it in a bit */ struct timeval tv; tv.tv_sec = timeout_ms / 1000; diff --git a/docs/examples/multi-legacy.c b/docs/examples/multi-legacy.c index ca1a9b93f..85ec55d0f 100644 --- a/docs/examples/multi-legacy.c +++ b/docs/examples/multi-legacy.c @@ -58,7 +58,7 @@ int main(void) for(i = 0; i<HANDLECOUNT; i++) handles[i] = curl_easy_init(); - /* set the options (I left out a few, you'll get the point anyway) */ + /* set the options (I left out a few, you will get the point anyway) */ curl_easy_setopt(handles[HTTP_HANDLE], CURLOPT_URL, "https://example.com"); curl_easy_setopt(handles[FTP_HANDLE], CURLOPT_URL, "ftp://example.com"); diff --git a/docs/examples/multi-single.c b/docs/examples/multi-single.c index e340231fb..ec27da1ed 100644 --- a/docs/examples/multi-single.c +++ b/docs/examples/multi-single.c @@ -56,7 +56,7 @@ int main(void) http_handle = curl_easy_init(); - /* set the options (I left out a few, you'll get the point anyway) */ + /* set the options (I left out a few, you will get the point anyway) */ curl_easy_setopt(http_handle, CURLOPT_URL, "https://www.example.com/"); /* init a multi stack */ diff --git a/docs/examples/multi-uv.c b/docs/examples/multi-uv.c index 3da61a23e..f8985a8d7 100644 --- a/docs/examples/multi-uv.c +++ b/docs/examples/multi-uv.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -163,7 +163,7 @@ static int start_timeout(CURLM *multi, long timeout_ms, void *userp) } else { if(timeout_ms == 0) - timeout_ms = 1; /* 0 means directly call socket_action, but we'll do it + timeout_ms = 1; /* 0 means directly call socket_action, but we will do it in a bit */ uv_timer_start(&timeout, on_timeout, timeout_ms, 0); } diff --git a/docs/examples/pop3-ssl.c b/docs/examples/pop3-ssl.c index 4362925d6..be492890c 100644 --- a/docs/examples/pop3-ssl.c +++ b/docs/examples/pop3-ssl.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -50,7 +50,7 @@ int main(void) * pop3s:// rather than pop3:// to request a SSL based connection. */ curl_easy_setopt(curl, CURLOPT_URL, "pop3s://pop.example.com/1"); - /* If you want to connect to a site who isn't using a certificate that is + /* If you want to connect to a site who is not using a certificate that is * signed by one of the certs in the CA bundle you have, you can skip the * verification of the server's certificate. This makes the connection * A LOT LESS SECURE. @@ -62,7 +62,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); #endif - /* If the site you're connecting to uses a different host name that what + /* If the site you are connecting to uses a different host name that what * they have mentioned in their server certificate's commonName (or * subjectAltName) fields, libcurl will refuse to connect. You can skip * this check, but this will make the connection less secure. */ diff --git a/docs/examples/pop3-tls.c b/docs/examples/pop3-tls.c index 1ce97a5c1..496a3de2d 100644 --- a/docs/examples/pop3-tls.c +++ b/docs/examples/pop3-tls.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -49,14 +49,14 @@ int main(void) /* This will retrieve message 1 from the user's mailbox */ curl_easy_setopt(curl, CURLOPT_URL, "pop3://pop.example.com/1"); - /* In this example, we'll start with a plain text connection, and upgrade + /* In this example, we will start with a plain text connection, and upgrade * to Transport Layer Security (TLS) using the STLS command. Be careful of * using CURLUSESSL_TRY here, because if TLS upgrade fails, the transfer * will continue anyway - see the security discussion in the libcurl * tutorial for more details. */ curl_easy_setopt(curl, CURLOPT_USE_SSL, (long)CURLUSESSL_ALL); - /* If your server doesn't have a valid certificate, then you can disable + /* If your server does not have a valid certificate, then you can disable * part of the Transport Layer Security protection by setting the * CURLOPT_SSL_VERIFYPEER and CURLOPT_SSL_VERIFYHOST options to 0 (false). * curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); diff --git a/docs/examples/postinmemory.c b/docs/examples/postinmemory.c index e3a676f2c..d0f797042 100644 --- a/docs/examples/postinmemory.c +++ b/docs/examples/postinmemory.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -75,13 +75,13 @@ int main(void) /* we pass our 'chunk' struct to the callback function */ curl_easy_setopt(curl, CURLOPT_WRITEDATA, (void *)&chunk); - /* some servers don't like requests that are made without a user-agent + /* some servers do not like requests that are made without a user-agent field, so we provide one */ curl_easy_setopt(curl, CURLOPT_USERAGENT, "libcurl-agent/1.0"); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postthis); - /* if we don't provide POSTFIELDSIZE, libcurl will strlen() by + /* if we do not provide POSTFIELDSIZE, libcurl will strlen() by itself */ curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, (long)strlen(postthis)); diff --git a/docs/examples/postit2-formadd.c b/docs/examples/postit2-formadd.c index 43dbb3918..cef89f6c9 100644 --- a/docs/examples/postit2-formadd.c +++ b/docs/examples/postit2-formadd.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -26,7 +26,7 @@ /* Example code that uploads a file name 'foo' to a remote script that accepts * "HTML form based" (as described in RFC1738) uploads using HTTP POST. * - * The imaginary form we'll fill in looks like: + * The imaginary form we will fill in looks like: * * <form method="post" enctype="multipart/form-data" action="examplepost.cgi"> * Enter file: <input type="file" name="sendfile" size="40"> diff --git a/docs/examples/postit2.c b/docs/examples/postit2.c index 95b565efe..923fead4a 100644 --- a/docs/examples/postit2.c +++ b/docs/examples/postit2.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -26,7 +26,7 @@ /* Example code that uploads a file name 'foo' to a remote script that accepts * "HTML form based" (as described in RFC1738) uploads using HTTP POST. * - * The imaginary form we'll fill in looks like: + * The imaginary form we will fill in looks like: * * <form method="post" enctype="multipart/form-data" action="examplepost.cgi"> * Enter file: <input type="file" name="sendfile" size="40"> diff --git a/docs/examples/progressfunc.c b/docs/examples/progressfunc.c index 00c67face..68f47d594 100644 --- a/docs/examples/progressfunc.c +++ b/docs/examples/progressfunc.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -112,7 +112,7 @@ int main(void) #if LIBCURL_VERSION_NUM >= 0x072000 /* xferinfo was introduced in 7.32.0, no earlier libcurl versions will - compile as they won't have the symbols around. + compile as they will not have the symbols around. If built with a newer libcurl, but running with an older libcurl: curl_easy_setopt() will fail in run-time trying to set the new diff --git a/docs/examples/sendrecv.c b/docs/examples/sendrecv.c index 9f4082926..44741aeba 100644 --- a/docs/examples/sendrecv.c +++ b/docs/examples/sendrecv.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -63,9 +63,9 @@ int main(void) const char *request = "GET / HTTP/1.0\r\nHost: example.com\r\n\r\n"; size_t request_len = strlen(request); - /* A general note of caution here: if you're using curl_easy_recv() or + /* A general note of caution here: if you are using curl_easy_recv() or curl_easy_send() to implement HTTP or _any_ other protocol libcurl - supports "natively", you're doing it wrong and you should stop. + supports "natively", you are doing it wrong and you should stop. This example uses HTTP only to show how to use this API, it does not suggest that writing an application doing this is sensible. @@ -87,7 +87,8 @@ int main(void) return 1; } - /* Extract the socket from the curl handle - we'll need it for waiting. */ + /* Extract the socket from the curl handle - we will need it for + waiting. */ res = curl_easy_getinfo(curl, CURLINFO_ACTIVESOCKET, &sockfd); if(res != CURLE_OK) { diff --git a/docs/examples/sftpget.c b/docs/examples/sftpget.c index 37840c918..3c74d2abc 100644 --- a/docs/examples/sftpget.c +++ b/docs/examples/sftpget.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -34,8 +34,8 @@ /* * This is an example showing how to get a single file from an SFTP server. * It delays the actual destination file creation until the first write - * callback so that it won't create an empty file in case the remote file - * doesn't exist or something else fails. + * callback so that it will not create an empty file in case the remote file + * does not exist or something else fails. */ struct FtpFile { @@ -51,7 +51,7 @@ static size_t my_fwrite(void *buffer, size_t size, size_t nmemb, /* open file for writing */ out->stream = fopen(out->filename, "wb"); if(!out->stream) - return -1; /* failure, can't open file to write */ + return -1; /* failure, cannot open file to write */ } return fwrite(buffer, size, nmemb, out->stream); } diff --git a/docs/examples/simplepost.c b/docs/examples/simplepost.c index 8580c5e9d..70252a41a 100644 --- a/docs/examples/simplepost.c +++ b/docs/examples/simplepost.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -39,7 +39,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postthis); - /* if we don't provide POSTFIELDSIZE, libcurl will strlen() by + /* if we do not provide POSTFIELDSIZE, libcurl will strlen() by itself */ curl_easy_setopt(curl, CURLOPT_POSTFIELDSIZE, (long)strlen(postthis)); diff --git a/docs/examples/simplessl.c b/docs/examples/simplessl.c index d4d8b9ea6..f34ee4740 100644 --- a/docs/examples/simplessl.c +++ b/docs/examples/simplessl.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -35,7 +35,7 @@ 3.1. set a #define USE_ENGINE 3.2. set pEngine to the name of the crypto engine you use 3.3. set pKeyName to the key identifier you want to use - 4. if you don't use a crypto engine: + 4. if you do not use a crypto engine: 4.1. set pKeyName to the file name of your client key 4.2. if the format of the key file is DER, set pKeyType to "DER" @@ -86,14 +86,14 @@ int main(void) /* use crypto engine */ if(curl_easy_setopt(curl, CURLOPT_SSLENGINE, pEngine) != CURLE_OK) { /* load the crypto engine */ - fprintf(stderr, "can't set crypto engine\n"); + fprintf(stderr, "cannot set crypto engine\n"); break; } if(curl_easy_setopt(curl, CURLOPT_SSLENGINE_DEFAULT, 1L) != CURLE_OK) { /* set the crypto engine as default */ /* only needed for the first time you load a engine in a curl object... */ - fprintf(stderr, "can't set crypto engine as default\n"); + fprintf(stderr, "cannot set crypto engine as default\n"); break; } } @@ -119,7 +119,7 @@ int main(void) /* set the file with the certs vaildating the server */ curl_easy_setopt(curl, CURLOPT_CAINFO, pCACertFile); - /* disconnect if we can't validate server's cert */ + /* disconnect if we cannot validate server's cert */ curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 1L); /* Perform the request, res will get the return code */ diff --git a/docs/examples/smooth-gtk-thread.c b/docs/examples/smooth-gtk-thread.c index e149e5c0a..231c0dd25 100644 --- a/docs/examples/smooth-gtk-thread.c +++ b/docs/examples/smooth-gtk-thread.c @@ -122,7 +122,7 @@ void *create_thread(void *progress_bar) pthread_t tid[NUMT]; int i; - /* Make sure I don't create more threads than urls. */ + /* Make sure I do not create more threads than urls. */ for(i = 0; i < NUMT && i < num_urls ; i++) { int error = pthread_create(&tid[i], NULL, /* default attributes please */ @@ -206,7 +206,7 @@ int main(int argc, char **argv) G_CALLBACK(cb_delete), NULL); if(!g_thread_create(&create_thread, progress_bar, FALSE, NULL) != 0) - g_warning("can't create the thread"); + g_warning("cannot create the thread"); gtk_main(); gdk_threads_leave(); diff --git a/docs/examples/smtp-authzid.c b/docs/examples/smtp-authzid.c index e541f0905..b315b215c 100644 --- a/docs/examples/smtp-authzid.c +++ b/docs/examples/smtp-authzid.c @@ -113,7 +113,7 @@ int main(void) /* Force PLAIN authentication */ curl_easy_setopt(curl, CURLOPT_LOGIN_OPTIONS, "AUTH=PLAIN"); - /* Note that this option isn't strictly required, omitting it will result + /* Note that this option is not strictly required, omitting it will result * in libcurl sending the MAIL FROM command with empty sender data. All * autoresponses should have an empty reverse-path, and should be directed * to the address in the reverse-path which triggered them. Otherwise, @@ -127,7 +127,7 @@ int main(void) recipients = curl_slist_append(recipients, TO_ADDR); curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients); - /* We're using a callback function to specify the payload (the headers and + /* We are using a callback function to specify the payload (the headers and * body of the message). You could just use the CURLOPT_READDATA option to * specify a FILE pointer to read from. */ curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source); @@ -145,13 +145,13 @@ int main(void) /* Free the list of recipients */ curl_slist_free_all(recipients); - /* curl won't send the QUIT command until you call cleanup, so you should - * be able to re-use 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. + /* curl will not send the QUIT command until you call cleanup, so you + * should be able to re-use 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. */ curl_easy_cleanup(curl); } diff --git a/docs/examples/smtp-expn.c b/docs/examples/smtp-expn.c index 9de5b3246..2c11c4f84 100644 --- a/docs/examples/smtp-expn.c +++ b/docs/examples/smtp-expn.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -66,10 +66,10 @@ int main(void) /* Free the list of recipients */ curl_slist_free_all(recipients); - /* Curl won't send the QUIT command until you call cleanup, so you should - * be able to re-use 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 + /* curl will not send the QUIT command until you call cleanup, so you + * should be able to re-use 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 * 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 5159786c4..2c0cfb253 100644 --- a/docs/examples/smtp-mail.c +++ b/docs/examples/smtp-mail.c @@ -99,7 +99,7 @@ int main(void) /* This is the URL for your mailserver */ curl_easy_setopt(curl, CURLOPT_URL, "smtp://mail.example.com"); - /* Note that this option isn't strictly required, omitting it will result + /* Note that this option is not strictly required, omitting it will result * in libcurl sending the MAIL FROM command with empty sender data. All * autoresponses should have an empty reverse-path, and should be directed * to the address in the reverse-path which triggered them. Otherwise, @@ -115,7 +115,7 @@ int main(void) recipients = curl_slist_append(recipients, CC_ADDR); curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients); - /* We're using a callback function to specify the payload (the headers and + /* We are using a callback function to specify the payload (the headers and * body of the message). You could just use the CURLOPT_READDATA option to * specify a FILE pointer to read from. */ curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source); @@ -133,13 +133,13 @@ int main(void) /* Free the list of recipients */ curl_slist_free_all(recipients); - /* curl won't send the QUIT command until you call cleanup, so you should - * be able to re-use 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. + /* curl will not send the QUIT command until you call cleanup, so you + * should be able to re-use 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. */ curl_easy_cleanup(curl); } diff --git a/docs/examples/smtp-mime.c b/docs/examples/smtp-mime.c index 4a2ff19ce..564f920d2 100644 --- a/docs/examples/smtp-mime.c +++ b/docs/examples/smtp-mime.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -84,7 +84,7 @@ int main(void) /* This is the URL for your mailserver */ curl_easy_setopt(curl, CURLOPT_URL, "smtp://mail.example.com"); - /* Note that this option isn't strictly required, omitting it will result + /* Note that this option is not strictly required, omitting it will result * in libcurl sending the MAIL FROM command with empty sender data. All * autoresponses should have an empty reverse-path, and should be directed * to the address in the reverse-path which triggered them. Otherwise, @@ -145,13 +145,13 @@ int main(void) curl_slist_free_all(recipients); curl_slist_free_all(headers); - /* curl won't send the QUIT command until you call cleanup, so you should - * be able to re-use 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. + /* curl will not send the QUIT command until you call cleanup, so you + * should be able to re-use 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. */ curl_easy_cleanup(curl); diff --git a/docs/examples/smtp-multi.c b/docs/examples/smtp-multi.c index ac867a21a..4ba7ecb60 100644 --- a/docs/examples/smtp-multi.c +++ b/docs/examples/smtp-multi.c @@ -101,7 +101,7 @@ int main(void) /* This is the URL for your mailserver */ curl_easy_setopt(curl, CURLOPT_URL, "smtp://mail.example.com"); - /* Note that this option isn't strictly required, omitting it will result in + /* Note that this option is not strictly required, omitting it will result in * libcurl sending the MAIL FROM command with empty sender data. All * autoresponses should have an empty reverse-path, and should be directed * to the address in the reverse-path which triggered them. Otherwise, they @@ -116,7 +116,7 @@ int main(void) recipients = curl_slist_append(recipients, CC_MAIL); curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients); - /* We're using a callback function to specify the payload (the headers and + /* We are using a callback function to specify the payload (the headers and * body of the message). You could just use the CURLOPT_READDATA option to * specify a FILE pointer to read from. */ curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source); diff --git a/docs/examples/smtp-ssl.c b/docs/examples/smtp-ssl.c index 6181bb035..099dedb6c 100644 --- a/docs/examples/smtp-ssl.c +++ b/docs/examples/smtp-ssl.c @@ -101,7 +101,7 @@ int main(void) * than smtp:// to request a SSL based connection. */ curl_easy_setopt(curl, CURLOPT_URL, "smtps://mainserver.example.net"); - /* If you want to connect to a site who isn't using a certificate that is + /* If you want to connect to a site who is not using a certificate that is * signed by one of the certs in the CA bundle you have, you can skip the * verification of the server's certificate. This makes the connection * A LOT LESS SECURE. @@ -113,7 +113,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); #endif - /* If the site you're connecting to uses a different host name that what + /* If the site you are connecting to uses a different host name that what * they have mentioned in their server certificate's commonName (or * subjectAltName) fields, libcurl will refuse to connect. You can skip * this check, but this will make the connection less secure. */ @@ -121,7 +121,7 @@ int main(void) curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L); #endif - /* Note that this option isn't strictly required, omitting it will result + /* Note that this option is not strictly required, omitting it will result * in libcurl sending the MAIL FROM command with empty sender data. All * autoresponses should have an empty reverse-path, and should be directed * to the address in the reverse-path which triggered them. Otherwise, @@ -137,7 +137,7 @@ int main(void) recipients = curl_slist_append(recipients, CC_MAIL); curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients); - /* We're using a callback function to specify the payload (the headers and + /* We are using a callback function to specify the payload (the headers and * body of the message). You could just use the CURLOPT_READDATA option to * specify a FILE pointer to read from. */ curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source); diff --git a/docs/examples/smtp-tls.c b/docs/examples/smtp-tls.c index a9c45fa72..41024b1da 100644 --- a/docs/examples/smtp-tls.c +++ b/docs/examples/smtp-tls.c @@ -103,14 +103,14 @@ int main(void) * matches your server configuration. */ curl_easy_setopt(curl, CURLOPT_URL, "smtp://mainserver.example.net:587"); - /* In this example, we'll start with a plain text connection, and upgrade + /* In this example, we will start with a plain text connection, and upgrade * to Transport Layer Security (TLS) using the STARTTLS command. Be careful * of using CURLUSESSL_TRY here, because if TLS upgrade fails, the transfer * will continue anyway - see the security discussion in the libcurl * tutorial for more details. */ curl_easy_setopt(curl, CURLOPT_USE_SSL, (long)CURLUSESSL_ALL); - /* If your server doesn't have a valid certificate, then you can disable + /* If your server does not have a valid certificate, then you can disable * part of the Transport Layer Security protection by setting the * CURLOPT_SSL_VERIFYPEER and CURLOPT_SSL_VERIFYHOST options to 0 (false). * curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); @@ -123,7 +123,7 @@ int main(void) * for more information. */ curl_easy_setopt(curl, CURLOPT_CAINFO, "/path/to/certificate.pem"); - /* Note that this option isn't strictly required, omitting it will result + /* Note that this option is not strictly required, omitting it will result * in libcurl sending the MAIL FROM command with empty sender data. All * autoresponses should have an empty reverse-path, and should be directed * to the address in the reverse-path which triggered them. Otherwise, @@ -139,7 +139,7 @@ int main(void) recipients = curl_slist_append(recipients, CC_MAIL); curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients); - /* We're using a callback function to specify the payload (the headers and + /* We are using a callback function to specify the payload (the headers and * body of the message). You could just use the CURLOPT_READDATA option to * specify a FILE pointer to read from. */ curl_easy_setopt(curl, CURLOPT_READFUNCTION, payload_source); diff --git a/docs/examples/smtp-vrfy.c b/docs/examples/smtp-vrfy.c index 7d021011c..26819a50a 100644 --- a/docs/examples/smtp-vrfy.c +++ b/docs/examples/smtp-vrfy.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -37,7 +37,7 @@ * 1) This example requires libcurl 7.34.0 or above. * 2) Not all email servers support this command and even if your email server * does support it, it may respond with a 252 response code even though the - * address doesn't exist. + * address does not exist. */ int main(void) @@ -66,10 +66,10 @@ int main(void) /* Free the list of recipients */ curl_slist_free_all(recipients); - /* Curl won't send the QUIT command until you call cleanup, so you should - * be able to re-use 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 + /* curl will not send the QUIT command until you call cleanup, so you + * should be able to re-use 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 * connection) and you do want to clean up in the end. */ curl_easy_cleanup(curl); diff --git a/docs/examples/threaded-ssl.c b/docs/examples/threaded-ssl.c index 44c6a6c1e..e594b813b 100644 --- a/docs/examples/threaded-ssl.c +++ b/docs/examples/threaded-ssl.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -121,7 +121,7 @@ static void *pull_one_url(void *url) curl = curl_easy_init(); curl_easy_setopt(curl, CURLOPT_URL, url); - /* this example doesn't verify the server's certificate, which means we + /* this example does not verify the server's certificate, which means we might be downloading stuff from an impostor */ curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L); curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L); @@ -135,7 +135,7 @@ int main(int argc, char **argv) { pthread_t tid[NUMT]; int i; - (void)argc; /* we don't use any arguments in this example */ + (void)argc; /* we do not use any arguments in this example */ (void)argv; /* Must initialize libcurl before any threads are started */ diff --git a/docs/examples/xmlstream.c b/docs/examples/xmlstream.c index e6416c349..0a8bff3d5 100644 --- a/docs/examples/xmlstream.c +++ b/docs/examples/xmlstream.c @@ -5,7 +5,7 @@ * | (__| |_| | _ <| |___ * \___|\___/|_| \_\_____| * - * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. + * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. * * This software is licensed as described in the file COPYING, which * you should have received as part of this distribution. The terms @@ -98,7 +98,7 @@ static size_t parseStreamCallback(void *contents, size_t length, size_t nmemb, size_t real_size = length * nmemb; struct ParserStruct *state = (struct ParserStruct *) XML_GetUserData(parser); - /* Only parse if we're not already in a failure state. */ + /* Only parse if we are not already in a failure state. */ if(state->ok && XML_Parse(parser, contents, real_size, 0) == 0) { int error_code = XML_GetErrorCode(parser); fprintf(stderr, "Parsing response buffer of length %lu failed" |