diff --git a/modules/juce_core/memory/juce_Atomic.h b/modules/juce_core/memory/juce_Atomic.h
index c74e9f4002..78bb4ef99a 100644
--- a/modules/juce_core/memory/juce_Atomic.h
+++ b/modules/juce_core/memory/juce_Atomic.h
@@ -135,7 +135,9 @@ namespace juce
 
      //==============================================================================
     #ifndef DOXYGEN
-     // This method has been deprecated as there is no equivalent method in std::atomic.
+     /* This method has been deprecated as there is no equivalent method in
+        std::atomic. Use compareAndSetBool instead.
+     */
      JUCE_DEPRECATED (Type compareAndSetValue (Type, Type) noexcept);
     #endif
  };