After an evaluation, GNOME has moved from Bugzilla to GitLab. Learn more about GitLab.
No new issues can be reported in GNOME Bugzilla anymore.
To report an issue in a GNOME project, go to GNOME GitLab.
Do not go to GNOME Gitlab for: Bluefish, Doxygen, GnuCash, GStreamer, java-gnome, LDTP, NetworkManager, Tomboy.
Bug 650310 - Need to improve AtkRelation docs
Need to improve AtkRelation docs
Status: RESOLVED OBSOLETE
Product: atk
Classification: Platform
Component: docs
unspecified
Other All
: Normal normal
: ---
Assigned To: ATK maintainer(s)
ATK maintainer(s)
Depends on:
Blocks:
 
 
Reported: 2011-05-16 12:48 UTC by Joanmarie Diggs (IRC: joanie)
Modified: 2021-06-10 11:26 UTC
See Also:
GNOME target: ---
GNOME version: ---



Description Joanmarie Diggs (IRC: joanie) 2011-05-16 12:48:13 UTC
A developer indicated via IRC that documentation regarding accessible relations was not especially clear. Based on the discussion and looking at the docs [1], it seems what might be needed are some concrete examples and/or best practices.

[1] http://developer.gnome.org/atk/unstable/AtkRelation.html
Comment 1 André Klapper 2011-06-23 22:05:38 UTC
[Mass-reassigning open atk bug reports for better trackability as requested in https://bugzilla.gnome.org/show_bug.cgi?id=653179 .
PLEASE NOTE:
If you have watched the previous assignee of this bug report as a workaround for actually getting notified of changes in atk bugs, you yourself will now have to add atk-maint@gnome.bugs to your watchlist at the bottom of https://bugzilla.gnome.org/userprefs.cgi?tab=email to keep watching atk bug reports in GNOME Bugzilla.
Sorry for the noise: Feel free to filter for this comment in order to mass-delete the triggered bugmail.]
Comment 2 Joanmarie Diggs (IRC: joanie) 2016-05-03 20:38:21 UTC
I was reminded of this during a meeting today, when the question of what CONTROLLED_BY/CONTROLLER_FOR were appropriate for. And the docs failed to answer that question.

I think we should steal what the ARIA spec says for this AtkRelationType (and possibly others). And, yes, "we" almost certainly means "me." So this is mostly a note/ping to self.

In the meantime, here's the ARIA spec text for aria-controls:

===================
Identifies the element (or elements) whose contents or presence are controlled by the current element. See related aria-owns.

For example:

A table of contents tree view may control the content of a neighboring document pane.
A group of checkboxes may control what commodity prices are tracked live in a table or graph.
A tab controls the display of its associated tab panel.
===================

https://rawgit.com/w3c/aria/master/aria/aria.html#aria-controls
Comment 3 André Klapper 2021-06-10 11:26:51 UTC
GNOME is going to shut down bugzilla.gnome.org in favor of gitlab.gnome.org.
As part of that, we are mass-closing older open tickets in bugzilla.gnome.org
which have not seen updates for a longer time (resources are unfortunately
quite limited so not every ticket can get handled).

If you can still reproduce the situation described in this ticket in a recent
and supported software version of atk, then please follow
  https://wiki.gnome.org/GettingInTouch/BugReportingGuidelines
and create a ticket at
  https://gitlab.gnome.org/GNOME/atk/-/issues/

Thank you for your understanding and your help.