diff --git a/src/corelib/text/qstring.cpp b/src/corelib/text/qstring.cpp
index 52a9c65fc8d..271af2b8751 100644
--- a/src/corelib/text/qstring.cpp
+++ b/src/corelib/text/qstring.cpp
@@ -3914,6 +3914,8 @@ QString &QString::replace(QChar c, QLatin1StringView after, Qt::CaseSensitivity
     Returns \c true if string \a s1 is equal to string \a s2; otherwise
     returns \c false.
 
+    \include qstring.cpp compare-isNull-vs-isEmpty
+
     \sa {Comparing Strings}
 */
 
@@ -6287,6 +6289,11 @@ QString& QString::fill(QChar ch, qsizetype size)
 
     \snippet qstring/main.cpp 16
 
+//! [compare-isNull-vs-isEmpty]
+    \note This function treats null strings the same as empty strings,
+    for more details see \l {Distinction Between Null and Empty Strings}.
+//! [compare-isNull-vs-isEmpty]
+
     \sa operator==(), operator<(), operator>(), {Comparing Strings}
 */