From 3c2e8e3484d670aeb42e540b409543fe01ac5bb9 Mon Sep 17 00:00:00 2001
From: Michael Meeks <michael.meeks@collabora.com>
Date: Mon, 2 Dec 2013 11:54:28 +0000
Subject: [PATCH] add health warning on osl condition.

Change-Id: I24619afb8b1ea0410e95e60fe70b5166e18fab44
---
 include/osl/conditn.hxx | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/include/osl/conditn.hxx b/include/osl/conditn.hxx
index 5ca0323c2aa8..337d651ab2a0 100644
--- a/include/osl/conditn.hxx
+++ b/include/osl/conditn.hxx
@@ -29,7 +29,14 @@
 
 namespace osl
 {
-
+    /**
+     * Warning: the Condition abstraction is inadequate for any
+     * situation where there may be multiple threads setting,
+     * waiting, and resetting the same condition. It can only be
+     * used to synchronise interactions between two threads
+     * cf. lost wakeups in:
+     *    http://www.cs.wustl.edu/~schmidt/win32-cv-1.html
+     */
     class Condition
     {
     public: