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

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

Projects

None yet

2 participants

@jidanni
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 added a commit that closed this issue Jan 7, 2017
@bagder bagder docs/page-header: mention how to disable the progress meter
curl.1 is regenerated

Fixes #1190
e8404ad
@bagder bagder closed this in e8404ad Jan 7, 2017
@bagder bagder added a commit that referenced this issue Jan 7, 2017
@bagder bagder docs/silent: mention --show-error in --silent description
Reported in #1190
Reported-by: Dan Jacobson
acd29dc
@bagder
Member
bagder commented Jan 7, 2017

Thanks for your report!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment