diff --git a/src/gui/image/qicon.cpp b/src/gui/image/qicon.cpp
index 008497a04ef..1bea0662b9a 100644
--- a/src/gui/image/qicon.cpp
+++ b/src/gui/image/qicon.cpp
@@ -859,7 +859,9 @@ QPixmap QIcon::pixmap(const QSize &size, Mode mode, State state) const
   \since 6.0
 
   Returns a pixmap with the requested \a size, \a devicePixelRatio, \a mode, and \a
-  state, generating one if necessary.
+  state, generating one with the given \a mode and \a state if necessary. The pixmap
+  might be smaller than requested, but never larger, unless the device-pixel ratio
+  of the returned pixmap is larger than 1.
 
   \sa  actualSize(), paint()
 */