X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=node-startup-controller%2Fjob-manager.c;h=85d4a0cf580f175f3b4b483b4d3fabb73e4c6201;hb=b180a1a98a2177315a306485acc019e9e27dfe32;hp=b2ee7adb35e6c90f058b7b47e712626140927235;hpb=33cfe299c84c4576057080e8fb99a0e4c12a147e;p=profile%2Fivi%2Fnode-startup-controller.git

diff --git a/node-startup-controller/job-manager.c b/node-startup-controller/job-manager.c
index b2ee7ad..85d4a0c 100644
--- a/node-startup-controller/job-manager.c
+++ b/node-startup-controller/job-manager.c
@@ -25,9 +25,20 @@
  * @short_description: Manages systemd jobs.
  * @stability: Internal
  * 
- * The Job Manager simplifies starting and stopping systemd units by handling all the
- * JobRemoved signals internally, so units can be started and stopped using
- * job_manager_start() and job_manager_stop().
+ * The #JobManager simplifies starting and stopping systemd units by handling all the
+ * D-Bus communication with the systemd manager internally. Units can be started and
+ * stopped using job_manager_start() and job_manager_stop() and will call the @callback
+ * passed to the function when the unit is started or stopped.
+ * 
+ * The #JobManager contains an internal table which associates systemd job names with the
+ * necessary information about that job, e.g. the unit name.
+ * 
+ * When the #JobManager is told to start or stop a unit, it creates a job in systemd to
+ * start or stop that unit, stores the name of that job and waits until that job has
+ * finished before calling the @callback.
+ * 
+ * The #JobManager finds out that a job has finished by listening to "JobRemoved" signals
+ * from systemd and looking for that job by its job name.
  */