Doc: minor language edits

Concerning vocab., punctuation, syntax and/or Writing Guidelines.
Corrected whitespace issues.
Replaced "if" with "whether" in Slider.qml

Task-number: QTBUG-30318

Change-Id: I0e0e8d2b807f0a6534deb2caa6dbee7eb206f43b
Reviewed-by: Topi Reiniö <topi.reinio@digia.com>
Reviewed-by: Martin Smith <martin.smith@digia.com>
Reviewed-by: Laszlo Papp <lpapp@kde.org>

14 files changed, 94 insertions, 92 deletions

diff --git a/src/controls/ApplicationWindow.qml b/src/controls/ApplicationWindow.qml
index 48d5ffeb0..bfd67b2c0 100644
--- a/src/controls/ApplicationWindow.qml
+++ b/src/controls/ApplicationWindow.qml
@@ -50,7 +50,7 @@ import QtQuick.Controls.Private 1.0
     \ingroup applicationwindow
     \brief Provides a top-level application window.
 
-    ApplicationWindow is a \l Window, but adds convenience for positioning items
+    ApplicationWindow is a \l Window that adds convenience for positioning items,
     such as \l MenuBar, \l ToolBar, and \l StatusBar in a platform independent
     manner.
 
@@ -98,7 +98,7 @@ Window {
 
         This property holds the toolbar \l Item.
 
-        It can be set to any Item type but is generally used with \l ToolBar.
+        It can be set to any Item type, but is generally used with \l ToolBar.
 
         By default, this value is not set. When you set the toolbar item, it will
         be anchored automatically into the application window.
@@ -110,7 +110,7 @@ Window {
 
         This property holds the status bar \l Item.
 
-        It can be set to any Item type but is generally used with \l StatusBar.
+        It can be set to any Item type, but is generally used with \l StatusBar.
 
         By default, this value is not set. When you set the status bar item, it
         will be anchored automatically into the application window.
diff --git a/src/controls/Button.qml b/src/controls/Button.qml
index 6872a143a..5249d21f3 100644
--- a/src/controls/Button.qml
+++ b/src/controls/Button.qml
@@ -51,7 +51,7 @@ import "Styles/Settings.js" as Settings
 
     The push button is perhaps the most commonly used widget in any graphical
     user interface. Pushing (or clicking) a button commands the computer to
-    perform some action or to answer a question. Common examples of buttons are
+    perform some action or answer a question. Common examples of buttons are
     OK, Apply, Cancel, Close, Yes, No, and Help buttons.
 
     Button is similar to the QPushButton widget.
diff --git a/src/controls/CheckBox.qml b/src/controls/CheckBox.qml
index 163575331..0f5098b58 100644
--- a/src/controls/CheckBox.qml
+++ b/src/controls/CheckBox.qml
@@ -68,7 +68,7 @@ import "Styles/Settings.js" as Settings
     identically to \l {AbstractCheckable::checked}{checked} when \l partiallyCheckedEnabled
     is \c false; setting one will appropriately set the other.
 
-    The text of the label shown next to the checkbox can be set with the
+    The label is shown next to the checkbox, and you can set the label text using its
     \l {AbstractCheckable::text}{text} property.
 
     \qml
diff --git a/src/controls/ComboBox.qml b/src/controls/ComboBox.qml
index f2203c207..3f2798e06 100644
--- a/src/controls/ComboBox.qml
+++ b/src/controls/ComboBox.qml
@@ -47,7 +47,7 @@ import "Styles/Settings.js" as Settings
     \qmltype ComboBox
     \inqmlmodule QtQuick.Controls 1.0
     \ingroup controls
-    \brief ComboBox is a combined button and popup or drop-down list.
+    \brief Provides a drop-down list functionality.
 
     Add items to the comboBox by assigning it a ListModel, or a list of strings to the \l model property.
 
diff --git a/src/controls/GroupBox.qml b/src/controls/GroupBox.qml
index 36b86fc35..91c358814 100644
--- a/src/controls/GroupBox.qml
+++ b/src/controls/GroupBox.qml
@@ -98,7 +98,7 @@ Item {
         If this property is enabled, only the top part of the frame is drawn in most styles;
         otherwise, the whole frame is drawn.
 
-        By default, this property is disabled, i.e., group boxes are not flat unless explicitly specified.
+        By default, this property is disabled, so group boxes are not flat unless explicitly specified.
 
         \note In some styles, flat and non-flat group boxes have similar representations and may not be as
               distinguishable as they are in other styles.
diff --git a/src/controls/ProgressBar.qml b/src/controls/ProgressBar.qml
index 381936544..340d5777f 100644
--- a/src/controls/ProgressBar.qml
+++ b/src/controls/ProgressBar.qml
@@ -60,27 +60,28 @@ Control {
     /*! This property holds the progress bar's current value.
         Attempting to change the current value to one outside the minimum-maximum
         range has no effect on the current value.
-        The default value is \c 0
+
+        The default value is \c{0}.
     */
     property real value: 0
 
-    /*! This property is the progress bar's minimum value
+    /*! This property is the progress bar's minimum value.
         The \l value is clamped to this value.
-        The default value is \c 0
+        The default value is \c{0}.
     */
     property real minimumValue: 0
 
-    /*! This property is the progress bar's maximum value
+    /*! This property is the progress bar's maximum value.
         The \l value is clamped to this value.
         If maximumValue is smaller than \l minimumValue, \l minimumValue will be enforced.
-        The default value is \c 1
+        The default value is \c{1}.
     */
     property real maximumValue: 1
 
     /*! This property toggles indeterminate mode.
         When the actual progress is unknown, use this option.
         The progress bar will be animated as a busy indicator instead.
-        The default value is \c false
+        The default value is \c false.
     */
     property bool indeterminate: false
 
diff --git a/src/controls/ScrollView.qml b/src/controls/ScrollView.qml
index 7a63a3e41..623d30278 100644
--- a/src/controls/ScrollView.qml
+++ b/src/controls/ScrollView.qml
@@ -46,10 +46,10 @@ import QtQuick.Controls.Private 1.0
     \qmltype ScrollView
     \inqmlmodule QtQuick.Controls 1.0
     \ingroup views
-    \brief The ScrollView class provides a scrolling view onto another Item.
+    \brief Provides a scrolling view within another Item.
 
-    A ScrollView can be used either instead of a \l Flickable or to decorate an
-    existing Flickable. Depending on the platform it will add scroll bars and
+    A ScrollView can be used either to replace a \l Flickable or decorate an
+    existing \l Flickable. Depending on the platform, it will add scroll bars and
     a content frame.
 
     Only one Item can be a direct child of the ScrollView and the child is implicitly anchored
@@ -86,10 +86,10 @@ FocusScope {
     implicitHeight: 100
 
     /*!
-        This property tells the scroll view if it should render
-        a frame around it's content.
+        This property tells the ScrollView if it should render
+        a frame around its content.
 
-        The default value is \c false
+        The default value is \c false.
     */
     property bool frameVisible: false
 
@@ -97,7 +97,7 @@ FocusScope {
         This property controls if there should be a highlight
         around the frame when the ScrollView has input focus.
 
-        The default value is \c false
+        The default value is \c false.
 
         \note This property is only applicable on some platforms, such
         as Mac OS.
@@ -107,8 +107,8 @@ FocusScope {
     /*!
         \qmlproperty Item ScrollView::viewport
 
-        The viewport determines the current "window" on to the contentItem.
-        In other words it clips it and the size of the viewport tells you
+        The viewport determines the current "window" on the contentItem.
+        In other words, it clips it and the size of the viewport tells you
         how much of the content area is visible.
     */
     property alias viewport: viewportItem
diff --git a/src/controls/Slider.qml b/src/controls/Slider.qml
index 9c25186bb..c606ff5e9 100644
--- a/src/controls/Slider.qml
+++ b/src/controls/Slider.qml
@@ -47,7 +47,7 @@ import "Styles/Settings.js" as Settings
     \qmltype Slider
     \inqmlmodule QtQuick.Controls 1.0
     \ingroup controls
-    \brief Slider provides a vertical or horizontal slider control.
+    \brief Provides a vertical or horizontal slider control.
 
     The slider is the classic control for providing a bounded value. It lets
     the user move a slider handle along a horizontal or vertical groove
@@ -70,15 +70,15 @@ Control {
         \qmlproperty enumeration Slider::orientation
 
         This property holds the layout orientation of the slider.
-        The default value is \c Qt.Horizontal
+        The default value is \c Qt.Horizontal.
     */
     property int orientation: Qt.Horizontal
 
     /*!
         \qmlproperty double Slider::minimumValue
 
-        This property holds the minimum value of the Slider
-        The default value is \c 0.0
+        This property holds the minimum value of the Slider.
+        The default value is \c{0.0}.
     */
     property alias minimumValue: range.minimumValue
 
@@ -86,26 +86,26 @@ Control {
         \qmlproperty double Slider::maximumValue
 
         This property holds the maximum value of the Slider
-        The default value is \c 1.0
+        The default value is \c{1.0}.
     */
     property alias maximumValue: range.maximumValue
 
     /*!
         \qmlproperty bool Slider::updateValueWhileDragging
 
-        This property indicates if the current \l value should update while
-        the user is moving the slider handle or only when the button has been released.
-        The property can for instance be used if changing the slider value can be
-        time consuming.
+        This property indicates whether the current \l value should be updated while
+        the user is moving the slider handle, or only when the button has been released.
+        This property could for instance be modified if changing the slider value would turn
+        out to be too time consuming.
 
-        The default value is \c true
+        The default value is \c true.
     */
     property bool updateValueWhileDragging: true
 
     /*!
         \qmlproperty bool Slider::pressed
 
-        This property indicates if slider handle is currently being pressed
+        This property indicates if slider handle is currently being pressed.
     */
     property alias pressed: mouseArea.pressed
 
@@ -118,7 +118,7 @@ Control {
         continuous range between \l minimumValue and \l maximumValue.
 
         Any non 0 value indicates a discrete stepSize. The following example
-        will generate a slider with integer values in the range [0-5]
+        will generate a slider with integer values in the range [0-5].
 
         \qml
         Slider {
@@ -127,15 +127,15 @@ Control {
         }
         \endqml
 
-        The default value is \c 0
+        The default value is \c{0.0}.
     */
     property alias stepSize: range.stepSize
 
     /*!
         \qmlproperty double Slider::value
 
-        This property holds the current value of the Slider
-        The default value is \c 0.0
+        This property holds the current value of the Slider.
+        The default value is \c{0.0}.
     */
     property alias value: range.value
 
@@ -153,7 +153,7 @@ Control {
         This property indicates if the Slider should display tickmarks
         at step intervals.
 
-        The default value is \c false
+        The default value is \c false.
     */
     property bool tickmarksEnabled: false
 
@@ -248,7 +248,7 @@ Control {
         value: __horizontal ? fakeHandle.x : fakeHandle.y
     }
 
-    // During the drag, we simply ignore position set from the range, this
+    // During the drag, we simply ignore the position set from the range, this
     // means that setting a value while dragging will not "interrupt" the
     // dragging activity.
     Binding {
diff --git a/src/controls/SpinBox.qml b/src/controls/SpinBox.qml
index de836b24b..c6a6c8e46 100644
--- a/src/controls/SpinBox.qml
+++ b/src/controls/SpinBox.qml
@@ -47,10 +47,10 @@ import "Styles/Settings.js" as Settings
     \qmltype SpinBox
     \inqmlmodule QtQuick.Controls 1.0
     \ingroup controls
-    \brief SpinBox provides a spin box control.
+    \brief Provides a spin box control.
 
-    SpinBox allows the user to choose a value by clicking the up/down buttons or pressing up/down on the keyboard to increase/decrease
-    the value currently displayed. The user can also type the value in manually.
+    SpinBox allows the user to choose a value by clicking the up or down buttons, or by
+    pressing up or down on the keyboard. The user can also type the value in manually.
 
     By default the SpinBox provides discrete values in the range [0-99] with a \l stepSize of 1 and 0 \l decimals.
 
@@ -77,7 +77,7 @@ Control {
     /*!
         The value of this SpinBox, clamped to \l minimumValue and \l maximumValue.
 
-        The default value is \c 0
+        The default value is \c{0.0}.
     */
     property real value: 0
 
@@ -85,7 +85,7 @@ Control {
         The minimum value of the SpinBox range.
         The \l value is clamped to this value.
 
-        The default value is \c 0
+        The default value is \c{0.0}.
     */
     property real minimumValue: 0
 
@@ -94,7 +94,7 @@ Control {
         The \l value is clamped to this value. If maximumValue is smaller than
         \l minimumValue, \l minimumValue will be enforced.
 
-        The default value is \c 99
+        The default value is \c{99}.
     */
     property real maximumValue: 99
 
@@ -102,7 +102,7 @@ Control {
         The amount by which the \l value is incremented/decremented when a
         spin button is pressed.
 
-        The default value is 1.0.
+        The default value is \c{1.0}.
     */
     property real stepSize: 1.0
 
@@ -115,7 +115,7 @@ Control {
     /*! This property indicates the amount of decimals.
       Note that if you enter more decimals than specified, they will
       be truncated to the specified amount of decimal places.
-      The default value is \c 0
+      The default value is \c{0}.
     */
     property int decimals: 0
 
@@ -127,7 +127,7 @@ Control {
 
     /*! This property indicates if the Spinbox should get active
       focus when pressed.
-      The default value is \c true
+      The default value is \c true.
     */
     property bool activeFocusOnPress: true
 
diff --git a/src/controls/SplitView.qml b/src/controls/SplitView.qml
index 64a9430af..1fc3ed081 100644
--- a/src/controls/SplitView.qml
+++ b/src/controls/SplitView.qml
@@ -47,8 +47,7 @@ import QtQuick.Controls.Private 1.0 as Private
     \qmltype SplitView
     \inqmlmodule QtQuick.Controls 1.0
     \ingroup views
-    \brief SplitView is a component that lays out items horizontally or
-    vertically with a draggable splitter between each item.
+    \brief Lays out items with a draggable splitter between each item.
 
     SplitView is a control that lays out items horizontally or
     vertically with a draggable splitter between each item.
@@ -58,23 +57,25 @@ import QtQuick.Controls.Private 1.0 as Private
     items have been laid out according to their own width and height.
     By default, the last visible child of the SplitView will be expanding, but
     this can be changed by setting Layout.fillWidth to \c true.
-    Since the expanding item will automatically be resized to fit the extra space, it
+    As the expanding item will automatically be resized to fit the extra space, it
     will ignore explicit assignments to width and height.
 
-    A handle can belong to the item on the left/top side, or the right/bottom side, of the
-    handle. Which one depends on the expanding item. If the expanding item is to the right
-    of the handle, the handle will belong to the item on the left. If it is to the left, it
-    will belong to the item on the right. This will again control which item that gets resized
-    when the user drags a handle, and which handle that gets hidden when an item is told to hide.
+    A handle can belong to the item either on the left or top side, or on the right or bottom side:
+    \list
+    \li If the expanding item is to the right: the handle belongs to the left item.
+    \li if the expanding item is on the left: the handle belongs to the right item.
+    \endlist
 
+    This will again control which item gets resized when the user drags a handle,
+    and which handle gets hidden when an item is told to hide.
     SplitView supports setting attached Layout properties on child items, which means that you
     can control minimumWidth, minimumHeight, maximumWidth and maximumHeight (in addition
     to fillWidth/fillHeight) for each child.
 
     Example:
 
-    To create a SplitView with three items, and let
-    the center item be expanding, one could do the following:
+    To create a SplitView with three items, and let the center item be expanding, one
+    could do the following:
 
     \qml
        SplitView {
@@ -106,7 +107,7 @@ Item {
     /*!
         \qmlproperty enumeration SplitView::orientation
 
-        This property holds the orientation of the split view.
+        This property holds the orientation of the SplitView.
         The value can be either \c Qt.Horizontal or \c Qt.Vertical.
         The default value is \c Qt.Horizontal.
     */
@@ -114,7 +115,7 @@ Item {
 
     /*!
         This property holds the delegate that will be instantiated between each
-        child item. Inside the delegate, the following properties are available:
+        child item. Inside the delegate the following properties are available:
         \list
         \li int \c handleIndex - specifies the index of the splitter handle. The handle
                                  between the first and the second item will get index 0,
@@ -327,8 +328,8 @@ Item {
             function moveHandle() {
                 // Moving the handle means resizing an item. Which one,
                 // left or right, depends on where the expanding item is.
-                // 'updateLayout' will override in case new width violates max/min.
-                // And 'updateLayout will be triggered when an item changes width.
+                // 'updateLayout' will be overridden in case new width violates max/min.
+                // 'updateLayout' will be triggered when an item changes width.
                 if (d.updateLayoutGuard)
                     return
 
diff --git a/src/controls/TabView.qml b/src/controls/TabView.qml
index bd0ed4f15..fa60af232 100644
--- a/src/controls/TabView.qml
+++ b/src/controls/TabView.qml
@@ -82,7 +82,7 @@ FocusScope {
     default property alias data: stack.data
 
     /*! Adds a new tab page with title with and optional Component.
-        \return the newly added tab
+        Returns the newly added tab.
     */
     function addTab(title, component) {
         var tab = tabcomp.createObject(this);
@@ -95,7 +95,7 @@ FocusScope {
     }
 
     /*! Inserts a new tab with title at index, with an optional Component.
-        \return the newly added tab
+        Returns the newly added tab.
     */
     function insertTab(index, title, component) {
         var tab = tabcomp.createObject(this);
@@ -107,7 +107,7 @@ FocusScope {
         return tab
     }
 
-    /*! Removes and destroys a tab at the given index */
+    /*! Removes and destroys a tab at the given \a index. */
     function removeTab(index) {
         var tab = __tabs[index]
         __tabs.splice(index, 1);
@@ -117,7 +117,7 @@ FocusScope {
         __setOpacities()
     }
 
-    /*! Returns the \l Tab item at index */
+    /*! Returns the \l Tab item at \a index. */
     function tabAt(index) {
         return __tabs[index]
     }
diff --git a/src/controls/TableView.qml b/src/controls/TableView.qml
index f08067792..1809566f3 100644
--- a/src/controls/TableView.qml
+++ b/src/controls/TableView.qml
@@ -50,7 +50,7 @@ import QtQuick.Controls.Private 1.0
 
    \image tableview.png
 
-   A TableView is similar to \l ListView and adds scroll bars, selection and
+   A TableView is similar to \l ListView, and adds scroll bars, selection, and
    resizable header sections. As with \l ListView, data for each row is provided through a \l model:
 
  \code
@@ -75,19 +75,19 @@ import QtQuick.Controls.Private 1.0
  \endcode
 
    The header sections are attached to values in the \l model by defining
-   the model role they attach to. Each property in the model, will
+   the model role they attach to. Each property in the model will
    then be shown in their corresponding column.
 
    You can customize the look by overriding the \l itemDelegate,
-   \l rowDelegate or \l headerDelegate properties.
+   \l rowDelegate, or \l headerDelegate properties.
 
    The view itself does not provide sorting. This has to
    be done on the model itself. However you can provide sorting
-   on the model and enable sort indicators on headers.
+   on the model, and enable sort indicators on headers.
 
 \list
     \li sortColumnIndex - The index of the current sort column
-    \li sortIndicatorVisible - If the sort indicator should be enabled
+    \li sortIndicatorVisible - Whether the sort indicator should be enabled
     \li sortIndicatorOrder - Qt.AscendingOrder or Qt.DescendingOrder depending on state
 \endlist
 */
@@ -168,7 +168,7 @@ ScrollView {
     property Component headerDelegate: headerDelegate
 
     /*! Index of the current sort column.
-        The default value is \c 0. */
+        The default value is \c {0}. */
     property int sortColumnIndex
 
     /*! This property shows or hides the sort indicator
@@ -317,7 +317,7 @@ ScrollView {
 
             onDoubleClicked: { root.activated() }
 
-            // Note by prevent stealing we are keeping the flickable from
+            // Note:  with boolean preventStealing we are keeping the flickable from
             // eating our mouse press events
             preventStealing: true
         }
diff --git a/src/controls/TextArea.qml b/src/controls/TextArea.qml
index c34315c35..0cae59c87 100644
--- a/src/controls/TextArea.qml
+++ b/src/controls/TextArea.qml
@@ -45,7 +45,7 @@ import QtQuick.Controls.Private 1.0
     \qmltype TextArea
     \inqmlmodule QtQuick.Controls 1.0
     \ingroup controls
-    \brief TextArea displays multiple lines of editable formatted text.
+    \brief Displays multiple lines of editable formatted text.
 
     It can display both plain and rich text. For example:
 
@@ -140,7 +140,7 @@ ScrollView {
         Sets the alignment of the text within the TextArea item's width.
 
         By default, the horizontal text alignment follows the natural alignment of the text,
-        for example text that is read from left to right will be aligned to the left.
+        for example, text that is read from left to right will be aligned to the left.
 
         The valid values for \c horizontalAlignment are:
         \list
@@ -183,7 +183,7 @@ ScrollView {
     /*!
         \qmlproperty enumeration TextArea::inputMethodHints
 
-        Provides hints to the input method about the expected content of the text edit and how it
+        Provides hints to the input method about the expected content of the text edit, and how it
         should operate.
 
         The value is a bit-wise combination of flags or Qt.ImhNone if no hints are set.
@@ -232,7 +232,7 @@ ScrollView {
 
         Returns the total number of plain text characters in the TextArea item.
 
-        As this number doesn't include any formatting markup it may not be the same as the
+        As this number doesn't include any formatting markup, it may not be the same as the
         length of the string returned by the \l text property.
 
         This property can be faster than querying the length the \l text property as it doesn't
@@ -253,9 +253,9 @@ ScrollView {
         Whether the user can interact with the TextArea item.
 
         The difference from a disabled text field is that it will appear
-        to be active and text can be selected and copied.
+        to be active, and text can be selected and copied.
 
-        If this property is set to true the text cannot be edited by user interaction.
+        If this property is set to \c true, the text cannot be edited by user interaction.
 
         By default this property is \c false.
     */
@@ -296,7 +296,7 @@ ScrollView {
     /*!
         \qmlproperty bool TextArea::tabChangesFocus
 
-        This property holds whether Tab changes focus or is accepted as input.
+        This property holds whether Tab changes focus, or is accepted as input.
 
         Defaults to \c false.
     */
@@ -425,7 +425,7 @@ ScrollView {
 
         Returns the section of text that is between the \a start and \a end positions.
 
-        The returned text will be formatted according the \l textFormat property.
+        The returned text will be formatted according to the \l textFormat property.
     */
     function getFormattedText(start, end) {
         return edit.getFormattedText(start, end);
@@ -491,12 +491,12 @@ ScrollView {
             moveCursorSelection(7, TextEdit.SelectCharacters)
         \endcode
 
-        This moves the cursor to position 5, extend the selection end from 5 to 9
-        and then retract the selection end from 9 to 7, leaving the text from position 5 to 7
-        selected (the 6th and 7th characters).
+        This moves the cursor to the 5th position, extends the selection end from 5 to 9,
+        and then retracts the selection end from 9 to 7, leaving the text from the 5th
+        position to the 7th position selected (the 6th and 7th characters).
 
         The same sequence with TextEdit.SelectWords will extend the selection start to a word boundary
-        before or on position 5 and extend the selection end to a word boundary on or past position 9.
+        before or on the 5th position, and extend the selection end to a word boundary on or past the 9th position.
     */
     function moveCursorSelection(position, mode) {
         edit.moveCursorSelection(position, mode);
diff --git a/src/controls/TextField.qml b/src/controls/TextField.qml
index 3163adda6..e781d23db 100644
--- a/src/controls/TextField.qml
+++ b/src/controls/TextField.qml
@@ -204,7 +204,7 @@ Control {
 
         Sets the alignment of the text within the TextField item's height.
 
-        The possible alignment values are
+        The possible alignment values are:
         \list
         \li TextInput.AlignTop
         \li TextInput.AlignBottom
@@ -245,8 +245,8 @@ Control {
         \li Qt.ImhNoAutoUppercase - The input method should not try to automatically switch to upper case
                 when a sentence ends.
         \li Qt.ImhPreferNumbers - Numbers are preferred (but not required).
-        \li Qt.ImhPreferUppercase - Upper case letters are preferred (but not required).
-        \li Qt.ImhPreferLowercase - Lower case letters are preferred (but not required).
+        \li Qt.ImhPreferUppercase - Uppercase letters are preferred (but not required).
+        \li Qt.ImhPreferLowercase - Lowercase letters are preferred (but not required).
         \li Qt.ImhNoPredictiveText - Do not use predictive text (for example, dictionary lookup) while typing.
 
         \li Qt.ImhDate - The text editor functions as a date field.
@@ -258,8 +258,8 @@ Control {
         \list
         \li Qt.ImhDigitsOnly - Only digits are allowed.
         \li Qt.ImhFormattedNumbersOnly - Only number input is allowed. This includes decimal point and minus sign.
-        \li Qt.ImhUppercaseOnly - Only upper case letter input is allowed.
-        \li Qt.ImhLowercaseOnly - Only lower case letter input is allowed.
+        \li Qt.ImhUppercaseOnly - Only uppercase letter input is allowed.
+        \li Qt.ImhLowercaseOnly - Only lowercase letter input is allowed.
         \li Qt.ImhDialableCharactersOnly - Only characters suitable for phone dialing are allowed.
         \li Qt.ImhEmailCharactersOnly - Only characters suitable for email addresses are allowed.
         \li Qt.ImhUrlCharactersOnly - Only characters suitable for URLs are allowed.
@@ -281,7 +281,7 @@ Control {
         characters and may differ from the length of the string returned by the
         \l text property.
 
-        This property can be faster than querying the length the \l text
+        This property can be faster than querying the length of the \l text
         property as it doesn't require any copying or conversion of the
         TextField's internal string data.
     */
@@ -366,7 +366,7 @@ Control {
     /*!
         \qmlproperty Validator TextField::validator
 
-        Allows you to set a validator on the TextField. When a validator is set
+        Allows you to set a validator on the TextField. When a validator is set,
         the TextField will only accept input which leaves the text property in
         an intermediate state. The accepted signal will only be sent
         if the text is in an acceptable state when enter is pressed.