docs/cmdline: refer to --show-headers instead of --include

As it is the new version of the option that is easier to understand what
it does by name.

Follow-up to 82c53f821f
Closes #14497
This commit is contained in:
Daniel Stenberg 2024-08-12 09:58:34 +02:00
parent f4376b5c74
commit 4e51437de2
No known key found for this signature in database
GPG Key ID: 5CC908FDB71E12C2
3 changed files with 8 additions and 7 deletions

View File

@ -20,7 +20,7 @@ Example:
If the server reports that the requested page has moved to a different If the server reports that the requested page has moved to a different
location (indicated with a Location: header and a 3XX response code), this location (indicated with a Location: header and a 3XX response code), this
option makes curl redo the request on the new place. If used together with option makes curl redo the request on the new place. If used together with
--include or --head, headers from all requested pages are shown. --show-headers or --head, headers from all requested pages are shown.
When authentication is used, curl only sends its credentials to the initial When authentication is used, curl only sends its credentials to the initial
host. If a redirect takes curl to a different host, it does not get the host. If a redirect takes curl to a different host, it does not get the

View File

@ -11,12 +11,13 @@ See-also:
- show-headers - show-headers
- proxytunnel - proxytunnel
Example: Example:
- --suppress-connect-headers --include -x proxy $URL - --suppress-connect-headers --show-headers -x proxy $URL
--- ---
# `--suppress-connect-headers` # `--suppress-connect-headers`
When --proxytunnel is used and a CONNECT request is made do not output proxy When --proxytunnel is used and a CONNECT request is made do not output proxy
CONNECT response headers. This option is meant to be used with --dump-header or CONNECT response headers. This option is meant to be used with --dump-header
--include which are used to show protocol headers in the output. It has no or --show-headers which are used to show protocol headers in the output. It
effect on debug options such as --verbose or --trace, or any statistics. has no effect on debug options such as --verbose or --trace, or any
statistics.

View File

@ -25,8 +25,8 @@ what's going on under the hood. A line starting with \> means header data sent
by curl, \< means header data received by curl that is hidden in normal cases, by curl, \< means header data received by curl that is hidden in normal cases,
and a line starting with * means additional info provided by curl. and a line starting with * means additional info provided by curl.
If you only want HTTP headers in the output, --include or --dump-header might If you only want HTTP headers in the output, --show-headers or --dump-header
be more suitable options. might be more suitable options.
Since curl 8.10, mentioning this option several times in the same argument Since curl 8.10, mentioning this option several times in the same argument
increases the level of the trace output. However, as before, a single increases the level of the trace output. However, as before, a single