[launchd-changes] [23524] trunk/launchd/src/libvproc_public.h

[source_changes at macosforge.org]

Revision: 23524
          http://trac.macosforge.org/projects/launchd/changeset/23524
Author:   zarzycki at apple.com
Date:     2008-02-26 13:19:49 -0800 (Tue, 26 Feb 2008)

Log Message:
-----------
More feedback.

Modified Paths:
--------------
    trunk/launchd/src/libvproc_public.h

Modified: trunk/launchd/src/libvproc_public.h
===================================================================
--- trunk/launchd/src/libvproc_public.h	2008-02-25 19:43:09 UTC (rev 23523)
+++ trunk/launchd/src/libvproc_public.h	2008-02-26 21:19:49 UTC (rev 23524)
@@ -67,11 +67,19 @@
  *
  * launchd jobs should update their property lists accordingly.
  *
- * LaunchServices uses private API to coordinate whether GUI applications
+ * LaunchServices uses private methods to coordinate whether GUI applications
  * have opted into this design.
  */
 
 /*!
+ * @typedef	vproc_transaction_t
+ *
+ * @abstract
+ * An opaque handle used to track outstanding transactions.
+ */
+typedef struct vproc_transaction_s *vproc_transaction_t;
+
+/*!
  * @function vproc_transaction_prepare
  *
  * @result
@@ -80,7 +88,7 @@
  * @abstract
  * Call this API before creating data that needs to be saved via I/O later.
  */
-void *
+vproc_transaction_t
 vproc_transaction_prepare(void);
 
 /*!
@@ -96,9 +104,17 @@
  * Calling this API with the same handle more than once is undefined.
  */
 void
-vproc_transaction_complete(void *handle);
+vproc_transaction_complete(vproc_transaction_t handle);
 
 /*!
+ * @typedef	vproc_standby_t
+ *
+ * @abstract
+ * An opaque handle used to track outstanding standby requests.
+ */
+typedef struct vproc_standby_s *vproc_standby_t;
+
+/*!
  * @function vproc_standby_prepare
  *
  * @result
@@ -108,7 +124,7 @@
  * Call this API before registering notifications. For example: timers network
  * state change, or when monitoring keyboard/mouse events.
  */
-void *
+vproc_standby_t
 vproc_standby_prepare(void);
 
 /*!
@@ -124,7 +140,7 @@
  * Calling this API with the same handle more than once is undefined.
  */
 void
-vproc_standby_complete(void *handle);
+vproc_standby_complete(vproc_standby_t handle);
 
 #pragma GCC visibility pop
 

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.macosforge.org/pipermail/launchd-changes/attachments/20080226/05e2b929/attachment-0001.html