man: run dbus api docs through the updater

This replaces the api export tables with updated versions, and inserts
comments for all "undocumented" items. The slow work of documented them
is left for later ;)

lxml does some formatting changes that are not significant for lxml processing,
but generate spurious difference in the diff (namely: ulinks become one-line,
and double quotes are used instead of single quotes for element attribute
values). This should be a one-time thing: subsequent renegeration should be
idempotent with regards to this.

1 files changed, 75 insertions, 33 deletions

diff --git a/man/org.freedesktop.machine1.xml b/man/org.freedesktop.machine1.xml
index f26829ee45..1c9c41f04c 100644
--- a/man/org.freedesktop.machine1.xml
+++ b/man/org.freedesktop.machine1.xml
@@ -49,7 +49,7 @@ node /org/freedesktop/machine1 {
       GetMachineByPID(in  u pid,
                       out o machine);
       ListMachines(out a(ssso) machines);
-      ListImages(out a(ssbttto) machines);
+      ListImages(out a(ssbttto) images);
       CreateMachine(in  s name,
                     in  ay id,
                     in  s service,
@@ -82,10 +82,11 @@ node /org/freedesktop/machine1 {
                                  in  s root_directory,
                                  in  ai ifindices,
                                  out o path);
+      UnregisterMachine(in  s name);
+      TerminateMachine(in  s id);
       KillMachine(in  s name,
                   in  s who,
-                  in  s signal);
-      TerminateMachine(in  s id);
+                  in  i signal);
       GetMachineAddresses(in  s name,
                           out a(iay) addresses);
       GetMachineOSRelease(in  s name,
@@ -114,6 +115,10 @@ node /org/freedesktop/machine1 {
       CopyToMachine(in  s name,
                     in  s source,
                     in  s destination);
+      OpenMachineRootDirectory(in  s name,
+                               out h fd);
+      GetMachineUIDShift(in  s name,
+                         out u shift);
       RemoveImage(in  s name);
       RenameImage(in  s name,
                   in  s new_name);
@@ -122,16 +127,26 @@ node /org/freedesktop/machine1 {
                  in  b read_only);
       MarkImageReadOnly(in  s name,
                         in  b read_only);
+      GetImageHostname(in  s name,
+                       out s hostname);
+      GetImageMachineID(in  s name,
+                        out ay id);
+      GetImageMachineInfo(in  s name,
+                          out a{ss} machine_info);
+      GetImageOSRelease(in  s name,
+                        out a{ss} os_release);
       SetPoolLimit(in  t size);
       SetImageLimit(in  s name,
                     in  t size);
+      CleanPool(in  s mode,
+                out a(st) images);
       MapFromMachineUser(in  s name,
                          in  u uid_inner,
                          out u uid_outer);
       MapToMachineUser(in  u uid_outer,
                        out s machine_name,
                        out o machine_path,
-                       out u uid_inner;
+                       out u uid_inner);
       MapFromMachineGroup(in  s name,
                           in  u gid_inner,
                           out u gid_outer);
@@ -145,16 +160,16 @@ node /org/freedesktop/machine1 {
       MachineRemoved(s machine,
                      o path);
     properties:
-      readonly s PoolPath = '/var/lib/machines';
-      readonly t PoolUsage = 18446744070652059648;
-      readonly t PoolLimit = 2160721920;
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s PoolPath = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t PoolUsage = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly t PoolLimit = ...;
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
 </programlisting>
 
@@ -317,34 +332,61 @@ $ gdbus introspect --system \
         --dest org.freedesktop.machine1 \
         --object-path /org/freedesktop/machine1/machine/rawhide
 
-node /org/freedesktop/machine1/machine/fedora_2dtree {
+node /org/freedesktop/machine1/machine/rawhide {
   interface org.freedesktop.machine1.Machine {
     methods:
       Terminate();
       Kill(in  s who,
-           in  s signal);
+           in  i signal);
       GetAddresses(out a(iay) addresses);
       GetOSRelease(out a{ss} fields);
-    signals:
+      GetUIDShift(out u shift);
+      OpenPTY(out h pty,
+              out s pty_path);
+      OpenLogin(out h pty,
+                out s pty_path);
+      OpenShell(in  s user,
+                in  s path,
+                in  as args,
+                in  as environment,
+                out h pty,
+                out s pty_path);
+      BindMount(in  s source,
+                in  s destination,
+                in  b read_only,
+                in  b mkdir);
+      CopyFrom(in  s source,
+               in  s destination);
+      CopyTo(in  s source,
+             in  s destination);
+      OpenRootDirectory(out h fd);
     properties:
-      readonly s Name = 'fedora-tree';
-      readonly ay Id = [0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00];
-      readonly t Timestamp = 1374193370484284;
-      readonly t TimestampMonotonic = 128247251308;
-      readonly s Service = 'nspawn';
-      readonly s Unit = 'machine-fedora\\x2dtree.scope';
-      readonly u Leader = 30046;
-      readonly s Class = 'container';
-      readonly s RootDirectory = '/home/lennart/fedora-tree';
-      readonly ai NetworkInterfaces = [7];
-      readonly s State = 'running';
-  };
-  interface org.freedesktop.DBus.Properties {
-  };
-  interface org.freedesktop.DBus.Peer {
-  };
-  interface org.freedesktop.DBus.Introspectable {
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Name = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly ay Id = [...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t Timestamp = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly t TimestampMonotonic = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Service = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Unit = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly u Leader = ...;
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s Class = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly s RootDirectory = '...';
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("const")
+      readonly ai NetworkInterfaces = [...];
+      @org.freedesktop.DBus.Property.EmitsChangedSignal("false")
+      readonly s State = '...';
   };
+  interface org.freedesktop.DBus.Peer { ... };
+  interface org.freedesktop.DBus.Introspectable { ... };
+  interface org.freedesktop.DBus.Properties { ... };
 };
     </programlisting>