Move docs around a bit

Signed-off-by: David Zeuthen <davidz@redhat.com>

diff --git a/doc/udisks2-docs.xml b/doc/udisks2-docs.xml
index bfbaba5..0429835 100644 (file)
--- a/doc/udisks2-docs.xml
+++ b/doc/udisks2-docs.xml
@@ -196,25 +196,25 @@
       <xi:include href="xml/udisksthreadedjob.xml"/>
       <xi:include href="xml/udisksspawnedjob.xml"/>
     </chapter>
+    <chapter id="ref-daemon-linux-types">
+      <title>Linux-specific types</title>
+      <xi:include href="xml/udiskslinuxmanager.xml"/>
+      <xi:include href="xml/udiskslinuxprovider.xml"/>
+    </chapter>
     <chapter id="ref-daemon-drives">
       <title>Drives on Linux</title>
-      <xi:include href="xml/udiskslinuxdriveobject.xml"/>
       <xi:include href="xml/udiskslinuxdrive.xml"/>
       <xi:include href="xml/udiskslinuxdriveata.xml"/>
+      <xi:include href="xml/udiskslinuxdriveobject.xml"/>
     </chapter>
     <chapter id="ref-daemon-block-devices">
       <title>Block devices on Linux</title>
-      <xi:include href="xml/udiskslinuxblockobject.xml"/>
       <xi:include href="xml/udiskslinuxblock.xml"/>
       <xi:include href="xml/udiskslinuxfilesystem.xml"/>
       <xi:include href="xml/udiskslinuxencrypted.xml"/>
       <xi:include href="xml/udiskslinuxswapspace.xml"/>
       <xi:include href="xml/udiskslinuxloop.xml"/>
-    </chapter>
-    <chapter id="ref-daemon-linux-ifaces">
-      <title>Other Linux-specific interfaces</title>
-      <xi:include href="xml/udiskslinuxprovider.xml"/>
-      <xi:include href="xml/udiskslinuxmanager.xml"/>
+      <xi:include href="xml/udiskslinuxblockobject.xml"/>
     </chapter>
   </part>
 

diff --git a/src/udiskslinuxblock.c b/src/udiskslinuxblock.c
index 41a950e..7475157 100644 (file)
--- a/src/udiskslinuxblock.c
+++ b/src/udiskslinuxblock.c
@@ -49,9 +49,9 @@
 /**
  * SECTION:udiskslinuxblock
  * @title: UDisksLinuxBlock
- * @short_description: Block devices on Linux
+ * @short_description: Linux implementation of #UDisksBlockDevice
  *
- * This type provides an implementation of the #UDisksBlock
+ * This type provides an implementation of the #UDisksBlockDevice
  * interface on Linux.
  */
 

diff --git a/src/udiskslinuxencrypted.c b/src/udiskslinuxencrypted.c
index 336817e..29c753a 100644 (file)
--- a/src/udiskslinuxencrypted.c
+++ b/src/udiskslinuxencrypted.c
@@ -40,7 +40,7 @@
 /**
  * SECTION:udiskslinuxencrypted
  * @title: UDisksLinuxEncrypted
- * @short_description: Locking and unlocking encrypted devices Linux
+ * @short_description: Linux implementation of #UDisksEncrypted
  *
  * This type provides an implementation of the #UDisksEncrypted
  * interface on Linux.

diff --git a/src/udiskslinuxfilesystem.c b/src/udiskslinuxfilesystem.c
index 1d32b60..cdc1df7 100644 (file)
--- a/src/udiskslinuxfilesystem.c
+++ b/src/udiskslinuxfilesystem.c
@@ -43,7 +43,7 @@
 /**
  * SECTION:udiskslinuxfilesystem
  * @title: UDisksLinuxFilesystem
- * @short_description: Filesystem manipulation on Linux
+ * @short_description: Linux implementation of #UDisksFilesystem
  *
  * This type provides an implementation of the #UDisksFilesystem
  * interface on Linux.

diff --git a/src/udiskslinuxloop.c b/src/udiskslinuxloop.c
index 1790cbb..94bff9a 100644 (file)
--- a/src/udiskslinuxloop.c
+++ b/src/udiskslinuxloop.c
@@ -39,7 +39,7 @@
 /**
  * SECTION:udiskslinuxloop
  * @title: UDisksLinuxLoop
- * @short_description: Loop devices on Linux
+ * @short_description: Linux implementation of #UDisksLoop
  *
  * This type provides an implementation of the #UDisksLoop
  * interface on Linux.

diff --git a/src/udiskslinuxmanager.c b/src/udiskslinuxmanager.c
index 4c8e001..4b337b1 100644 (file)
--- a/src/udiskslinuxmanager.c
+++ b/src/udiskslinuxmanager.c
@@ -45,7 +45,7 @@
 /**
  * SECTION:udiskslinuxmanager
  * @title: UDisksLinuxManager
- * @short_description: Manager implementation on Linux
+ * @short_description: Linux implementation of #UDisksManager
  *
  * This type provides an implementation of the #UDisksManager
  * interface on Linux.

diff --git a/src/udiskslinuxprovider.c b/src/udiskslinuxprovider.c
index 76893e3..a36046c 100644 (file)
--- a/src/udiskslinuxprovider.c
+++ b/src/udiskslinuxprovider.c
@@ -35,10 +35,10 @@
 /**
  * SECTION:udiskslinuxprovider
  * @title: UDisksLinuxProvider
- * @short_description: Provider of Linux-specific objects
+ * @short_description: Provides Linux-specific objects
  *
- * This object is used to add/remove Linux specific objects. Right now
- * it handles #UDisksLinuxBlock and #UDisksLinuxDriveObject instances.
+ * This object is used to add/remove Linux specific objects of type
+ * #UDisksLinuxBlockObject and #UDisksLinuxDriveObject.
  */
 
 typedef struct _UDisksLinuxProviderClass   UDisksLinuxProviderClass;

diff --git a/src/udiskslinuxswapspace.c b/src/udiskslinuxswapspace.c
index 9499bb2..09f8d9d 100644 (file)
--- a/src/udiskslinuxswapspace.c
+++ b/src/udiskslinuxswapspace.c
@@ -40,7 +40,7 @@
 /**
  * SECTION:udiskslinuxswapspace
  * @title: UDisksLinuxSwapspace
- * @short_description: Swapspace manipulation on Linux
+ * @short_description: Linux implementation of #UDisksSwapspace
  *
  * This type provides an implementation of the #UDisksSwapspace interface
  * on Linux.