From: David Zeuthen <zeuthen@gmail.com>
Date: Tue, 2 Oct 2012 17:50:37 +0000 (-0400)
Subject: Add docs for udisks_linux_drive_ata_apply_configuration()
X-Git-Tag: upstream/2.1.2~123^2~9
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=8c3b220ecc67d15ea2207442929a207ff3d1de82;p=platform%2Fupstream%2Fudisks2.git

Add docs for udisks_linux_drive_ata_apply_configuration()

Signed-off-by: David Zeuthen <zeuthen@gmail.com>
---

diff --git a/src/udiskslinuxdriveata.c b/src/udiskslinuxdriveata.c
index 194e6b4..ab4f6eb 100644
--- a/src/udiskslinuxdriveata.c
+++ b/src/udiskslinuxdriveata.c
@@ -1957,8 +1957,17 @@ apply_configuration_thread_func (gpointer user_data)
   return NULL;
 }
 
+/**
+ * udisks_linux_drive_ata_apply_configuration:
+ * @drive: A #UDisksLinuxDriveAta.
+ * @device: A #GUdevDevice
+ * @configuration: The configuration to apply.
+ *
+ * Spawns a thread to apply @configuration to @drive, if any. Does not
+ * wait for the thread to terminate.
+ */
 void
-udisks_linux_drive_ata_apply_configuration (UDisksLinuxDriveAta     *ata,
+udisks_linux_drive_ata_apply_configuration (UDisksLinuxDriveAta     *drive,
                                             GUdevDevice             *device,
                                             GVariant                *configuration)
 {
@@ -1969,11 +1978,11 @@ udisks_linux_drive_ata_apply_configuration (UDisksLinuxDriveAta     *ata,
   data->ata_pm_standby = -1;
   data->ata_apm_level = -1;
   data->ata_aam_level = -1;
-  data->ata = g_object_ref (ata);
+  data->ata = g_object_ref (drive);
   data->device = g_object_ref (device);
   data->configuration = g_variant_ref (configuration);
 
-  data->object = udisks_daemon_util_dup_object (ata, NULL);
+  data->object = udisks_daemon_util_dup_object (drive, NULL);
   if (data->object == NULL)
     goto out;