diff --git a/docs/changes.txt b/docs/changes.txt
index 70ccbeb244..48230da796 100644
--- a/docs/changes.txt
+++ b/docs/changes.txt
@@ -96,6 +96,9 @@ Changes in behaviour not resulting in compilation errors
 - wxAuiNotebook::RemovePage() now hides the removed page, so it needs to be
   shown again if it is reused in another place.
 
+- wxSizer::RecalcSizes() shouldn't be called directly (note that it was never
+  supposed to be called, only implemented), call Layout() instead.
+
 
 Changes in behaviour which may result in build errors
 -----------------------------------------------------
diff --git a/interface/wx/sizer.h b/interface/wx/sizer.h
index 69f6d6a347..30e7a277fa 100644
--- a/interface/wx/sizer.h
+++ b/interface/wx/sizer.h
@@ -733,6 +733,10 @@ public:
         total size available to the sizer (@c m_size) and the size computed by
         the last call to CalcMin().
 
+        Note that you should never call this method directly, call Layout()
+        instead if you need to manually update the sizer elements positions.
+        This method is only called by wxWidgets itself.
+
         @since 3.1.3, before this version RecalcSizes() method not taking any
             arguments had to be overridden in the derived classes instead.
     */