Sorry to be picky, but... :)

On 27/07/2011 12:16 AM, Pete Brunet wrote:
> HRESULT isNamePreferred([out, retval] boolean* isPreferred);
I think I like this new method name.

> Indicates that a content author has provided ancillary text in addition
> to the primary text of an object and that the server has chosen to use
> that ancillary text for this object's accessible name in preference to
> object's primary text.
Perhaps "in preference to *the* object's primary text" (missing "the")

> Since this method is only useful when IAText is implemented I think this 
> method belongs in IAText instead of IA2_2.  In that case I'd remove the 
> S_FALSE return value.  Is that acceptable?
Makes sense. In that case, this sentence:
> This method is only useful when the IAccessibleText interface is
> implemented and a true value indicates that the accessible name is...
can be changed to just:
"A true value indicates that the accessible name is..."

If others disagree that this belongs in IAText, I think that sentence 
should be changed to:
"This method is only useful when the IAccessibleText interface is
implemented. In this case, a true value indicates that the accessible 
name is..."
(Currently, it sounds like it is only useful if a true value is 
returned. :))

Jamie

-- 
James Teh
Vice President, Developer
NV Access Inc, ABN 61773362390
Email: [email protected]
Web site: http://www.nvaccess.org/
_______________________________________________
Accessibility-ia2 mailing list
[email protected]
https://lists.linux-foundation.org/mailman/listinfo/accessibility-ia2

Reply via email to