Doc: align "pre-defined colors" in the style docs

Original problem: the Universal.color() method docs was linking to the
pre-defined colors of the Material style. Present the list of Universal
style's pre-defined colors the same way it is done for the Material
style, and disambiguate the two.

Change-Id: I3f3df608e80ca5c24034e2d75398e3126cf32b2d
Reviewed-by: Mitch Curtis <mitch.curtis@qt.io>

1 files changed, 20 insertions, 18 deletions

diff --git a/src/imports/controls/doc/src/qtquickcontrols2-universal.qdoc b/src/imports/controls/doc/src/qtquickcontrols2-universal.qdoc
index da5e5687..02dc93c9 100644
--- a/src/imports/controls/doc/src/qtquickcontrols2-universal.qdoc
+++ b/src/imports/controls/doc/src/qtquickcontrols2-universal.qdoc
@@ -150,16 +150,15 @@
         \row
             \li \c QT_QUICK_CONTROLS_UNIVERSAL_ACCENT
             \li The value can be any \l {colorbasictypedocs}{color}, but it is recommended
-                to use one of the pre-defined  \l {universal-accent-attached-prop} {accents}, for
-                example \c "Violet".
+                to use one of the \l {pre-defined Universal colors}, for example \c "Violet".
         \row
             \li \c QT_QUICK_CONTROLS_UNIVERSAL_FOREGROUND
             \li The value can be any \l {colorbasictypedocs}{color}, or one of the
-                pre-defined  \l {universal-accent-attached-prop}{accents}.
+                \l {pre-defined Universal colors}.
         \row
             \li \c QT_QUICK_CONTROLS_UNIVERSAL_BACKGROUND
             \li The value can be any \l {colorbasictypedocs}{color}, or one of the
-                pre-defined  \l {universal-accent-attached-prop}{accents}.
+                \l {pre-defined Universal colors}.
     \endtable
 
     \section2 Dependency
@@ -177,19 +176,9 @@
     style-specific tweaks can be applied without creating a hard dependency to
     a style.
 
-    \b {See also} \l {Default Style}, \l {Material Style}
-
-    \section1 Attached Property Documentation
-
-    \styleproperty {Universal.accent} {color} {universal-accent-attached-prop}
-    \target universal-accent-attached-prop
-    This attached property holds the accent color of the theme. The property
-    can be attached to any window or item. The value is propagated to children.
-
-    Even though the accent can be any \l {colorbasictypedocs}{color}, it is
-    recommended to use one of the pre-defined accents that have been designed
-    to work well with the rest of the Universal style palette:
+    \section2 Pre-defined Universal Colors
 
+    Available pre-defined colors:
     \value Universal.Lime \stylecolor {#A4C400} {}
     \value Universal.Green \stylecolor {#60A917} {}
     \value Universal.Emerald \stylecolor {#008A00} {}
@@ -211,6 +200,19 @@
     \value Universal.Mauve \stylecolor {#76608A} {}
     \value Universal.Taupe \stylecolor {#87794E} {}
 
+    \b {See also} \l {Default Style}, \l {Material Style}
+
+    \section1 Attached Property Documentation
+
+    \styleproperty {Universal.accent} {color} {universal-accent-attached-prop}
+    \target universal-accent-attached-prop
+    This attached property holds the accent color of the theme. The property
+    can be attached to any window or item. The value is propagated to children.
+
+    \note Even though the accent can be any \l {colorbasictypedocs}{color}, it is
+    recommended to use one of the  \l {pre-defined Universal colors} that have been
+    designed to work well with the rest of the Universal style palette.
+
     \endstyleproperty
 
     \styleproperty {Universal.background} {color} {universal-background-attached-prop}
@@ -244,8 +246,8 @@
 
     \stylemethod {color} {color} {enumeration} {predefined} {color-attached-method}
     \target color-attached-method
-    This attached method returns the color value of the specified \l {pre-defined colors}
-    {pre-defined color}.
+    This attached method returns the effective color value of the specified
+    \l {pre-defined Universal colors}{pre-defined Universal color}.
 
     \qml
     import QtQuick 2.0