Merge branch 'toolkits-docs' into 'master'

A couple of documents for devel-docs

See merge request GNOME/at-spi2-core!89

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)