dbus: use the annotations for documentation
[NetworkManager.git] / introspection / nm-agent-manager.xml
index 4b53675..52460ee 100644 (file)
@@ -4,45 +4,45 @@
   <interface name="org.freedesktop.NetworkManager.AgentManager">
 
     <method name="Register">
-      <tp:docstring>
+      <annotation name="org.gtk.GDBus.DocString" value="
         Called by secret Agents to register their ability to provide and save
         network secrets.
-      </tp:docstring>
+      " />
       <arg name="identifier" type="s" direction="in">
-        <tp:docstring>
+        <annotation name="org.gtk.GDBus.DocString" value="
           Identifies this agent; only one agent in each user session may use the
           same identifier.  Identifier formatting follows the same rules as
           D-Bus bus names with the exception that the ':' character is not
-          allowed.  The valid set of characters is "[A-Z][a-z][0-9]_-." and the
+          allowed.  The valid set of characters is &quot;[A-Z][a-z][0-9]_-.&quot; and the
           identifier is limited in length to 255 characters with a minimum
           of 3 characters.  An example valid identifier is 'org.gnome.nm-applet'
           (without quotes).
-        </tp:docstring>
+        " />
       </arg>
     </method>
 
     <method name="RegisterWithCapabilities">
-      <tp:docstring>
+      <annotation name="org.gtk.GDBus.DocString" value="
         Like Register() but indicates agent capabilities to NetworkManager.
-      </tp:docstring>
+      " />
       <arg name="identifier" type="s" direction="in">
-        <tp:docstring>
+        <annotation name="org.gtk.GDBus.DocString" value="
             See the Register() method's identifier argument.
-        </tp:docstring>
+        " />
       </arg>
       <arg name="capabilities" type="u" direction="in" tp:type="NM_SECRET_AGENT_CAPABILITIES">
-        <tp:docstring>
+        <annotation name="org.gtk.GDBus.DocString" value="
             Indicates various agent capabilities to NetworkManager.
-        </tp:docstring>
+        " />
       </arg>
     </method>
 
     <method name="Unregister">
-      <tp:docstring>
+      <annotation name="org.gtk.GDBus.DocString" value="
         Called by secret Agents to notify NetworkManager that they will no
         longer handle requests for network secrets.  Agents are automatically
         unregistered when they disconnect from D-Bus.
-      </tp:docstring>
+      " />
     </method>
 
   </interface>