diff options
author | Federico Mena Quintero <federico@gnome.org> | 2022-06-28 02:01:43 +0000 |
---|---|---|
committer | Federico Mena Quintero <federico@gnome.org> | 2022-06-28 02:01:43 +0000 |
commit | 05851c277c266b1bc4bf2fddd6462a65a3bc0946 (patch) | |
tree | 247a6318377d4876526b2a3b9284dfa2621def2e | |
parent | ee6295b078c5ef74900ba0a2ddbea3f7066f109e (diff) | |
parent | e85fb13d38137f7db37a111d396ea38348f85d5e (diff) | |
download | at-spi2-core-05851c277c266b1bc4bf2fddd6462a65a3bc0946.tar.gz |
Merge branch 'toolkits-docs' into 'master'
A couple of documents for devel-docs
See merge request GNOME/at-spi2-core!89
-rw-r--r-- | devel-docs/atk-deprecations.md | 24 | ||||
-rw-r--r-- | devel-docs/toolkits.md | 47 |
2 files changed, 71 insertions, 0 deletions
diff --git a/devel-docs/atk-deprecations.md b/devel-docs/atk-deprecations.md new file mode 100644 index 00000000..cf411cd4 --- /dev/null +++ b/devel-docs/atk-deprecations.md @@ -0,0 +1,24 @@ +# Deprecations in ATK that need work elsewhere + +`atk_document_get_locale()` and the corresponding field in the vtable +`AtkDocumentIface.get_document_locale` are documented as deprecated since 2013 (commit +97880727). However, WebKitGtk still seems to implement it; it should use +`AtkObjectClass.get_object_locale` instead. + +Note that Orca does not seem to use the `Document.GetLocale` method nor the +`Accessible.Locale` property, so probably the code above from WebKitGtk is not exercised. + +## AtkValue + +The following methods are deprecated in `AtkValueIface` since 2014 (commit 98838b2a): + +* `get_current_value` - replaced with `get_value_and_text` +* `set_current_value` - replaced with `set_value` + +And the following are replaced with `get_range`, which returns an `AtkRange` boxed type: + +* `get_maximum_value` +* `get_minimum_value` +* `get_minimum_increment` + +Firefox still does not implement `get_range`, `get_value_and_text`, `set_value`. See bug #71. diff --git a/devel-docs/toolkits.md b/devel-docs/toolkits.md new file mode 100644 index 00000000..fc04d103 --- /dev/null +++ b/devel-docs/toolkits.md @@ -0,0 +1,47 @@ +# Accessibility implementations in different toolkits + +## Toolkits that use the DBus APIs directly + +### GTK4 + +Sources: [`gtk4/gtk/a11y`](https://gitlab.gnome.org/GNOME/gtk/-/tree/main/gtk/a11y) + +## Qt5 + +Sources: [`qtbase/src/gui/accessible/linux`](https://github.com/qt/qtbase/tree/dev/src/gui/accessible/linux) + +## WebKit + +Sources: [`WebKit/Source/WebCore/accessibility/atspi`](https://github.com/WebKit/WebKit/tree/main/Source/WebCore/accessibility/atspi) + + +## Toolkits that use ATK + +## GTK3 + +Sources: [`gtk3/gtk/a11y`](https://gitlab.gnome.org/GNOME/gtk/-/tree/gtk-3-24/gtk/a11y) + +## gnome-shell / St / via clutter's cally + +Sources: [`mutter/clutter/clutter/cally`](https://gitlab.gnome.org/GNOME/mutter/-/tree/main/clutter/clutter/cally) + +## Mozilla Firefox + +Sources: [`gecko-dev/accessible/atk`](https://github.com/mozilla/gecko-dev/tree/master/accessible/atk) + +## Chromium + +Uses both ATK and libatspi? + +Sources: +* [`chromium/ui/accessibility/platform/*auralinux*`](https://github.com/chromium/chromium/tree/main/ui/accessibility/platform) (atk) +* [`chromium/ui/accessibility/platform/inspect/*auralinux*`](https://github.com/chromium/chromium/tree/main/ui/accessibility/platform/inspect) (atspi) +* [`chromium/content/browser/accessibility/*auralinux*`](https://github.com/chromium/chromium/tree/main/content/browser/accessibility/) (atspi and atk) + +## LibreOffice + +Sources: [`LibreOffice/core/vcl/unx/gtk3/a11y`](https://github.com/LibreOffice/core/tree/master/vcl/unx/gtk3/a11y) + +## Java Swing - via java-atk-wrapper + +Sources: [`java-atk-wrapper`](https://gitlab.gnome.org/GNOME/java-atk-wrapper) |