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!