[pulseaudio-commits] src/pulse

[Tanu Kaskinen]

 src/pulse/mainloop-api.h |    8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

New commits:
commit ee9037829a9ec7ec0c810a574fa41f789afb1b02
Author: Tanu Kaskinen <tanu.kaskinen at linux.intel.com>
Date:   Sat Mar 15 09:52:07 2014 +0200

    mainloop-api: Improve pa_mainloop_api_once() documentation

diff --git a/src/pulse/mainloop-api.h b/src/pulse/mainloop-api.h
index b4eccb1..d03e0e6 100644
--- a/src/pulse/mainloop-api.h
+++ b/src/pulse/mainloop-api.h
@@ -114,9 +114,11 @@ struct pa_mainloop_api {
     void (*quit)(pa_mainloop_api*a, int retval);
 };
 
-/** Run the specified callback function once from the main loop using an anonymous defer event. Note that this performs
- * multiple mainloop operations non-atomically. If, for example, you are using a \ref pa_threaded_mainloop, you will need to
- * take the mainloop lock before this call. */
+/** Run the specified callback function once from the main loop using an
+ * anonymous defer event. If the mainloop runs in a different thread, you need
+ * to follow the mainloop implementation's rules regarding how to safely create
+ * defer events. In particular, if you're using \ref pa_threaded_mainloop, you
+ * must lock the mainloop before calling this function. */
 void pa_mainloop_api_once(pa_mainloop_api*m, void (*callback)(pa_mainloop_api*m, void *userdata), void *userdata);
 
 PA_C_DECL_END