Documentation of NSProgress fractionCompleted flips indeterminate

Originator:douglashill
Number:rdar://33800243 Date Originated:09-Aug-2017 04:02 pm
Status:Open Resolved:
Product:Documentation Product Version:Now
Classification:Other Bug Reproducible:Always
 
Summary:
The documentation of NSProgress fractionCompleted states:

> Setting both totalUnitCount and completedUnitCount properties to zero indicates that there is no progress to track; in this case, the indeterminate property returns NO

Should say ‘returns YES’ as stated in the documentation for indeterminate states:

> Progress is indeterminate when the value of both totalUnitCount and completedUnitCount are zero.

A trial test in code confirms that this should be YES when both counts are zero.

Steps to Reproduce:
Read https://developer.apple.com/documentation/foundation/nsprogress/1408579-fractioncompleted?language=objc

Expected Results:
Should say ‘returns YES’

Actual Results:
Says ‘returns NO’

Version:
Now

Notes:
It would make more sense to me if the progress was indeterminate whenever the totalUnitCount was zero. Currently a progress with a totalUnitCount of zero and a completedUnitCount above zero has a fractionCompleted of 1 and is not indeterminate, which I find surprising.

Comments


Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!