Grand Central Dispatch Documentation Incorrect

Originator:dylan
Number:rdar://9782264 Date Originated:7/15/2011
Status:Open Resolved:
Product:Documentation Product Version:4.0.2
Classification: Reproducible:Always
 
Summary: The documentation for the Grand Central Dispatch function `dispatch_get_global_queue` is incorrect. In the documentation, the `flags` are stated to be reserved; "This value is reserved for future use. You should always pass NULL." If you pass NULL, you obviously get a type conversion warning since the parameter is expecting an `unsigned long`. In the <dispatch/queue.h> header, it clearly states that if you do not pass a value of 0, the return value may be NULL. Please update the documentation to match the headers to prevent confusion.

Steps to Reproduce: N/A

Expected Results: N/A

Actual Results: N/A

Regression: N/A

Notes: N/A

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!