Index: include/lldb/API/SBValue.h
===================================================================
--- include/lldb/API/SBValue.h
+++ include/lldb/API/SBValue.h
@@ -84,7 +84,7 @@
     ValueType
     GetValueType ();
 
-    // It will be only valid starting from the second time.
+    // If you call this on a newly created ValueObject, it will always return false. You need update its value before.
     bool
     GetValueDidChange ();
 
Index: include/lldb/Core/ValueObject.h
===================================================================
--- include/lldb/Core/ValueObject.h
+++ include/lldb/Core/ValueObject.h
@@ -649,7 +649,7 @@
     bool
     GetValueIsValid () const;
 
-    // It will be only valid starting from the second time.
+    // If you call this on a newly created ValueObject, it will always return false. You need update its value before.
     bool
     GetValueDidChange ();