define wxHAS_ATOMIC_OPS only if native implementation is available; use fewer loop...

[wxWidgets.git] / interface / atomic.h

diff --git a/interface/atomic.h b/interface/atomic.h
index b2aba23510eab1e29590319553f53559835b899b..3767cd7f0ba5516cfa2b734a13774cbf92380268 100644 (file)
--- a/interface/atomic.h
+++ b/interface/atomic.h
@@ -17,14 +17,23 @@
 /**
     This function increments @a value in an atomic manner.
 
+    Whenever possible wxWidgets provides an efficient, CPU-specific,
+    implementation of this function. If such implementation is available, the
+    symbol wxHAS_ATOMIC_OPS is defined. Otherwise this function still exists
+    but is implemented in a generic way using a critical section which can be
+    prohibitively expensive for use in performance-sensitive code.
+
     @header{wx/atomic.h}
 */
 void wxAtomicInc(wxAtomicInt& value);
 
 /**
-    This function decrements value in an atomic manner. Returns 0 if value is 0
-    after decrementation or any non-zero value (not necessarily equal to the
-    value of the variable) otherwise.
+    This function decrements value in an atomic manner.
+
+    Returns 0 if value is 0 after decrement or any non-zero value (not
+    necessarily equal to the value of the variable) otherwise.
+
+    @see wxAtomicInc
 
     @header{wx/atomic.h}
 */