From 6e9fadbee2a02f40eef8cc95ad0b31d807c6f53e Mon Sep 17 00:00:00 2001
From: Evangelos Ribeiro Tzaras <devrtz@fortysixandtwo.eu>
Date: Mon, 27 Dec 2021 20:37:22 +0100
Subject: [PATCH] dbus: document states

---
 src/dbus/org.gnome.Calls.Call.xml | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/src/dbus/org.gnome.Calls.Call.xml b/src/dbus/org.gnome.Calls.Call.xml
index 9f6fad3..719614d 100644
--- a/src/dbus/org.gnome.Calls.Call.xml
+++ b/src/dbus/org.gnome.Calls.Call.xml
@@ -36,6 +36,16 @@
       <doc:summary>Silence the ringing</doc:summary>
     </doc:doc>
     <property name="Inbound" type="b" access="read"/>
+    <!--
+        State:
+
+        State of the call.
+        Valid states: 0 = Unknown, 1 = Active, 2 = Held,
+        3 = Dialing, 4 = Alerting (deprecated),
+        5 = Incoming, 6 = Waiting (deprecated), 7 = Disconnected
+
+        Unrecognized values should be considered equal to Unknown.
+    -->
     <property name="State" type="u" access="read"/>
     <property name="Id" type="s" access="read">
       <doc:doc>