Created attachment 290940 [details] [review]
Proposed patch

+++ This bug was initially created as a clone of Bug #739981 +++

There is currently no AtspiRole type that reflects objects which meet all of the following criteria:

1. Contains accessible information directly (i.e. and not in a child object)
2. Has a role that is known by the implementor
3. Lacks a role with any semantic value for the end user
4. Is not something the user can interact with

If 1 were not the case, then ATSPI_ROLE_PANEL would make sense as its documented definition is "A generic container that is often used to group objects."

If 2 were not the case, then ATSPI_ROLE_UNKNOWN would make sense as its documented definition is "The object contains some Accessible information, but its role is not known."

As for why we cannot address 3 by changing the documentation of ATSPI_ROLE_UNKNOWN (which seems like the easiest way to go): Orca tends to not touch objects with ATSPI_ROLE_UNKNOWN. After all, if the implementor truly has no idea what the thing is, what should the AT do to provide access to it? What interfaces should it check for? What user actions are applicable? Does this accessible object even have a backing widget in the application? All bets are off with "unknown" objects....

If 4 were not the case, odds are that it's a frequently-encountered widget or container for which there is an appropriate AtspiRole.

As for the use case: See http://lists.w3.org/Archives/Public/public-pfwg/2014Nov/0131.html.

I'm attaching a patch which does two things: Adds ATSPI_ROLE_STATIC and updates the documentation for ATSPI_ROLE_TEXT (which is used by Gecko in ways that are inconsistent with the rest of our platform, but given the existing docs you cannot really blame Mozilla). The role and docs match what is proposed for ATK (see bug 739931).