Okay perhaps this is even less ambiguous:
When CURLOPT_NOPROGRESS is set to 0, enabling progress calculations, this
function will be called instead of its internal equivalent.
This function is called multiple times per second when data is being
transfered, and roughly every second when
not.
OR
This function is called at least once a second, and generally many times per
second when data is being transfered quickly.
________________________________
From: NSRT Mail account. <[email protected]>
To: Daniel Stenberg <[email protected]>; libcurl development
<[email protected]>
Sent: Friday, June 14, 2013 12:59 AM
Subject: Re: PROGRESSFUNCTION does not work as described
How about:
When CURLOPT_NOPROGRESS is set to 0, this function will be called instead of
its internal equivalent.
This function is called multiple times per second when data is being
transfered, and roughly every second when not.
________________________________
From: Daniel Stenberg <[email protected]>
To: NSRT Mail account. <[email protected]>; libcurl development
<[email protected]>
Sent: Friday, June 14, 2013 12:31 AM
Subject: Re: PROGRESSFUNCTION does not work as described
On Thu, 13 Jun 2013, NSRT Mail account. wrote:
>> with a frequent interval during operation (roughly once per second or sooner)
>
> Perhaps the meaning is ambiguous, but the documentation suggests that the
> callback is generally called once per second, and sometimes a little bit
> more. Meaning the expectation is that if an operation takes 100 seconds, the
> callback will be called 100 times, or 100 times plus a small percentage.
I don't think the calling frequency is a problem. I think the documentation can
be improved, indeed. The phrasing originates from the old days and it haven't
kept up with the code changes.
Suggestions?
--
/ daniel.haxx.se
-------------------------------------------------------------------
List admin: http://cool.haxx.se/list/listinfo/curl-library
Etiquette: http://curl.haxx.se/mail/etiquette.html
-------------------------------------------------------------------
List admin: http://cool.haxx.se/list/listinfo/curl-library
Etiquette: http://curl.haxx.se/mail/etiquette.html
