summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMike Gorse <mgorse@suse.com>2023-01-09 15:49:54 -0600
committerMike Gorse <mgorse@suse.com>2023-01-09 15:49:54 -0600
commita6d486411942c4ebea59eb9bedf7c1bbf6d81f23 (patch)
tree12cd0f0e38dc11915204032740fa020902ebc8f5
parenteb268c1dab213a0717d4cf860867ab9e3c7d2826 (diff)
downloadat-spi2-core-a6d486411942c4ebea59eb9bedf7c1bbf6d81f23.tar.gz
Add a devel doc to collect proposed AT-SPI 3 changes
-rw-r--r--devel-docs/at-spi3.rst22
-rw-r--r--devel-docs/meson.build1
-rw-r--r--devel-docs/roadmap.rst1
3 files changed, 24 insertions, 0 deletions
diff --git a/devel-docs/at-spi3.rst b/devel-docs/at-spi3.rst
new file mode 100644
index 00000000..c1cf0e97
--- /dev/null
+++ b/devel-docs/at-spi3.rst
@@ -0,0 +1,22 @@
+AT-SPI 3 roadmap
+================
+
+This document is a place to collect changes that we should consider for a
+future version of the API.
+
+- Remove ATSPI_COORD_TYPE_SCREEN. It cannot be supported under Wayland.
+
+- Remove the legacy device event controller API. AtspiDevice should handle
+ things related to the keyboard and mouse.
+
+- Eliminate the registry daemon. The new device API no longer uses it for
+ key grabs (except for the existing legacy back end), and the mouse could
+ similarly be handled in-process. Aside from the device event controller,
+ the registry daemon currently keeps a list of applications and registerd
+ events, but querying applications could be done with a DBus signal that
+ applications could then respond to, and applications could similarly
+ query consumers for a list of events that they care about.
+
+- The DBus API for sending events should be reviewed. TODO: flesh this out.
+
+- The AtspiEventListener API is hard to use and also needs to be reworked.
diff --git a/devel-docs/meson.build b/devel-docs/meson.build
index b405df4f..4403fa49 100644
--- a/devel-docs/meson.build
+++ b/devel-docs/meson.build
@@ -58,6 +58,7 @@ interfaces_rst = custom_target(
docs_sources = [
'atk-deprecations.rst',
+ 'at-spi3.rst',
'conf.py',
'de-controller.rst',
'gitlab-ci.rst',
diff --git a/devel-docs/roadmap.rst b/devel-docs/roadmap.rst
index 3f194f14..ca0de7ad 100644
--- a/devel-docs/roadmap.rst
+++ b/devel-docs/roadmap.rst
@@ -4,6 +4,7 @@ Accessibility infrastructure roadmap
Note that this roadmap refers exclusively to **cleanups** and **paying
technical debt**. It does not yet refer to actually changing the
accessibility interfaces, or the way accessibility works in general.
+Possible API changes are discussed in a separate document.
High level goals, detailed below
--------------------------------