From 57246c7515889d82a81a95043f51a9f42d902216 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Samuel=20R=C3=B8dal?= <samuel.rodal@digia.com>
Date: Thu, 22 Nov 2012 12:36:25 +0100
Subject: [PATCH] Improved documentation of Text.textFormat property.

Even though using RichText is not recommended, we should still at least
point out what it does.

Change-Id: I96d0e1e7074b5fdbb3a5dcaf84e5afe805c92080
Reviewed-by: Eskil Abrahamsen Blomfeldt <eskil.abrahamsen-blomfeldt@digia.com>
---
 src/quick/items/qquicktext.cpp | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/src/quick/items/qquicktext.cpp b/src/quick/items/qquicktext.cpp
index 14c386d633..01136d56de 100644
--- a/src/quick/items/qquicktext.cpp
+++ b/src/quick/items/qquicktext.cpp
@@ -1908,7 +1908,7 @@ void QQuickText::resetMaximumLineCount()
     there is no guarantee.
 
     Text.StyledText is an optimized format supporting some basic text
-    styling markup, in the style of html 3.2:
+    styling markup, in the style of HTML 3.2:
 
     \code
     <b></b> - bold
@@ -1951,6 +1951,10 @@ Column {
     \endqml
     \li \image declarative-textformat.png
     \endtable
+
+    Text.RichText supports a larger subset of HTML 4, as described on the
+    \l {Supported HTML Subset} page. You should prefer using Text.PlainText
+    or Text.StyledText instead, as they offer better performance.
 */
 QQuickText::TextFormat QQuickText::textFormat() const
 {
-- 
GitLab