Skip to content

Commit

Permalink
reduce/remove exclamation mark use
Browse files Browse the repository at this point in the history
  • Loading branch information
bagder committed Jan 10, 2024
1 parent 767120c commit b5aa9a8
Show file tree
Hide file tree
Showing 34 changed files with 42 additions and 42 deletions.
2 changes: 1 addition & 1 deletion GUIDELINES.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ Spell them out as "it will" and "must have", etc.

And ... vs … (typographical ellipses)

Let's try to use the correct UTF-8 characters!
Try to use the correct UTF-8 characters.

## Avoid the short forms of dir and repo

Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,7 +53,7 @@ All there is to know about Daniel can be found on [daniel.haxx.se](https://danie

If you find mistakes, omissions, errors or blatant lies in this document,
please send us a refreshed version of the affected paragraph and we will amend
and update. We give credit to and recognize everyone who helps out!
and update. We give credit to and recognize everyone who helps out.

Preferably, you could submit
[errors](https://github.com/bagder/everything-curl/issues) or [pull
Expand Down
2 changes: 1 addition & 1 deletion build.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ yourself, chances are that building curl from source is the easiest or perhaps
the only way to get curl.

Making it easy to build curl is a priority to the curl project, although we do
not always necessarily succeed!
not always necessarily succeed.

## git vs release tarballs

Expand Down
2 changes: 1 addition & 1 deletion cmdline/globbing.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ interfering with it. This also goes for other characters treated special, like
for example '&', '?' and '*'.

While most transfer related functionality in curl is provided by the libcurl
library, the URL globbing feature is not!
library, the URL globbing feature is not.

## Numerical ranges

Expand Down
2 changes: 1 addition & 1 deletion cmdline/urls/query.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ the `+` prefix. See below.

- `content`: URL encode the content and add that to the query. Just be
careful so that the content does not contain any `=` or `@` symbols, as
that makes the syntax match one of the other cases below!
that makes the syntax match one of the other cases below.

- `=content`: URL encode the content and add that to the query. The initial
`=` symbol is not included in the data.
Expand Down
2 changes: 1 addition & 1 deletion ftp/cmds.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,7 +19,7 @@ To know what commands that are available and possible to send to a server, you
need to know a little about the FTP protocol, and possibly read up a bit on
RFC 959 on the details.

To send a simple `NOOP` to the server (which does nothing!) **before** the
To send a simple `NOOP` to the server (which does nothing) **before** the
transfer starts, provide it to curl like this:

curl -Q NOOP ftp://example.com/file
Expand Down
2 changes: 1 addition & 1 deletion ftp/dirlist.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,5 +19,5 @@ the special formatting of the regular directory listings is to tell curl to
curl --list-only ftp://ftp.example.com/directory/

NLST has its own quirks though, as some FTP servers list only actual *files*
in their response to NLST; they do not include directories and symbolic links!
in their response to NLST; they do not include directories and symbolic links.

2 changes: 1 addition & 1 deletion ftp/twoconnections.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Two connections

FTP uses two TCP connections! The first connection is setup by the client when
FTP uses two TCP connections. The first connection is setup by the client when
it connects to an FTP server, and is called the *control connection*. As the
initial connection, it gets to handle authentication and changing to the
correct directory on the remote server, etc. When the client then is ready to
Expand Down
2 changes: 1 addition & 1 deletion get/win-msys2.md
Original file line number Diff line number Diff line change
Expand Up @@ -64,6 +64,6 @@ Use the `pacman -u` command to install such a local package file:
Have a look at the [msys2
docs](https://www.msys2.org/docs/package-management/) or join the
[gitter](https://gitter.im/msys2/msys2) to learn more about building with
pacman and msys2!
pacman and msys2.

\[^1]: Be careful not to confuse the [mingw-package](https://github.com/msys2/MINGW-packages) `mingw-w64-curl` with the [msys-packages](https://github.com/msys2/MSYS2-packages) `curl` and `curl-devel`. The latter are part of msys2 environment itself (e.g. to support pacman downloads), but not suitable for redistribution. To build redistributable software that does not depend on MSYS2 itself, you always need `mingw-w64-…` packages and toolchains.
2 changes: 1 addition & 1 deletion http/cookies.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,7 @@ Starting off with a blank cookie store may not be desirable. Why not start off
with cookies you stored in a previous fetch or that you otherwise acquired?
The file format curl uses for cookies is called the Netscape cookie format
because it was once the file format used by browsers and then you could easily
tell curl to use the browser's cookies!
tell curl to use the browser's cookies.

As a convenience, curl also supports a cookie file being a set of HTTP headers
that set cookies. It is an inferior format but may be the only thing you have.
Expand Down
2 changes: 1 addition & 1 deletion http/modify/referer.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
When a user clicks on a link on a webpage and the browser takes the user away
to the next URL, it sends the new URL a `Referer:` header in the new request
telling it where it came from. That is the referer header. The `Referer:` is
misspelled but that is how it is supposed to be!
misspelled but that is how it is supposed to be.

With curl you set the referer header with `-e` or `--referer`, like this:

Expand Down
2 changes: 1 addition & 1 deletion http/post/url-encode.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ passed to curl using one of the following syntaxes:

- `content`: URL encode the content and pass that on. Just be careful so that
the content does not contain any `=` or `@` symbols, as that then makes the
syntax match one of the other cases below!
syntax match one of the other cases below.

- `=content`: URL encode the content and pass that on. The initial `=` symbol
is not included in the data.
Expand Down
2 changes: 1 addition & 1 deletion http/redirects.md
Original file line number Diff line number Diff line change
Expand Up @@ -69,7 +69,7 @@ To tell the client “the URI you sent a POST to, is permanently redirected to B
where you should instead send your POST now and in the future”, the server
responds with a 308. To complicate matters, the 308 code is only recently
defined (the [spec](https://tools.ietf.org/html/rfc7238#section-3) was
published in June 2014) so older clients may not treat it correctly! If so,
published in June 2014) so older clients may not treat it correctly. If so,
then the only response code left for you is…

The (older) response code to tell a client to send a POST also in the next
Expand Down
2 changes: 1 addition & 1 deletion internals/structs.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ times.

When doing multiplexed HTTP/2 transfers, each `Curl_easy` is associated with
an individual stream, sharing the same connectdata struct. Multiplexing
makes it even more important to keep things associated with the right thing!
makes it even more important to keep things associated with the right thing.

## connectdata

Expand Down
2 changes: 1 addition & 1 deletion internals/tests/file-format.md
Original file line number Diff line number Diff line change
Expand Up @@ -523,7 +523,7 @@ If there is no test number found above, the HTTP test server uses the number
following the last dot in the given hostname (made so that a CONNECT can still
pass on test number) so that "foo.bar.123" gets treated as test case
123. Alternatively, if an IPv6 address is provided to CONNECT, the last
hexadecimal group in the address is used as the test number! For example the
hexadecimal group in the address is used as the test number. For example the
address "[1234::ff]" would be treated as test case 255.

Set `type="perl"` to write the test case as a perl script. It implies that
Expand Down
2 changes: 1 addition & 1 deletion libcurl-http/auth.md
Original file line number Diff line number Diff line change
Expand Up @@ -99,7 +99,7 @@ Some HTTP servers allow one out of several authentication methods, in some
cases you find yourself in a position where you as a client does not want or
is not able to select a single specific method before-hand and for yet another
subset of cases your application does not know if the requested URL even
require authentication or not!
require authentication or not.

libcurl covers all these situations as well.

Expand Down
2 changes: 1 addition & 1 deletion libcurl/callbacks/header.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ received. *ptr* points to the delivered data, and the size of that data is
*size* multiplied with *nmemb*. libcurl buffers headers and delivers only
"full" headers, one by one, to this callback.

The data passed to this function is not be zero terminated! You cannot, for
The data passed to this function is not be zero terminated. You cannot, for
example, use printf's `%s` operator to display the contents nor strcpy to copy
it.

Expand Down
2 changes: 1 addition & 1 deletion libcurl/callbacks/seek.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,4 +23,4 @@ by instead reading from the input or similar.

If you forward the input arguments directly to fseek(3) or lseek(3), note that
the data type for offset is not the same as defined for `curl_off_t` on many
systems!
systems.
2 changes: 1 addition & 1 deletion libcurl/conn/reuse.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ When you are using the multi API, the connection pool is instead kept
associated with the multi handle. This allows you to cleanup and re-create
easy handles freely without risking losing the connection pool, and it allows
the connection used by one easy handle to get reused by a separate one in a
later transfer. Just reuse the multi handle!
later transfer. Just reuse the multi handle.

## Sharing the "connection cache"

Expand Down
2 changes: 1 addition & 1 deletion libcurl/examples/ftplist.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,7 @@ it as a directory.
curl = curl_easy_init();
if(curl) {
/*
* Make the URL end with a trailing slash!
* Make the URL end with a trailing slash
*/
curl_easy_setopt(curl, CURLOPT_URL, "ftp://ftp.example.com/");

Expand Down
2 changes: 1 addition & 1 deletion libcurl/examples/getinmem.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,7 +84,7 @@ from that instead.
* Now, our chunk.memory points to a memory block that is chunk.size
* bytes big and contains the remote file.
*
* Do something nice with it!
* Do something nice with it
*/

printf("%lu bytes retrieved\n", (long)chunk.size);
Expand Down
2 changes: 1 addition & 1 deletion libcurl/examples/login.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ and prove to the server that we are in fact correctly logged in.
if(curl) {
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/login.cgi");
curl_easy_setopt(curl, CURLOPT_POSTFIELDS, postthis);
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L); /* redirects! */
curl_easy_setopt(curl, CURLOPT_FOLLOWLOCATION, 1L); /* redirects */
curl_easy_setopt(curl, CURLOPT_COOKIEFILE, ""); /* no file */
res = curl_easy_perform(curl);
/* Check for errors */
Expand Down
2 changes: 1 addition & 1 deletion libcurl/getinfo.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Post transfer info

Remember how libcurl transfers are associated with an "easy handle"! Each
Remember how libcurl transfers are associated with *easy handles*. Each
transfer has such a handle and when a transfer is completed, before the handle
is cleaned or reused for another transfer, it can be used to extract
information from the previous operation.
Expand Down
4 changes: 2 additions & 2 deletions project/bugs.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,10 +44,10 @@ can narrow down the "suspects" and make sure your problem is properly located.

A bug report that is submitted then abandoned by the submitter risks getting
closed if the developer fails to understand it, fails to reproduce it or faces
other problems when working on it. Do not abandon your report!
other problems when working on it. Do not abandon your report.

Report curl bugs in the [curl bug tracker on
GitHub](https://github.com/curl/curl/issues)!
GitHub](https://github.com/curl/curl/issues).

## Testing

Expand Down
10 changes: 5 additions & 5 deletions project/etiquette.md
Original file line number Diff line number Diff line change
Expand Up @@ -101,11 +101,11 @@ Many people mail questions to the list, people spend some of their time and
make an effort in providing good answers to these questions.

If you are the one who asks, please consider responding once more in case one
of the hints was what solved your problems. Those who write answers feel
good to know that they provided a good answer and that you fixed the
problem. Far too often, the person who asked the question is never heard of
again, and we never get to know if he/she is gone because the problem was
solved or perhaps because the problem was unsolvable!
of the hints was what solved your problems. Those who write answers feel good
to know that they provided a good answer and that you fixed the problem. Far
too often, the person who asked the question is never heard of again, and we
never get to know if he/she is gone because the problem was solved or perhaps
because the problem was unsolvable.

Getting the solution posted also helps other users that experience the same
problem(s). They get to see (possibly in the web archives) that the suggested
Expand Down
2 changes: 1 addition & 1 deletion source/layout.md
Original file line number Diff line number Diff line change
Expand Up @@ -127,7 +127,7 @@ converted from text to a web friendly format/look.
- `SECURITY`: how we work on security vulnerabilities
- `SSLCERTS`: TLS certificate handling documented
- `SSL-PROBLEMS`: common SSL problems and their causes
- `THANKS`: thanks to this extensive list of friendly people, curl exists today!
- `THANKS`: thanks to this extensive list of friendly people, curl exists today.
- `TheArtOfHttpScripting`: a tutorial into HTTP scripting with curl
- `TODO`: things we or you can work on implementing
- `VERSIONS`: how the version numbering of libcurl works
Expand Down
4 changes: 2 additions & 2 deletions usingcurl/connections/name.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,8 +40,8 @@ given URL.
## Provide a custom IP address for a name

Do you know better than the name resolver where curl should go? Then you can
give an IP address to curl yourself! If you want to redirect port 80 access for
`example.com` to instead reach your localhost:
give an IP address to curl yourself. If you want to redirect port 80 access
for `example.com` to instead reach your localhost:

curl --resolve example.com:80:127.0.0.1 http://example.com/

Expand Down
2 changes: 1 addition & 1 deletion usingcurl/downloads/max-filesize.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

When you want to make sure your curl command line does not download a
too-large file, instruct curl to stop before doing that, if it knows the size
before the transfer starts! Maybe that would use too much bandwidth, take too
before the transfer starts. Maybe that would use too much bandwidth, take too
long time or you do not have enough space on your hard drive:

curl --max-filesize 100000 https://example.com/
Expand Down
2 changes: 1 addition & 1 deletion usingcurl/downloads/storing.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,4 +63,4 @@ up to the user to decide what to do with the leftovers.

The `--remove-on-error` command line option changes this behavior. It tells
curl to delete any partially saved file if curl exits with an error. No more
leftovers!
leftovers.
2 changes: 1 addition & 1 deletion usingcurl/proxies/http.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ not work:

curl -x http://proxy.example.com:80 ftp://ftp.example.com/file.txt

What you can do instead then, is to "tunnel through" the HTTP proxy!
What you can do instead then, is to "tunnel through" the HTTP proxy.

## HTTP proxy tunneling

Expand Down
2 changes: 1 addition & 1 deletion usingcurl/timeouts.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ an extended period of time without it necessarily getting noticed by the
participants in the transfer.

The result of this is that sometimes Internet transfers take a long
time. Further, most operations in curl have no time-out by default!
time. Further, most operations in curl have no time-out by default.

## Maximum time allowed to spend

Expand Down
2 changes: 1 addition & 1 deletion usingcurl/tls/sslkeylogfile.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ Having done this simple operation, you can now inspect curl's or your browser's

Just remember that if you record TLS traffic and want to save it for analyzing later, you need to also save the file with the secrets so that you can decrypt that traffic capture at a later time as well.

## libcurl-using applications too!
## libcurl-using applications too

Support for `SSLKEYLOGFILE` is provided by libcurl itself - making it possible for you to trace and inspect the TLS network data for any application built to use libcurl - not just the curl command line tool.

Expand Down
6 changes: 3 additions & 3 deletions usingcurl/verbose.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,12 +23,12 @@ This tells us curl now tries to connect to this IP address. It means the name

* Connected to example.com (93.184.216.34) port 80 (#0)

It worked! curl connected to the site and here it explains how the name maps
It worked. curl connected to the site and here it explains how the name maps
to the IP address and on which port it has connected to. The '(#0)' part is
which internal number curl has given this connection. If you try multiple URLs
in the same command line you can see it use more connections or reuse
connections, so the connection counter may increase or not increase
depending on what curl decides it needs to do.
connections, so the connection counter may increase or not increase depending
on what curl decides it needs to do.

If we use an `HTTPS://` URL instead of an HTTP one, there are also a whole
bunch of lines explaining how curl uses CA certs to verify the server's
Expand Down
2 changes: 1 addition & 1 deletion usingcurl/version.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,7 +90,7 @@ Features that can be present there:
- **CharConv** - curl was built with support for character set conversions
(like EBCDIC)
- **Debug** - This curl uses a libcurl built with Debug. This enables more
error-tracking and memory debugging etc. For curl-developers only!
error-tracking and memory debugging etc. For curl-developers only.
- **GSS-API** - GSS-API authentication is enabled
- **HTTP2** - HTTP/2 support has been built-in.
- **HTTP3** - HTTP/3 support has been built-in.
Expand Down

0 comments on commit b5aa9a8

Please sign in to comment.