osl::Condition - add deprecated markup. Use std::condition_variable.

Change-Id: Id3488a46b12d41bada2711b135ca955259d6e448
Reviewed-on: https://gerrit.libreoffice.org/31176Reviewed-by: Michael Meeks <michael.meeks@collabora.com>
Tested-by: Michael Meeks <michael.meeks@collabora.com>

include/osl/conditn.h

@@ -17,7 +17,6 @@
  *   the License at http://www.apache.org/licenses/LICENSE-2.0 .
  */
 
-
 #ifndef INCLUDED_OSL_CONDITN_H
 #define INCLUDED_OSL_CONDITN_H
 
@@ -40,6 +39,10 @@ typedef enum {
 } oslConditionResult;
 
 /** Creates a condition.
+
+    @deprecated use C++11's std::condition_variable instead
+                for a more robust and helpful condition.
+
     The condition is in the reset-state.
     @returns 0 if condition could not be created.
 */

include/osl/conditn.hxx

@@ -32,6 +32,11 @@
 namespace osl
 {
     /**
+     * A deprecated condition.
+     *
+     * @deprecated use C++11's std::condition_variable instead
+     *             for a more robust and helpful condition.
+     *
      * 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
@@ -50,7 +55,11 @@ namespace osl
             result_timeout = osl_cond_result_timeout
         };
 
-        /* Create a condition.
+        /**
+         * Create a condition.
+         *
+         * @deprecated use C++11's std::condition_variable instead
+         *             for a more robust and helpful condition.
          */
         Condition()
         {