From e2ca4072142c0cd9c4acce5b6a511e5d8d3de0c5 Mon Sep 17 00:00:00 2001
From: Mike Gorse <mgorse@suse.com>
Date: Tue, 28 Mar 2023 04:16:21 -0500
Subject: xml: document that GetIndexInParent can return -1

GetIndexInParent might return -1 for a top-level object or where an
index is not available. For instance, atk defaults to returning -1 if the
object's class does not provide a get_index_in_parent function. This puts
the xml documentation in line with the atk and libatspi documentation.
---
 xml/Accessible.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/xml/Accessible.xml b/xml/Accessible.xml
index 5619930e..2ada7005 100644
--- a/xml/Accessible.xml
+++ b/xml/Accessible.xml
@@ -113,7 +113,8 @@
         GetIndexInParent:
 
         Returns the 0-based index at which the object would be returned by calling
-        GetChildren on its parent.
+        GetChildren on its parent, or -1 if the object has no containing
+        parent or on exception.
     -->
     <method name="GetIndexInParent">
       <arg direction="out" type="i"/>
-- 
cgit v1.2.1