From c202385f3a3180459231e4e97ac587a9904a4f44 Mon Sep 17 00:00:00 2001
From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Sat, 18 Mar 2023 20:50:10 +0100
Subject: [PATCH] Add a note about icons to wxMessageDialog documentation

Explain that the requested icon is not always used.

Closes #23353.
---
 interface/wx/msgdlg.h | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/interface/wx/msgdlg.h b/interface/wx/msgdlg.h
index dc15707350..4ddf221d33 100644
--- a/interface/wx/msgdlg.h
+++ b/interface/wx/msgdlg.h
@@ -17,6 +17,12 @@ const char wxMessageBoxCaptionStr[] = "Message";
     This class represents a dialog that shows a single or multi-line message,
     with a choice of OK, Yes, No and Cancel buttons.
 
+    Note about icons: while this dialog defines a number of icon-related
+    styles, the actual icon may or not appear depending on the current platform
+    UI conventions. For example, default GTK theme doesn't use any icons at all
+    in the message dialogs while macOS does use an icon, but it uses the
+    application icon for the informational dialogs.
+
     @beginStyleTable
     @style{wxOK}
         Puts an Ok button in the message box. May be combined with @c wxCANCEL.