RadioButton docs

Change-Id: I158dac84c09172b7c27b227f673653feafb956af
Reviewed-by: J-P Nurmi <jpnurmi@theqtcompany.com>

8 files changed, 61 insertions, 1 deletions

diff --git a/src/controls/doc/images/qtquickcontrols2-radiobutton-background.png b/src/controls/doc/images/qtquickcontrols2-radiobutton-background.png
new file mode 100644
index 00000000..3ee9590e
--- /dev/null
+++ b/src/controls/doc/images/qtquickcontrols2-radiobutton-background.png
diff --git a/src/controls/doc/images/qtquickcontrols2-radiobutton-checked.png b/src/controls/doc/images/qtquickcontrols2-radiobutton-checked.png
new file mode 100644
index 00000000..9f71b6b6
--- /dev/null
+++ b/src/controls/doc/images/qtquickcontrols2-radiobutton-checked.png
diff --git a/src/controls/doc/images/qtquickcontrols2-radiobutton-disabled.png b/src/controls/doc/images/qtquickcontrols2-radiobutton-disabled.png
new file mode 100644
index 00000000..f7fbcb7c
--- /dev/null
+++ b/src/controls/doc/images/qtquickcontrols2-radiobutton-disabled.png
diff --git a/src/controls/doc/images/qtquickcontrols2-radiobutton-focused.png b/src/controls/doc/images/qtquickcontrols2-radiobutton-focused.png
new file mode 100644
index 00000000..dfb8d51e
--- /dev/null
+++ b/src/controls/doc/images/qtquickcontrols2-radiobutton-focused.png
diff --git a/src/controls/doc/images/qtquickcontrols2-radiobutton-indicator.png b/src/controls/doc/images/qtquickcontrols2-radiobutton-indicator.png
new file mode 100644
index 00000000..f9e91709
--- /dev/null
+++ b/src/controls/doc/images/qtquickcontrols2-radiobutton-indicator.png
diff --git a/src/controls/doc/images/qtquickcontrols2-radiobutton-label.png b/src/controls/doc/images/qtquickcontrols2-radiobutton-label.png
new file mode 100644
index 00000000..16c0ee08
--- /dev/null
+++ b/src/controls/doc/images/qtquickcontrols2-radiobutton-label.png
diff --git a/src/controls/doc/images/qtquickcontrols2-radiobutton-normal.png b/src/controls/doc/images/qtquickcontrols2-radiobutton-normal.png
new file mode 100644
index 00000000..5a2d4bca
--- /dev/null
+++ b/src/controls/doc/images/qtquickcontrols2-radiobutton-normal.png
diff --git a/src/controls/qquickradiobutton.cpp b/src/controls/qquickradiobutton.cpp
index c42a0207..1dcc309c 100644
--- a/src/controls/qquickradiobutton.cpp
+++ b/src/controls/qquickradiobutton.cpp
@@ -46,7 +46,67 @@ QT_BEGIN_NAMESPACE
     \ingroup buttons
     \brief A radio button control.
 
-    TODO
+    RadioButton presents an option button that can be toggled on (checked) or
+    off (unchecked). Radio buttons are typically used to select one option
+    from a set of options.
+
+    \table
+    \row \li \image qtquickcontrols2-radiobutton-normal.png
+         \li A radio button in its normal state.
+    \row \li \image qtquickcontrols2-radiobutton-checked.png
+         \li A radio button that is checked.
+    \row \li \image qtquickcontrols2-radiobutton-focused.png
+         \li A radio button that has active focus.
+    \row \li \image qtquickcontrols2-radiobutton-disabled.png
+         \li A radio button that is disabled.
+    \endtable
+
+    \code
+    ColumnLayout {
+        ExclusiveGroup { id: group }
+        RadioButton {
+            checked: true
+            text: qsTr("First")
+            Exclusive.group: group
+        }
+        RadioButton {
+            text: qsTr("Second")
+            Exclusive.group: group
+        }
+        RadioButton {
+            text: qsTr("Third")
+            Exclusive.group: group
+        }
+    }
+    \endcode
+
+    \section1 Structure
+
+    RadioButton consists of three parts, \l {Control::background}{background},
+    \l {Button::label}{label} and \l {Checkable::indicator}{indicator}. Their
+    implicit sizes are used to calculate the implicit size of the control.
+
+    \section3 Background
+
+    \image qtquickcontrols2-radiobutton-background.png
+
+    RadioButton has no background item by default.
+
+    \section3 Label
+
+    \image qtquickcontrols2-radiobutton-label.png
+
+    The following snippet presents the default label item implementation.
+
+    \snippet RadioButton.qml label
+
+    \section3 Indicator
+
+    \image qtquickcontrols2-radiobutton-indicator.png
+
+    The following snippet presents the default indicator item implementation.
+
+    \snippet RadioButton.qml indicator
 
     \sa ExclusiveGroup
 */