Merge 0aea744 into f4ba1b4

doc/dbus/org.opensuse.Agama.Network1.Connection.IPv4.doc.xml

@@ -3,9 +3,30 @@
  "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 <node>
   <interface name="org.opensuse.Agama.Network1.Connection.IPv4">
-    <property name="Addresses" type="a(su)" access="readwrite"/>
+    <!--
+     List of IP addresses.
+
+     When the method is 'auto', these addresses are used as additional addresses.
+     -->
+    <property name="Addresses" type="as" access="readwrite"/>
+    <!--
+     Network gateway.
+
+     An empty string removes the current value. It is not possible to set a gateway if the
+     addresses property is empty.
+     -->
     <property name="Gateway" type="s" access="readwrite"/>
-    <property name="Method" type="y" access="readwrite"/>
+    <!--
+     IP configuration method.
+
+     Possible values: "disabled", "auto", "manual" or "link-local".
+
+     See [crate::model::IpMethod].
+     -->
+    <property name="Method" type="s" access="readwrite"/>
+    <!--
+     Name server addresses.
+     -->
     <property name="Nameservers" type="as" access="readwrite"/>
   </interface>
 </node>

doc/dbus/org.opensuse.Agama.Network1.Connection.Wireless.doc.xml

@@ -3,10 +3,58 @@
  "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 <node>
   <interface name="org.opensuse.Agama.Network1.Connection.Wireless">
-    <property name="Mode" type="y" access="readwrite"/>
+    <!--
+     Wireless connection mode.
+
+     Possible values: "unknown", "adhoc", "infrastructure", "ap" or "mesh".
+
+     See [crate::model::WirelessMode].
+     -->
+    <property name="Mode" type="s" access="readwrite"/>
+    <!--
+     Password to connect to the wireless network.
+     -->
     <property name="Password" type="s" access="readwrite"/>
+    <!--
+     Network SSID.
+     -->
     <property name="SSID" type="ay" access="readwrite"/>
-    <property name="Security" type="y" access="readwrite"/>
+    <!--
+     Wireless security protocol.
+
+     Possible values: "none", "owe", "ieee8021x", "wpa-psk", "sae", "wpa-eap",
+     "wpa-eap-suite-b192".
+
+     See [crate::model::WirelessMode].
+     -->
+    <property name="Security" type="s" access="readwrite"/>
+  </interface>
+  <interface name="org.opensuse.Agama.Network1.Connection.IPv4">
+    <!--
+     List of IP addresses.
+
+     When the method is 'auto', these addresses are used as additional addresses.
+     -->
+    <property name="Addresses" type="as" access="readwrite"/>
+    <!--
+     Network gateway.
+
+     An empty string removes the current value. It is not possible to set a gateway if the
+     addresses property is empty.
+     -->
+    <property name="Gateway" type="s" access="readwrite"/>
+    <!--
+     IP configuration method.
+
+     Possible values: "disabled", "auto", "manual" or "link-local".
+
+     See [crate::model::IpMethod].
+     -->
+    <property name="Method" type="s" access="readwrite"/>
+    <!--
+     Name server addresses.
+     -->
+    <property name="Nameservers" type="as" access="readwrite"/>
   </interface>
 </node>
 

doc/dbus/org.opensuse.Agama.Network1.Connection.doc.xml

@@ -3,8 +3,14 @@
  "http://www.freedesktop.org/standards/dbus/1.0/introspect.dtd">
 <node>
   <interface name="org.opensuse.Agama.Network1.Connection">
+    <!--
+     Connection ID.
+
+     Unique identifier of the network connection. It may or not be the same that the used by the
+     backend. For instance, when using NetworkManager (which is the only supported backend by
+     now), it uses the original ID but appending a number in case the ID is duplicated.
+     -->
     <property name="Id" type="s" access="read"/>
-    <property name="UUID" type="s" access="read"/>
   </interface>
 </node>
 

doc/dbus/org.opensuse.Agama.Network1.Connections.doc.xml

@@ -14,22 +14,31 @@
      AddConnection:
      Adds a new network connection.
 
-     * `name`: connection name.
-
+     * `id`: connection name.
      * `ty`: connection type (see [crate::model::DeviceType]).
      -->
     <method name="AddConnection">
-      <arg name="name" type="s" direction="in"/>
+      <arg name="id" type="s" direction="in"/>
       <arg name="ty" type="y" direction="in"/>
     </method>
+    <!--
+     GetConnection:
+     Returns the D-Bus path of the network connection.
+
+     * `id`: connection ID.
+     -->
+    <method name="GetConnection">
+      <arg name="id" type="s" direction="in"/>
+      <arg type="o" direction="out"/>
+    </method>
     <!--
      RemoveConnection:
      Removes a network connection.
 
      * `uuid`: connection UUID..
      -->
     <method name="RemoveConnection">
-      <arg name="uuid" type="s" direction="in"/>
+      <arg name="id" type="s" direction="in"/>
     </method>
     <!--
      Apply: