Warning

diff --git a/src/misc/pthread.c b/src/misc/pthread.c
index 644bf50f9333223b1de3dd28b85e7299bf1c1aaf..068cfa8fa771c120de37acfb74884edb348a56dd 100644 (file)
--- a/src/misc/pthread.c
+++ b/src/misc/pthread.c
@@ -584,9 +584,11 @@ void vlc_cancel (vlc_thread_t thread_id)
 }
 
 /**
- * Waits for a thread to complete (if needed), and destroys it.
+ * Waits for a thread to complete (if needed), then destroys it.
  * This is a cancellation point; in case of cancellation, the join does _not_
  * occur.
+ * @warning
+ * A thread cannot join itself (normally VLC will abort if this is attempted).
  *
  * @param handle thread handle
  * @param p_result [OUT] pointer to write the thread return value or NULL