Doc: Fixed qdoc warnings caused by invalid/incomplete QML snippets.

11 files changed, 381 insertions, 210 deletions

diff --git a/doc/src/declarative/dynamicobjects.qdoc b/doc/src/declarative/dynamicobjects.qdoc
index 073e0c4..11a4386 100644
--- a/doc/src/declarative/dynamicobjects.qdoc
+++ b/doc/src/declarative/dynamicobjects.qdoc
@@ -184,7 +184,9 @@ Note also that if a \c SelfDestroyingRect instance was created statically like t
 
 \qml
 Item {
-    SelfDestroyingRect { ... }
+    SelfDestroyingRect {
+        // ...
+    }
 }
 \endqml
 
diff --git a/doc/src/declarative/example-slideswitch.qdoc b/doc/src/declarative/example-slideswitch.qdoc
index 2b82b2f..9f84ee6 100644
--- a/doc/src/declarative/example-slideswitch.qdoc
+++ b/doc/src/declarative/example-slideswitch.qdoc
@@ -60,8 +60,16 @@ It can be used to activate/disactivate the switch or to query its current state.
 In this example:
 
 \qml
-Switch { id: mySwitch; on: true }
-Text { text: "The switch is on"; visible: mySwitch.on == true }
+Item {
+    Switch {
+        id: mySwitch
+        on: true
+    }
+    Text {
+        text: "The switch is on"
+        visible: mySwitch.on == true
+    }
+}
 \endqml
 
 the text will only be visible when the switch is on.
diff --git a/doc/src/declarative/extending.qdoc b/doc/src/declarative/extending.qdoc
index a1f006b..b986d06 100644
--- a/doc/src/declarative/extending.qdoc
+++ b/doc/src/declarative/extending.qdoc
@@ -733,12 +733,14 @@ It is optional for a property to have a default value. The default value is a co
 behaviorally identical to doing it in two steps, like this:
 
 \qml
-// Use default value
-property int myProperty: 10
+Item {
+    // Use default value
+    property int myProperty: 10
 
-// Longer, but behaviorally identical
-property int myProperty
-myProperty: 10
+    // Longer, but behaviorally identical
+    property int myProperty
+    myProperty: 10
+}
 \endqml
 
 
@@ -769,9 +771,11 @@ QML object types can also be used as property types. This includes
 defined like this:
 
 \qml
-property Item itemProperty
-property QtObject objectProperty
-property MyCustomType customProperty
+Item {
+    property Item itemProperty
+    property QtObject objectProperty
+    property MyCustomType customProperty
+}
 \endqml
 
 Such object-type properties default to an \c undefined value.
@@ -784,7 +788,9 @@ see the \l {variant}{variant type documentation} for details.
 list:
 
 \qml
-property list<Item> listOfItems
+Item {
+    property list<Item> listOfItems
+}
 \endqml
 
 Note that list properties cannot be modified like ordinary JavaScript
@@ -1075,7 +1081,7 @@ code removes the connection created in \c application.qml above:
 \qml
 // application.qml
 Item {
-    ...
+    // ...
 
     function removeSignal() {
         button.clicked.disconnect(item.myMethod)
@@ -1100,5 +1106,4 @@ MouseArea {
 
 Whenever the \l MouseArea \c clicked signal is emitted, the \c rect.buttonClicked signal will
 automatically be emitted as well.
-
 */
diff --git a/doc/src/declarative/qdeclarativemodels.qdoc b/doc/src/declarative/qdeclarativemodels.qdoc
index 45246e9..744b4bd 100644
--- a/doc/src/declarative/qdeclarativemodels.qdoc
+++ b/doc/src/declarative/qdeclarativemodels.qdoc
@@ -281,7 +281,7 @@ with models of type QAbstractItemModel:
 \endlist
 
 
-\section2 Exposing C++ data models to QML
+\section2 Exposing C++ Data Models to QML
 
 The above examples use QDeclarativeContext::setContextProperty() to set 
 model values directly in QML components. An alternative to this is to 
@@ -313,7 +313,9 @@ MyModel {
     id: myModel
     ListElement { someProperty: "some value" }
 }
+\endqml
 
+\qml
 ListView {
     width: 200; height: 250
     model: myModel
diff --git a/doc/src/declarative/qtdeclarative.qdoc b/doc/src/declarative/qtdeclarative.qdoc
index 05dac52..364711d 100644
--- a/doc/src/declarative/qtdeclarative.qdoc
+++ b/doc/src/declarative/qtdeclarative.qdoc
@@ -103,7 +103,9 @@
   \qml
   import com.mycompany.qmlcomponents 1.0
 
-  Slider { ... }
+  Slider {
+      // ...
+  }
   \endqml
 
   Note that it's perfectly reasonable for a library to register types to older versions
diff --git a/doc/src/snippets/declarative/script.js b/doc/src/snippets/declarative/script.js
index cd67311..f55dee3 100644
--- a/doc/src/snippets/declarative/script.js
+++ b/doc/src/snippets/declarative/script.js
@@ -1 +1,4 @@
-# Just here so that workerscript.qml succeeds.
+WorkerScript.onMessage = function(message) {
+    // ... long-running operations and calculations are done here
+    WorkerScript.sendMessage({ 'reply': 'Mouse is at ' + message.x + ',' + message.y })
+}
diff --git a/doc/src/snippets/declarative/transition-from-to-modified.qml b/doc/src/snippets/declarative/transition-from-to-modified.qml
new file mode 100644
index 0000000..1e2ebca
--- /dev/null
+++ b/doc/src/snippets/declarative/transition-from-to-modified.qml
@@ -0,0 +1,60 @@
+/****************************************************************************
+**
+** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+**   * Redistributions of source code must retain the above copyright
+**     notice, this list of conditions and the following disclaimer.
+**   * Redistributions in binary form must reproduce the above copyright
+**     notice, this list of conditions and the following disclaimer in
+**     the documentation and/or other materials provided with the
+**     distribution.
+**   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
+**     the names of its contributors may be used to endorse or promote
+**     products derived from this software without specific prior written
+**     permission.
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+import QtQuick 1.0
+
+Rectangle {
+    id: rect
+    width: 100; height: 100
+    color: "red"
+
+    MouseArea { id: mouseArea; anchors.fill: parent }
+
+    states: State {
+        name: "brighter"; when: mouseArea.pressed
+        PropertyChanges { target: rect; color: "yellow" }
+    }
+
+    //! [modified transition]
+    transitions: Transition {
+        to: "brighter"
+        ColorAnimation { duration: 1000 }
+    }
+    //! [modified transition]
+}
diff --git a/doc/src/snippets/declarative/transition-from-to.qml b/doc/src/snippets/declarative/transition-from-to.qml
index 5fde653..ba07518 100644
--- a/doc/src/snippets/declarative/transition-from-to.qml
+++ b/doc/src/snippets/declarative/transition-from-to.qml
@@ -57,5 +57,3 @@ Rectangle {
     }
 }
 //![0]
-
-
diff --git a/doc/src/snippets/declarative/transition-reversible.qml b/doc/src/snippets/declarative/transition-reversible.qml
index c67fd80..6a6ef23 100644
--- a/doc/src/snippets/declarative/transition-reversible.qml
+++ b/doc/src/snippets/declarative/transition-reversible.qml
@@ -53,12 +53,14 @@ Rectangle {
         PropertyChanges { target: rect; color: "yellow"; x: 50 }
     }
 
+    //! [sequential animations]
     transitions: Transition { 
         SequentialAnimation {
             PropertyAnimation { property: "x"; duration: 1000 }
             ColorAnimation { duration: 1000 }
         }
     }
+    //! [sequential animations]
 }
 //![0]
 
diff --git a/doc/src/snippets/declarative/transitions-list.qml b/doc/src/snippets/declarative/transitions-list.qml
new file mode 100644
index 0000000..0467de2
--- /dev/null
+++ b/doc/src/snippets/declarative/transitions-list.qml
@@ -0,0 +1,89 @@
+/****************************************************************************
+**
+** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:BSD$
+** You may use this file under the terms of the BSD license as follows:
+**
+** "Redistribution and use in source and binary forms, with or without
+** modification, are permitted provided that the following conditions are
+** met:
+**   * Redistributions of source code must retain the above copyright
+**     notice, this list of conditions and the following disclaimer.
+**   * Redistributions in binary form must reproduce the above copyright
+**     notice, this list of conditions and the following disclaimer in
+**     the documentation and/or other materials provided with the
+**     distribution.
+**   * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor
+**     the names of its contributors may be used to endorse or promote
+**     products derived from this software without specific prior written
+**     permission.
+**
+** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+import Qt 4.7
+
+Rectangle {
+  width: 150; height: 250
+
+  Rectangle {
+      id: stopLight
+      x: 25; y: 15; width: 100; height: 100
+  }
+  Rectangle {
+      id: goLight
+      x: 25; y: 135; width: 100; height: 100
+  }
+
+  states: [
+    State {
+      name: "stop"
+      PropertyChanges { target: stopLight; color: "red" }
+      PropertyChanges { target: goLight; color: "black" }
+    },
+    State {
+      name: "go"
+      PropertyChanges { target: stopLight; color: "black" }
+      PropertyChanges { target: goLight; color: "green" }
+    }
+  ]
+
+  state: "stop"
+
+  MouseArea {
+      anchors.fill: parent
+      onClicked: parent.state == "stop" ?
+                 parent.state = "go" : parent.state = "stop"
+  }
+
+  //! [list of transitions]
+  transitions: [
+    Transition {
+        from: "stop"; to: "go"
+        PropertyAnimation { target: stopLight
+                            properties: "color"; duration: 1000 }
+    },
+    Transition {
+        from: "go"; to: "stop"
+        PropertyAnimation { target: goLight
+                            properties: "color"; duration: 1000 }
+    } ]
+  //! [list of transitions]
+}
diff --git a/doc/src/snippets/qstring/main.cpp b/doc/src/snippets/qstring/main.cpp
index 9aac79d..bbc9e98 100644
--- a/doc/src/snippets/qstring/main.cpp
+++ b/doc/src/snippets/qstring/main.cpp
@@ -126,22 +126,22 @@ Widget::Widget(QWidget *parent)
 
 void Widget::constCharPointer()
 {
-//! [0]
+    //! [0]
     QString str = "Hello";
-//! [0]
+    //! [0]
 }
 
 void Widget::constCharArray()
 {
-//! [1]
+    //! [1]
     static const QChar data[4] = { 0x0055, 0x006e, 0x10e3, 0x03a3 };
     QString str(data, 4);
-//! [1]
+    //! [1]
 }
 
 void Widget::characterReference()
 {
-//! [2]
+    //! [2]
     QString str;
     str.resize(4);
 
@@ -149,46 +149,46 @@ void Widget::characterReference()
     str[1] = QChar('n');
     str[2] = QChar(0x10e3);
     str[3] = QChar(0x03a3);
-//! [2]
+    //! [2]
 }
 
 void Widget::atFunction()
 {
-//! [3]
+    //! [3]
     QString str;
 
     for (int i = 0; i < str.size(); ++i) {
         if (str.at(i) >= QChar('a') && str.at(i) <= QChar('f'))
             qDebug() << "Found character in range [a-f]";
     }
-//! [3]
+    //! [3]
 }
 
 void Widget::stringLiteral()
 {
-//! [4]
+    //! [4]
     QString str;
 
     if (str == "auto" || str == "extern"
             || str == "static" || str == "register") {
         // ...
     }
-//! [4]
+    //! [4]
 }
 
 void Widget::modify()
 {
-//! [5]
+    //! [5]
     QString str = "and";
     str.prepend("rock ");     // str == "rock and"
     str.append(" roll");        // str == "rock and roll"
     str.replace(5, 3, "&");   // str == "rock & roll"
-//! [5]
+    //! [5]
 }
 
 void Widget::index()
 {
-//! [6]
+    //! [6]
     QString str = "We must be <b>bold</b>, very <b>bold</b>";
     int j = 0;
 
@@ -196,25 +196,25 @@ void Widget::index()
         qDebug() << "Found <b> tag at index position" << j;
         ++j;
     }
-//! [6]
+    //! [6]
 }
 
 //! [7]
-    QString Widget::boolToString(bool b)
-    {
-        QString result;
-        if (b)
-            result = "True";
-        else
-            result = "False";
-        return result;
-    }
+QString Widget::boolToString(bool b)
+{
+    QString result;
+    if (b)
+        result = "True";
+    else
+        result = "False";
+    return result;
+}
 //! [7]
 
 
 void Widget::nullVsEmpty()
 {
-//! [8]
+    //! [8]
     QString().isNull();               // returns true
     QString().isEmpty();              // returns true
 
@@ -223,45 +223,45 @@ void Widget::nullVsEmpty()
 
     QString("abc").isNull();          // returns false
     QString("abc").isEmpty();         // returns false
-//! [8]
+    //! [8]
 }
 
 void Widget::appendFunction()
 {
-//! [9]
+    //! [9]
     QString x = "free";
     QString y = "dom";
 
     x.append(y);
     // x == "freedom"
-//! [9]
+    //! [9]
 
-//! [10]
+    //! [10]
     x.insert(x.size(), y);
-//! [10]
+    //! [10]
 }
 
 void Widget::argFunction()
 {
-//! [11]
+    //! [11]
     QString i;           // current file's number
     QString total;       // number of files to process
     QString fileName;    // current file's name
 
     QString status = QString("Processing file %1 of %2: %3")
                     .arg(i).arg(total).arg(fileName);
-//! [11]
+    //! [11]
 
-//! [12] //! [13]
+    //! [12] //! [13]
     QString str;
-//! [12]
+    //! [12]
     str = "%1 %2";
 
     str.arg("%1f", "Hello");        // returns "%1f Hello"
     str.arg("%1f").arg("Hello");    // returns "Hellof %2"
-//! [13]
+    //! [13]
 
-//! [14]
+    //! [14]
     str = QString("Decimal 63 is %1 in hexadecimal")
             .arg(63, 0, 16);
     // str == "Decimal 63 is 3f in hexadecimal"
@@ -272,16 +272,16 @@ void Widget::argFunction()
             .arg(12345)
             .arg(12345, 0, 16);
     // str == "12345 12,345 3039"
-//! [14]
+    //! [14]
 }
 
 void Widget::chopFunction()
 {
-//! [15]
+    //! [15]
     QString str("LOGOUT\r\n");
     str.chop(2);
     // str == "LOGOUT"
-//! [15]
+    //! [15]
 }
 
 void Widget::compareFunction()
@@ -293,251 +293,251 @@ void Widget::compareFunction()
 
 void Widget::compareSensitiveFunction()
 {
-//! [16]
+    //! [16]
     int x = QString::compare("aUtO", "AuTo", Qt::CaseInsensitive);  // x == 0
     int y = QString::compare("auto", "Car", Qt::CaseSensitive);     // y > 0
     int z = QString::compare("auto", "Car", Qt::CaseInsensitive);   // z < 0
-//! [16]
+    //! [16]
 }
 
 void Widget::containsFunction()
 {
-//! [17]
+    //! [17]
     QString str = "Peter Pan";
     str.contains("peter", Qt::CaseInsensitive);    // returns true
-//! [17]
+    //! [17]
 }
 
 void Widget::countFunction()
 {
-//! [18]
+    //! [18]
     QString str = "banana and panama";
     str.count(QRegExp("a[nm]a"));    // returns 4
-//! [18]
+    //! [18]
 }
 
 void Widget::dataFunction()
 {
-//! [19]
+    //! [19]
     QString str = "Hello world";
     QChar *data = str.data();
     while (!data->isNull()) {
         qDebug() << data->unicode();
         ++data;
     }
-//! [19]
+    //! [19]
 }
 
 void Widget::endsWithFunction()
 {
-//! [20]
+    //! [20]
     QString str = "Bananas";
     str.endsWith("anas");         // returns true
     str.endsWith("pple");         // returns false
-//! [20]
+    //! [20]
 }
 
 void Widget::fillFunction()
 {
-//! [21]
+    //! [21]
     QString str = "Berlin";
     str.fill('z');
     // str == "zzzzzz"
 
     str.fill('A', 2);
     // str == "AA"
-//! [21]
+    //! [21]
 }
 
 void Widget::fromRawDataFunction()
 {
-//! [22]
-     QRegExp pattern;
-     static const QChar unicode[] = {
-             0x005A, 0x007F, 0x00A4, 0x0060,
-             0x1009, 0x0020, 0x0020};
-     int size = sizeof(unicode) / sizeof(QChar);
+    //! [22]
+    QRegExp pattern;
+    static const QChar unicode[] = {
+            0x005A, 0x007F, 0x00A4, 0x0060,
+            0x1009, 0x0020, 0x0020};
+    int size = sizeof(unicode) / sizeof(QChar);
 
-     QString str = QString::fromRawData(unicode, size);
-     if (str.contains(QRegExp(pattern))) {
-         // ...
-//! [22] //! [23]
-     }
-//! [23]
+    QString str = QString::fromRawData(unicode, size);
+    if (str.contains(QRegExp(pattern))) {
+        // ...
+    //! [22] //! [23]
+    }
+    //! [23]
 }
 
 void Widget::indexOfFunction()
 {
-//! [24]
+    //! [24]
     QString x = "sticky question";
     QString y = "sti";
     x.indexOf(y);               // returns 0
     x.indexOf(y, 1);            // returns 10
     x.indexOf(y, 10);           // returns 10
     x.indexOf(y, 11);           // returns -1
-//! [24]
+    //! [24]
 }
 
 void Widget::firstIndexOfFunction()
 {
-//! [25]
+    //! [25]
     QString str = "the minimum";
     str.indexOf(QRegExp("m[aeiou]"), 0);       // returns 4
-//! [25]
+    //! [25]
 }
 
 void Widget::insertFunction()
 {
-//! [26]
+    //! [26]
     QString str = "Meal";
     str.insert(1, QString("ontr"));
     // str == "Montreal"
-//! [26]
+    //! [26]
 }
 
 void Widget::isEmptyFunction()
 {
-//! [27]
+    //! [27]
     QString().isEmpty();            // returns true
     QString("").isEmpty();          // returns true
     QString("x").isEmpty();         // returns false
     QString("abc").isEmpty();       // returns false
-//! [27]
+    //! [27]
 }
 
 void Widget::isNullFunction()
 {
-//! [28]
+    //! [28]
     QString().isNull();             // returns true
     QString("").isNull();           // returns false
     QString("abc").isNull();        // returns false
-//! [28]
+    //! [28]
 }
 
 void Widget::lastIndexOfFunction()
 {
-//! [29]
+    //! [29]
     QString x = "crazy azimuths";
     QString y = "az";
     x.lastIndexOf(y);           // returns 6
     x.lastIndexOf(y, 6);        // returns 6
     x.lastIndexOf(y, 5);        // returns 2
     x.lastIndexOf(y, 1);        // returns -1
-//! [29]
+    //! [29]
 
-//! [30]
+    //! [30]
     QString str = "the minimum";
     str.lastIndexOf(QRegExp("m[aeiou]"));      // returns 8
-//! [30]
+    //! [30]
 }
 
 void Widget::leftFunction()
 {
-//! [31]
+    //! [31]
     QString x = "Pineapple";
     QString y = x.left(4);      // y == "Pine"
-//! [31]
+    //! [31]
 }
 
 void Widget::leftJustifiedFunction()
 {
-//! [32]
+    //! [32]
     QString s = "apple";
     QString t = s.leftJustified(8, '.');    // t == "apple..."
-//! [32]
+    //! [32]
 
-//! [33]
+    //! [33]
     QString str = "Pineapple";
     str = str.leftJustified(5, '.', true);    // str == "Pinea"
-//! [33]
+    //! [33]
 }
 
 void Widget::midFunction()
 {
-//! [34]
+    //! [34]
     QString x = "Nine pineapples";
     QString y = x.mid(5, 4);            // y == "pine"
     QString z = x.mid(5);               // z == "pineapples"
-//! [34]
+    //! [34]
 }
 
 void Widget::numberFunction()
 {
-//! [35]
+    //! [35]
     long a = 63;
     QString s = QString::number(a, 16);             // s == "3f"
     QString t = QString::number(a, 16).toUpper();     // t == "3F"
-//! [35]
+    //! [35]
 }
 
 void Widget::prependFunction()
 {
-//! [36]
+    //! [36]
     QString x = "ship";
     QString y = "air";
     x.prepend(y);
     // x == "airship"
-//! [36]
+    //! [36]
 }
 
 void Widget::removeFunction()
 {
-//! [37]
+    //! [37]
     QString s = "Montreal";
     s.remove(1, 4);
     // s == "Meal"
-//! [37]
+    //! [37]
 
-//! [38]
+    //! [38]
     QString t = "Ali Baba";
     t.remove(QChar('a'), Qt::CaseInsensitive);
     // t == "li Bb"
-//! [38]
+    //! [38]
 
-//! [39]
+    //! [39]
     QString r = "Telephone";
     r.remove(QRegExp("[aeiou]."));
     // r == "The"
-//! [39]
+    //! [39]
 }
 
 void Widget::replaceFunction()
 {
-//! [40]
+    //! [40]
     QString x = "Say yes!";
     QString y = "no";
     x.replace(4, 3, y);
     // x == "Say no!"
-//! [40]
+    //! [40]
 
-//! [41]
+    //! [41]
     QString str = "colour behaviour flavour neighbour";
     str.replace(QString("ou"), QString("o"));
     // str == "color behavior flavor neighbor"
-//! [41]
+    //! [41]
 
-//! [42]
+    //! [42]
     QString s = "Banana";
     s.replace(QRegExp("a[mn]"), "ox");
     // s == "Boxoxa"
-//! [42]
+    //! [42]
 
-//! [43]
+    //! [43]
     QString t = "A <i>bon mot</i>.";
     t.replace(QRegExp("<i>([^<]*)</i>"), "\\emph{\\1}");
     // t == "A \\emph{bon mot}."
-//! [43]
+    //! [43]
 
-//! [86]
+    //! [86]
     QString equis = "xxxxxx";
     equis.replace("xx", "x");
     // equis == "xxx"    
-//! [86]
+    //! [86]
 }
 
 void Widget::reserveFunction()
 {
-//! [44]
+    //! [44]
     QString result;
     int maxSize;
     bool condition;
@@ -549,59 +549,59 @@ void Widget::reserveFunction()
         result.append(nextChar);
 
     result.squeeze();
-//! [44]
+    //! [44]
 }
 
 void Widget::resizeFunction()
 {
-//! [45]
+    //! [45]
     QString s = "Hello world";
     s.resize(5);
     // s == "Hello"
 
     s.resize(8);
     // s == "Hello???" (where ? stands for any character)
-//! [45]
+    //! [45]
 
-//! [46]
+    //! [46]
     QString t = "Hello";
     t += QString(10, 'X');
     // t == "HelloXXXXXXXXXX"
-//! [46]
+    //! [46]
 
-//! [47]
+    //! [47]
     QString r = "Hello";
     r = r.leftJustified(10, ' ');
     // r == "Hello     "
-//! [47]
+    //! [47]
 }
 
 void Widget::rightFunction()
 {
-//! [48]
+    //! [48]
     QString x = "Pineapple";
     QString y = x.right(5);      // y == "apple"
-//! [48]
+    //! [48]
 }
 
 void Widget::rightJustifiedFunction()
 {
-//! [49]
+    //! [49]
     QString s = "apple";
     QString t = s.rightJustified(8, '.');    // t == "...apple"
-//! [49]
+    //! [49]
 
-//! [50]
+    //! [50]
     QString str = "Pineapple";
     str = str.rightJustified(5, '.', true);    // str == "Pinea"
-//! [50]
+    //! [50]
 }
 
 void Widget::sectionFunction()
 {
-//! [51] //! [52]
+    //! [51] //! [52]
     QString str;
-//! [51]
+    //! [51]
     QString csv = "forename,middlename,surname,phone";
     QString path = "/usr/local/bin/myapp"; // First field is empty
     QString::SectionFlag flag = QString::SectionSkipEmpty;
@@ -610,83 +610,83 @@ void Widget::sectionFunction()
     str = csv.section(',', 2, 2);   // str == "surname"
     str = path.section('/', 3, 4);  // str == "bin/myapp"
     str = path.section('/', 3, 3, flag); // str == "myapp"
-//! [52]
+    //! [52]
 
-//! [53]
+    //! [53]
     str = csv.section(',', -3, -2);  // str == "middlename,surname"
     str = path.section('/', -1); // str == "myapp"
-//! [53]
+    //! [53]
 
-//! [54]
+    //! [54]
     QString data = "forename**middlename**surname**phone";
 
     str = data.section("**", 2, 2); // str == "surname"
     str = data.section("**", -3, -2); // str == "middlename**surname"
-//! [54]
+    //! [54]
 
-//! [55]
+    //! [55]
     QString line = "forename\tmiddlename  surname \t \t phone";
     QRegExp sep("\\s+");
     str = line.section(sep, 2, 2); // s == "surname"
     str = line.section(sep, -3, -2); // s == "middlename  surname"
-//! [55]
+    //! [55]
 }
 
 void Widget::setNumFunction()
 {
-//! [56]
+    //! [56]
     QString str;
     str.setNum(1234);       // str == "1234"
-//! [56]
+    //! [56]
 }
 
 void Widget::simplifiedFunction()
 {
-//! [57]
+    //! [57]
     QString str = "  lots\t of\nwhitespace\r\n ";
     str = str.simplified();
     // str == "lots of whitespace";
-//! [57]
+    //! [57]
 }
 
 void Widget::sizeFunction()
 {
-//! [58]
+    //! [58]
     QString str = "World";
     int n = str.size();         // n == 5
     str.data()[0];              // returns 'W'
     str.data()[4];              // returns 'd'
     str.data()[5];              // returns '\0'
-//! [58]
+    //! [58]
 }
 
 void Widget::splitFunction()
 {
-//! [59]
+    //! [59]
     QString str;
     QStringList list;
 
     str = "Some  text\n\twith  strange whitespace.";
     list = str.split(QRegExp("\\s+"));
     // list: [ "Some", "text", "with", "strange", "whitespace." ]
-//! [59]
+    //! [59]
 
-//! [60]
+    //! [60]
     str = "This time, a normal English sentence.";
     list = str.split(QRegExp("\\W+"), QString::SkipEmptyParts);
     // list: [ "This", "time", "a", "normal", "English", "sentence" ]
-//! [60]
+    //! [60]
 
-//! [61]
+    //! [61]
     str = "Now: this sentence fragment.";
     list = str.split(QRegExp("\\b"));
     // list: [ "", "Now", ": ", "this", " ", "sentence", " ", "fragment", "." ]
-//! [61]
+    //! [61]
 }
 
 void Widget::splitCaseSensitiveFunction()
 {
-//! [62]
+    //! [62]
     QString str = "a,,b,c";
 
     QStringList list1 = str.split(",");
@@ -694,241 +694,241 @@ void Widget::splitCaseSensitiveFunction()
 
     QStringList list2 = str.split(",", QString::SkipEmptyParts);
     // list2: [ "a", "b", "c" ]
-//! [62]
+    //! [62]
 }
 
 void Widget::sprintfFunction()
 {
-//! [63]
+    //! [63]
     size_t BufSize;
     char buf[BufSize];
 
     ::snprintf(buf, BufSize, "%lld", 123456789LL);
     QString str = QString::fromAscii(buf);
-//! [63]
+    //! [63]
 
-//! [64]
+    //! [64]
     QString result;
     QTextStream(&result) << "pi = " << 3.14;
     // result == "pi = 3.14"
-//! [64]
+    //! [64]
 }
 
 void Widget::startsWithFunction()
 {
-//! [65]
+    //! [65]
     QString str = "Bananas";
     str.startsWith("Ban");     // returns true
     str.startsWith("Car");     // returns false
-//! [65]
+    //! [65]
 }
 
 void Widget::toDoubleFunction()
 {
-//! [66]
+    //! [66]
     QString str = "1234.56";
     double val = str.toDouble();   // val == 1234.56
-//! [66]
+    //! [66]
 
-//! [67]
+    //! [67]
     bool ok;
     double d;
 
     d = QString( "1234.56e-02" ).toDouble(&ok); // ok == true, d == 12.3456
-//! [67]
+    //! [67]
 
-//! [68] //! [69]
+    //! [68] //! [69]
     QLocale::setDefault(QLocale::C);
     d = QString( "1234,56" ).toDouble(&ok); // ok == false
-//! [68]
+    //! [68]
     d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
 
-//! [69] //! [70]
+    //! [69] //! [70]
     QLocale::setDefault(QLocale::German);
     d = QString( "1234,56" ).toDouble(&ok); // ok == true, d == 1234.56
     d = QString( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56
 
-//! [70]
+    //! [70]
     QLocale::setDefault(QLocale::C);
     d = QString( "1,234,567.89" ).toDouble(&ok); // ok == false
 }
 
 void Widget::toFloatFunction()
 {
-//! [71]
+    //! [71]
     QString str1 = "1234.56";
     str1.toFloat();             // returns 1234.56
 
     bool ok;
     QString str2 = "R2D2";
     str2.toFloat(&ok);          // returns 0.0, sets ok to false
-//! [71]
+    //! [71]
 }
 
 void Widget::toIntFunction()
 {
-//! [72]
+    //! [72]
     QString str = "FF";
     bool ok;
     int hex = str.toInt(&ok, 16);       // hex == 255, ok == true
     int dec = str.toInt(&ok, 10);       // dec == 0, ok == false
-//! [72]
+    //! [72]
 }
 
 void Widget::toLongFunction()
 {
-//! [73]
+    //! [73]
     QString str = "FF";
     bool ok;
 
     long hex = str.toLong(&ok, 16);     // hex == 255, ok == true
     long dec = str.toLong(&ok, 10);     // dec == 0, ok == false
-//! [73]
+    //! [73]
 }
 
 void Widget::toLongLongFunction()
 {
-//! [74]
+    //! [74]
     QString str = "FF";
     bool ok;
 
     qint64 hex = str.toLongLong(&ok, 16);      // hex == 255, ok == true
     qint64 dec = str.toLongLong(&ok, 10);      // dec == 0, ok == false
-//! [74]
+    //! [74]
 }
 
 void Widget::toLowerFunction()
 {
-//! [75]
+    //! [75]
     QString str = "Qt by NOKIA";
     str = str.toLower();        // str == "qt by nokia"
-//! [75]
+    //! [75]
 }
 
 void Widget::toShortFunction()
 {
-//! [76]
+    //! [76]
     QString str = "FF";
     bool ok;
 
     short hex = str.toShort(&ok, 16);   // hex == 255, ok == true
     short dec = str.toShort(&ok, 10);   // dec == 0, ok == false
-//! [76]
+    //! [76]
 }
 
 void Widget::toUIntFunction()
 {
-//! [77]
+    //! [77]
     QString str = "FF";
     bool ok;
 
     uint hex = str.toUInt(&ok, 16);     // hex == 255, ok == true
     uint dec = str.toUInt(&ok, 10);     // dec == 0, ok == false
-//! [77]
+    //! [77]
 }
 
 void Widget::toULongFunction()
 {
-//! [78]
+    //! [78]
     QString str = "FF";
     bool ok;
 
     ulong hex = str.toULong(&ok, 16);   // hex == 255, ok == true
     ulong dec = str.toULong(&ok, 10);   // dec == 0, ok == false
-//! [78]
+    //! [78]
 }
 
 void Widget::toULongLongFunction()
 {
-//! [79]
+    //! [79]
     QString str = "FF";
     bool ok;
 
     quint64 hex = str.toULongLong(&ok, 16);    // hex == 255, ok == true
     quint64 dec = str.toULongLong(&ok, 10);    // dec == 0, ok == false
-//! [79]
+    //! [79]
 }
 
 void Widget::toUShortFunction()
 {
-//! [80]
+    //! [80]
     QString str = "FF";
     bool ok;
 
     ushort hex = str.toUShort(&ok, 16);     // hex == 255, ok == true
     ushort dec = str.toUShort(&ok, 10);     // dec == 0, ok == false
-//! [80]
+    //! [80]
 }
 
 void Widget::toUpperFunction()
 {
-//! [81]
+    //! [81]
     QString str = "TeXt";
     str = str.toUpper();        // str == "TEXT"
-//! [81]
+    //! [81]
 }
 
 void Widget::trimmedFunction()
 {
-//! [82]
+    //! [82]
     QString str = "  lots\t of\nwhitespace\r\n ";
     str = str.trimmed();
     // str == "lots\t of\nwhitespace"
-//! [82]
+    //! [82]
 }
 
 void Widget::truncateFunction()
 {
-//! [83]
+    //! [83]
     QString str = "Vladivostok";
     str.truncate(4);
     // str == "Vlad"
-//! [83]
+    //! [83]
 }
 
 void Widget::plusEqualOperator()
 {
-//! [84]
+    //! [84]
     QString x = "free";
     QString y = "dom";
     x += y;
     // x == "freedom"
-//! [84]
+    //! [84]
 }
 
 void Widget::arrayOperator()
 {
-//! [85]
+    //! [85]
     QString str;
 
     if (str[0] == QChar('?'))
         str[0] = QChar('_');
-//! [85]
+    //! [85]
 }
 
 void Widget::midRefFunction()
 {
-//! [midRef]
+    //! [midRef]
     QString x = "Nine pineapples";
     QStringRef y = x.midRef(5, 4);      // y == "pine"
     QStringRef z = x.midRef(5);         // z == "pineapples"
-//! [midRef]
+    //! [midRef]
 }
 
 void Widget::leftRefFunction()
 {
-//! [leftRef]
+    //! [leftRef]
     QString x = "Pineapple";
     QStringRef y = x.leftRef(4);        // y == "Pine"
-//! [leftRef]
+    //! [leftRef]
 }
 
 void Widget::rightRefFunction()
 {
-//! [rightRef]
+    //! [rightRef]
     QString x = "Pineapple";
     QStringRef y = x.rightRef(5);       // y == "apple"
-//! [rightRef]
+    //! [rightRef]
 }