Modified: trunk/launchd/src/libvproc_public.h (23523 => 23524)

--- 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