diff --git a/docs/doxygen/overviews/log.h b/docs/doxygen/overviews/log.h
index f5bc7f4944..63cbc7c096 100644
--- a/docs/doxygen/overviews/log.h
+++ b/docs/doxygen/overviews/log.h
@@ -31,8 +31,9 @@ of arguments or a variable argument list pointer. Here are all of them:
 @li wxLogError() is the function to use for error messages, i.e. the messages
     that must be shown to the user. The default processing is to pop up a
     message box to inform the user about it.
-@li wxLogWarning() for warnings. They are also normally shown to the user, but
-    don't interrupt the program work.
+@li wxLogWarning() for warnings, i.e. messages that are less severe than errors
+    but still should normally be brought to the user's attention. The default
+    processing is to show them in a message box, just as for the errors.
 @li wxLogMessage() is for all normal, informational messages. They also appear in
     a message box by default (but it can be changed, see below).
 @li wxLogVerbose() is for verbose output. Normally, it is suppressed, but might
diff --git a/interface/wx/log.h b/interface/wx/log.h
index a94a6d0248..834dbef0b3 100644
--- a/interface/wx/log.h
+++ b/interface/wx/log.h
@@ -1517,8 +1517,11 @@ void wxVLogVerbose(const char* formatString, va_list argPtr);
 /** @addtogroup group_funcmacro_log */
 ///@{
 /**
-    For warnings - they are also normally shown to the user, but don't
-    interrupt the program work.
+    The function to use for warning messages.
+
+    Warnings are less severe than errors but still should normally be
+    brought to the user's attention. The default processing is to show them
+    in a message box.
 
     @header{wx/log.h}
 */