Document a gotcha with QIcon::addFile

addFile makes a QIcon not null, which may be a surprise if the path
given is bad.

Reviewed-by: Jens Bache-Wiig

1 files changed, 3 insertions, 0 deletions

diff --git a/src/gui/image/qicon.cpp b/src/gui/image/qicon.cpp
index 3c71f15b4d..53430ab0a9 100644
--- a/src/gui/image/qicon.cpp
+++ b/src/gui/image/qicon.cpp
@@ -854,6 +854,9 @@ void QIcon::addPixmap(const QPixmap &pixmap, Mode mode, State state)
     QImageWriter::supportedImageFormats() functions to retrieve a
     complete list of the supported file formats.
 
+    Note: When you add a non-empty filename to a QIcon, the icon becomes
+    non-null, even if the file doesn't exist or points to a corrupt file.
+
     \sa addPixmap()
  */
 void QIcon::addFile(const QString &fileName, const QSize &size, Mode mode, State state)