[at-spi2-core: 1/4] Start a document with ATK deprecations that need work elsewhere

[Federico Mena Quintero <federico src gnome org>]

commit 8b1643271129673a90273fb8f21f9ab157c961d2
Author: Federico Mena Quintero <federico gnome org>
Date:   Thu Jun 16 19:28:54 2022 -0500

    Start a document with ATK deprecations that need work elsewhere

 devel-docs/atk-deprecations.md | 9 +++++++++
 1 file changed, 9 insertions(+)
---
diff --git a/devel-docs/atk-deprecations.md b/devel-docs/atk-deprecations.md
new file mode 100644
index 00000000..0ea33e2f
--- /dev/null
+++ b/devel-docs/atk-deprecations.md
@@ -0,0 +1,9 @@
+# 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.