Open Radar

 
Summary:

UIAccessibilityElement and UIAccessibilityProtocol list accessibilityFrame as:

"The frame of the accessibility element, in screen coordinates."

http://developer.apple.com/library/ios/#documentation/uikit/reference/UIAccessibilityElement_Class/Reference/Reference.html
http://developer.apple.com/library/ios/#documentation/uikit/reference/UIAccessibility_Protocol/Introduction/Introduction.html

Whereas UIAccessibilityReadingContent lists method accessibilityFrameForLineNumber as:

Returns the onscreen frame associated with the specified line number.

but also includes a small code snippet to demonstrate this in the description:

CGRect lineBounds = // The bounds of the line in view space.
UIWindow *window = [view window];
lineBounds = [view convertRect:lineBounds toView:window];
if (window != nil)
{
   lineBounds = [window convertRect:lineBounds toWindow:nil];
}
return lineBounds;

which is much clearer.

https://developer.apple.com/library/ios/#documentation/UIKit/Reference/UIAccessibilityReadingContent_Protocol/Introduction/Introduction.html

Steps to Reproduce:

Read the linked docs

Expected Results:

Consistent documentation of related material

Actual Results:

Inconsistent documentation

Regression:

Notes:

A code snippet isn't necessarily needed in all the spots, a link out to clarify screen coordinates might suffice.