Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc: global options are rarely flagged #7457

Closed
jsoref opened this issue Jul 20, 2021 · 0 comments
Closed

doc: global options are rarely flagged #7457

jsoref opened this issue Jul 20, 2021 · 0 comments

Comments

@jsoref
Copy link
Contributor

@jsoref jsoref commented Jul 20, 2021

This mentions that there's such a thing as global options:

--next will reset all local options and only global ones will have their
values survive over to the operation following the --next instruction. Global
options include --verbose, --trace, --trace-ascii and --fail-early.

This tells us that it is one:

This option is global and does not need to be specified for each use of --next.

None of these do:

Enables a full trace dump of all incoming and outgoing data, including
descriptive information, to the given output file. Use "-" as filename to have
the output sent to stdout.
This is very similar to --trace, but leaves out the hex part and only shows
the ASCII part of the dump. It makes smaller output that might be easier to
read for untrained humans.
If this option is used several times, the last one will be used.

Prepends a time stamp to each trace or verbose line that curl displays.

Enables a full trace dump of all incoming and outgoing data, including
descriptive information, to the given output file. Use "-" as filename to have
the output sent to stdout. Use "%" as filename to have the output sent to
stderr.
If this option is used several times, the last one will be used.

Makes curl verbose during the operation. Useful for debugging and seeing
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, and a line starting with '*' means additional info provided by
curl.
If you only want HTTP headers in the output, --include might be the option
you're looking for.
If you think this option still doesn't give you enough details, consider using
--trace or --trace-ascii instead.
Use --silent to make curl really quiet.

Can't tell if these count:

Silent or quiet mode. Don't show progress meter or error messages. Makes Curl
mute. It will still output the data you ask for, potentially even to the
terminal/stdout unless you redirect it.
Use --show-error in addition to this option to disable progress meter but
still show error messages.

When used with --silent, it makes curl show an error message if it fails.

bagder added a commit that referenced this issue Jul 28, 2021
Mention options that are "global". A global command line option is one
that doesn't get reset at --next uses and therefore don't need to be
used again.

Reported-by: Josh Soref

Fixes #7457
@bagder bagder closed this in 9f488fa Jul 28, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Linked pull requests

Successfully merging a pull request may close this issue.

2 participants