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

PROGRESS METER paragraph should mention -s, and -s paragraph should mention -S #1190

Closed
jidanni opened this issue Jan 5, 2017 · 1 comment

Comments

@jidanni
Copy link
Contributor

jidanni commented Jan 5, 2017

curl 7.51.0 man page says

PROGRESS METER
       curl normally displays a progress meter during  operations,  indicating
       the  amount  of  transferred  data,  transfer speeds and estimated time
       left, etc. The progress meter displays number of bytes and  the  speeds
       are  in  bytes per second. The suffixes (k, M, G, T, P) are 1024 based.
       For example 1k is 1024 bytes. 1M is 1048576 bytes.

       curl displays this data to the terminal by default, so  if  you  invoke
       curl  to do an operation and it is about to write data to the terminal,
       it disables the progress meter as otherwise it would mess up the output
       mixing progress meter and response data.

       If you want a progress meter for HTTP POST or PUT requests, you need to
       redirect the response output to a file, using shell  redirect  (>),  -o
       [file] or similar.

       It  is not the same case for FTP upload as that operation does not spit
       out any response data to the terminal.

       If you prefer a progress "bar" instead of the regular meter, -# is your
       friend.

Well also mention how to turn it off!
Maybe the only way to turn it off is to not use -o file
but instead use > file.
If alas that is the recommended case, please state so.

Wait, I found

       -s, --silent
              Silent  or  quiet  mode. Don't show progress meter or error mes-
              sages.  Makes Curl mute. It will still output the data  you  ask
              for, potentially even to the terminal/stdout unless you redirect
              it.

below. OK please also mention -s above.

And now I also just happened to luckily find

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

even farther below. OK be sure the -s paragraph mentions -S too!

So in conclusion, make sure the PROGRESS METER paragraph mentions -s,
and make sure the -s paragraph mentions -S. Thank you.

@bagder bagder closed this as completed in e8404ad Jan 7, 2017
bagder added a commit that referenced this issue Jan 7, 2017
@bagder
Copy link
Member

bagder commented Jan 7, 2017

Thanks for your report!

@lock lock bot locked as resolved and limited conversation to collaborators May 7, 2018
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Development

No branches or pull requests

2 participants