From: Jonathan Maw <jonathan.maw@codethink.co.uk>
Date: Tue, 7 Aug 2012 09:02:37 +0000 (+0100)
Subject: Add an explanation of the JobManagerCallback
X-Git-Tag: node-startup-controller-1.0.0~30
X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=cfbab85e29ecfe19fadfe9bfaa04fda46c4690ec;p=profile%2Fivi%2Fnode-startup-controller.git

Add an explanation of the JobManagerCallback
---

diff --git a/node-startup-controller/job-manager.h b/node-startup-controller/job-manager.h
index 9eed6b2..4d3390f 100644
--- a/node-startup-controller/job-manager.h
+++ b/node-startup-controller/job-manager.h
@@ -24,6 +24,18 @@ G_BEGIN_DECLS
 typedef struct _JobManagerClass JobManagerClass;
 typedef struct _JobManager      JobManager;
 
+/**
+ * JobManagerCallback:
+ * @manager:   The #JobManager object.
+ * @unit:      The name of the systemd unit to be started or stopped.
+ * @result:    The result of trying to start or stop the unit. Usually %success or %failed.
+ * @error:     The error (if any) raised by the start or stop method. %NULL if none 
+ *             occurred.
+ * @user_data: The user_data passed into the start or stop methods.
+ * 
+ * The JobManagerCallback is called when job_manager_start() or job_manager_stop()
+ * finishes. 
+ */
 typedef void (*JobManagerCallback) (JobManager  *manager,
                                     const gchar *unit,
                                     const gchar *result,