doc: Clarify effect of QFont::NoFontMerging

There have been reports of several people who expect
QFont::NoFontMerging to turn off all automatic resolution of fonts
when displaying text. However, the flag only turns off automatic
font resolution within a script item. Suitable fonts for scripts not
supported by the current font are still picked automatically. We cannot
change the behavior of QFont::NoFontMerging, so the documentation has
been made clearer and task QTBUG-9816 has been created to implement a
new style strategy flag that supports the use case.

Task-number: QTBUG-1732
Reviewed-by: Trond

1 files changed, 5 insertions, 3 deletions

diff --git a/src/gui/text/qfont.cpp b/src/gui/text/qfont.cpp
index cb16a16..24887b5 100644
--- a/src/gui/text/qfont.cpp
+++ b/src/gui/text/qfont.cpp
@@ -1286,9 +1286,11 @@ QFont::StyleHint QFont::styleHint() const
     \value PreferAntialias antialias if possible.
     \value OpenGLCompatible forces the use of OpenGL compatible
            fonts.
-    \value NoFontMerging If a font does not contain a character requested
-           to draw then Qt automatically chooses a similar looking for that contains
-           the character. This flag disables this feature.
+    \value NoFontMerging If the font selected for a certain writing system
+           does not contain a character requested to draw, then Qt automatically chooses a similar
+           looking font that contains the character. The NoFontMerging flag disables this feature.
+           Please note that enabling this flag will not prevent Qt from automatically picking a
+           suitable font when the selected font does not support the writing system of the text.
 
     Any of these may be OR-ed with one of these flags: