dbus: Update OSK0 protocol from phosh

No functional change. Let's just make sure people copy pasting from here
get the commented version.

Part-of: <https://gitlab.gnome.org/World/Phosh/squeekboard/-/merge_requests/678>

data/dbus/sm.puri.OSK0.xml

@@ -1,20 +1,31 @@
 <!DOCTYPE node PUBLIC "-//freedesktop//DTD D-BUS Object Introspection 1.0//EN"
 "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 <node xmlns:doc="http://www.freedesktop.org/dbus/1.0/doc.dtd">
+
+  <!--
+      sm.puri.OSK0:
+
+      This interface is exported by on screen keyboards (OSK) to
+      indicate and set state like visibility.
+  -->
+
   <interface name="sm.puri.OSK0">
+    <!--
+        SetVisible:
+        @visible: %TRUE if the OSK should be shown to the user, %FALSE otherwise
+
+        Toggle keyboard visibility.
+    -->
     <method name="SetVisible">
-      <arg name="visible" type="b" direction="in"/>
+      <arg type="b" direction="in" name="visible"/>
-      <doc:doc><doc:description>
-        Switch keyboard visibility
-      </doc:description></doc:doc>
     </method>
-    <method name="GetVisible">
+    <!--
-      <arg name="visible" type="b" direction="out"/>
+        Visible:
-      <doc:doc><doc:description>
+
-        Get keyboard visibility
+        Indicates whether the on screen keyboard is currently
-      </doc:description></doc:doc>
+        unfolded. %TRUE if the OSK is currently visible to the user,
-    </method>
+        %FALSE otherwise.
-    <property name="Visible" type="b" access="read">
+    -->
-    </property>
+    <property name="Visible" type="b" access="read"/>
   </interface>
 </node>