From eb4ba6200e3d64e5e48ab3bb09d9fad0ca0092c3 Mon Sep 17 00:00:00 2001
From: Geir Vattekar <geir.vattekar@nokia.com>
Date: Mon, 21 Feb 2011 15:55:16 +0100
Subject: Doc: Fixed snippet bugs in richtext-structure.html

    Task-number: QTBUG-17303
---
 doc/src/snippets/textblock-fragments/xmlwriter.cpp | 5 ++---
 doc/src/snippets/textdocument-frames/xmlwriter.cpp | 2 ++
 doc/src/snippets/textdocument-tables/xmlwriter.cpp | 2 ++
 3 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/doc/src/snippets/textblock-fragments/xmlwriter.cpp b/doc/src/snippets/textblock-fragments/xmlwriter.cpp
index 9f66d9a..252720b 100644
--- a/doc/src/snippets/textblock-fragments/xmlwriter.cpp
+++ b/doc/src/snippets/textblock-fragments/xmlwriter.cpp
@@ -102,11 +102,10 @@ void XmlWriter::readFragment(const QTextBlock &currentBlock,
             QDomText fragmentText = document->createTextNode(currentFragment.text());
 
             fragmentElement.appendChild(fragmentText);
-//! [6]
         }
-//! [7]
-    }
 //! [6] //! [7]
+    }
+//! [7] //! [6]
 }
 
 void XmlWriter::processBlock(const QTextBlock &currentBlock)
diff --git a/doc/src/snippets/textdocument-frames/xmlwriter.cpp b/doc/src/snippets/textdocument-frames/xmlwriter.cpp
index 31f08f3..8988100 100644
--- a/doc/src/snippets/textdocument-frames/xmlwriter.cpp
+++ b/doc/src/snippets/textdocument-frames/xmlwriter.cpp
@@ -100,6 +100,8 @@ void XmlWriter::processFrame(QDomElement &parent, QTextFrame *frame)
     parent.appendChild(frameElement);
 
 //! [1]
+    QDomElement frameElement = ...
+
     QTextFrame::iterator it;
     for (it = frame->begin(); !(it.atEnd()); ++it) {
 
diff --git a/doc/src/snippets/textdocument-tables/xmlwriter.cpp b/doc/src/snippets/textdocument-tables/xmlwriter.cpp
index d1d6798..8f98295 100644
--- a/doc/src/snippets/textdocument-tables/xmlwriter.cpp
+++ b/doc/src/snippets/textdocument-tables/xmlwriter.cpp
@@ -98,6 +98,8 @@ void XmlWriter::processFrame(QDomElement &parent, QTextFrame *frame)
     parent.appendChild(frameElement);
 
 //! [0]
+    QDomElement frameElement = ...
+
     QTextFrame::iterator it;
     for (it = frame->begin(); !(it.atEnd()); ++it) {
 
-- 
cgit v0.12


From 8cc0e2327eaffb14c135f229d49386f61f1e1cae Mon Sep 17 00:00:00 2001
From: Jerome Pasion <jerome.pasion@nokia.com>
Date: Mon, 21 Feb 2011 17:35:41 +0100
Subject: New landing page with new images.

Reviewed-by: David Boddie
---
 doc/src/howtos/developmentsteps.qdoc | 186 +++++++++++++++++++++++++++++++++++
 doc/src/images/guide.png             | Bin 0 -> 7376 bytes
 doc/src/images/qt-logo_large.png     | Bin 0 -> 11801 bytes
 doc/src/images/tools.png             | Bin 0 -> 9684 bytes
 doc/src/index.qdoc                   |  85 +++++++++++-----
 doc/src/mainpage.qdoc                |   9 ++
 6 files changed, 253 insertions(+), 27 deletions(-)
 create mode 100644 doc/src/howtos/developmentsteps.qdoc
 create mode 100644 doc/src/images/guide.png
 create mode 100644 doc/src/images/qt-logo_large.png
 create mode 100644 doc/src/images/tools.png

diff --git a/doc/src/howtos/developmentsteps.qdoc b/doc/src/howtos/developmentsteps.qdoc
new file mode 100644
index 0000000..e898bf5
--- /dev/null
+++ b/doc/src/howtos/developmentsteps.qdoc
@@ -0,0 +1,186 @@
+/****************************************************************************
+**
+** 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:FDL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Free Documentation License
+** Alternatively, this file may be used under the terms of the GNU Free
+** Documentation License version 1.3 as published by the Free Software
+** Foundation and appearing in the file included in the packaging of this
+** file.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+/*!
+\page qtdevelopment-steps.html
+\title Qt Development: The Steps from Challenge to Achievement
+
+\section1 The Challenge
+
+One day, your boss runs into your cubicle and exclaims to you, "The board blew
+millions on a new enterprise HelloWorld application. The new one does not work
+and we need a solution quickly before this disaster brings down the company! I'm
+putting you in charge of the whole project while I go on vacation -- see you in
+2 weeks."
+
+\section1 Brainstorming Ideas - It is time to play!
+
+Never one to shy away from a challenge (especially when your job might be on the
+line), you first set out try come up with an idea about what your options are.
+
+You ask around a bit and discover that the broken application was intended to
+replace one that has been living on a dusty mainframe for the past 25 years. The
+machine is nearing end of life and, rather than invest in replacement hardware
+to run a legacy HelloWorld program, the board decided to invest in new software
+that could be run on desktops, web, mobile devices and embedded into the
+company's main product line -- a pocket size device with a small LCD screen,
+which flashes the message "Hello World" every full moon.
+
+The vendor that was chosen to handle this task was a well known multinational
+company that specialized in enterprise CRM/ERP systems. The project missed
+several delivery deadlines over a 2 year period, and was 500% over budget. There
+was not going to be much margin for error trying to fix the problem, and there
+would likely be no budget either.
+
+You begin researching dozens of possible possible approaches to the problem. One
+of the biggest challenges is that there are very few options that will allow you
+to create native applications that use the same framework for targeting
+\l{qt-creator-configure-target}{multiple platforms}.
+
+Some years ago you had coded a small desktop application using the Qt framework,
+without realizing that it also can be used for targeting the web, mobile devices
+and embedded devices. Since that time, Qt has added a new feature called \l{Qt
+Quick}, which provides the ability to easily design applications with intuitive,
+modern-looking, fluid user interfaces.
+
+\section1 Creating an Objective
+
+You quickly realize that you might need two, three, or more interfaces for your
+application -- one for each of the target platforms you are aiming for.
+Thankfully Qt has options well suited for each of them.
+
+For your mobile application the choice seems obvious enough. The new Qt Quick
+technology looks very promising, but you do not know QML; the declarative
+language that helps define the interface in a Qt Quick program. You still want
+to give it a try, but worry that you might not have something complete before
+your boss returns from vacation in two weeks. You also wonder if Qt Quick is
+applicable to desktop and embedded targets -- and then of course there is the
+need for something targeting the web. You decide to give Qt Quick a try first
+and \l{QML Examples and Demos}{see where it takes you}.
+
+\section1 Developing Plans
+
+One thing you realize after reading up on \l{Qt Quick} is that things are very
+different from the desktop when designing an interface. Qt Quick doesn't contain
+ready made UI 'chrome'; the widgets and other design elements that define the
+application interface. A new technology, called Qt Quick Components, looks like
+a promising solution, but the components will only be available at a later date.
+For now you'll have to come up with something on your own -- but you are keen to
+give your design skills a work out, and learning to use Qt Quick seems to be a
+great way to do it.
+
+Not knowing a better place to start, you begin by taking a cue from web design
+and plan a wireframe, which helps
+\l{http://doc.qt.nokia.com/qtcreator-snapshot/creator-visual-editor.html}{define the application layout},
+content and user interaction. You decide on breaking the field of the screen
+space into three roughly equal size parts. There will be one section across the
+top, which will span the width of the screen, and two sections in the lower
+have, which will be approximately as tall as the top section is wide (when in
+portrait mode).
+
+The top section will be a simple text representation of the phrase "Hello World"
+in English. In the lower left you would like to place some kind of audio
+playback feature that repeats back the phrase in the top section of the screen.
+Finally, in the lower right hand side of the screen will be four links to
+similar views for additional languages -- Mandarin Chinese, Brazilian
+Portuguese, Arabic, and Russian. When the user clicks one of the links the text
+at the top is then translated, and the playback corresponds to the appropriate
+language.
+
+While the wireframe is effective in dealing with one part of the design
+challenge, it does not cover visual aspects other than layout and content. This
+means that you still need to define colours, white space, and typography (among
+other things). This is where a style guide would come in handy, if your company
+already had one that is. In the absence of one you decide to again get some
+inspiration from the web, and you mimic some of the company's website design
+into your application -- a sans-serif font for white text on a blue field across
+the top, black text on white for the bottom two sections, and a small company
+logo to the left of the "Hello World" message.
+
+
+\section1 Execution: The Coding Begins!
+
+At long last you sit down to \l{qt-technologies}{implement} your plans and
+designs. The first few steps go according to plan, and creating the basic layout
+and text goes fairly smoothly -- but you run into a few challenges quite
+quickly:
+
+Devising a user friendly interface to audio playback is not as intuitive as you
+first thought. Since there exist a ready made component for
+\l{http://doc.qt.nokia.com/qtmobility-1.1.0/qml-multimedia.html}{multimedia},
+you remove the bottom left field and now have the screen split in two. You add
+textual links for each of the five target languages, and when the user clicks
+one of them the message text changes and the appropriate audio plays back. It is
+a small sacrifice to make for now, and you are sure there is a solution to be
+found once you have become more proficient with QML.
+
+The next challenge you run into is that \l{qt-deployment}{deploying} the
+application to a Symbian phone is not as clearly understood as you expected.
+Again you are sure there is something you are missing, but for the time being
+you manually copy the .sis file to the "Installs" directory on the phone
+(connected to the development machine by USB) and then install it through the
+Application Manager.
+
+When you finally manage to install the application on the device you notice
+something that looks rather peculiar, and something you had not thought of. When
+the phone is turned into landscape mode, your text remains at the same absolute
+coordinates as when it was in portrait mode. You had not realized you needed to
+anchor it in order to achieve the centering you wanted. There was an
+\l{qt-testing}{easy fix} for this, but you were glad you saw this earlier rather
+than later.
+
+
+\section1 Innovating
+
+After the ups and downs of learning to develop a basic application
+using Qt Quick, you start to see greater possibilities for using Qt technologies
+for your current and future projects:
+
+\list
+\o Extending HTML5 based applications that tie Javascript to a Qt C++ back end
+using \l{Qt WebKit}
+\o An \l{qt-rendering-painting-system}{OpenGL} based UI for embedded platforms
+\o \l{Gestures Programming}{Touch} screen support
+\o \l{http://doc.qt.nokia.com/qtmobility-1.1.0/location-overview.html}{Location} based applications
+\o \l{qt-technologies}{Much, much more}
+\endlist
+
+
+\section1 The Achievement
+
+After your boss returned from vacation you presented him with the finished Qt
+Quick application, demonstrating it on both a mobile device as well as desktop
+(it happened to work well on both with little modification). You also provided
+him a presentation that detailed your road map for taking things to the next
+level -- targeting other platforms, such as the web, as well as improving on the
+existing application you just completed.
+
+Even though the final product did not turn out the way you originally planned,
+your boss was still sufficiently impressed. Not only was the go ahead given for
+future projects, but ramping up a small team of developers and designers was
+also suggested to help support your efforts.
+
+*/
diff --git a/doc/src/images/guide.png b/doc/src/images/guide.png
new file mode 100644
index 0000000..f4b0df1
Binary files /dev/null and b/doc/src/images/guide.png differ
diff --git a/doc/src/images/qt-logo_large.png b/doc/src/images/qt-logo_large.png
new file mode 100644
index 0000000..4e230bd
Binary files /dev/null and b/doc/src/images/qt-logo_large.png differ
diff --git a/doc/src/images/tools.png b/doc/src/images/tools.png
new file mode 100644
index 0000000..4d717b5
Binary files /dev/null and b/doc/src/images/tools.png differ
diff --git a/doc/src/index.qdoc b/doc/src/index.qdoc
index 6e745f0..3984574 100644
--- a/doc/src/index.qdoc
+++ b/doc/src/index.qdoc
@@ -37,53 +37,90 @@
 \div {indexbox tools}
     \div {indexboxcont indexboxbar }
         \div {sectionlist normallist}
+        \div {heading}
+            \l What is Qt
+        \enddiv
+        \image qt-logo_large.png
+        Qt is a cross-platform application and UI framework. Using Qt, you can
+        write applications once and deploy them across desktop, mobile, and
+        embedded operating systems without rewriting the source code.
+        \enddiv
+        \div {sectionlist normallist}
             \div {heading}
-                \l What is Qt
+                \emptyspan
             \enddiv
-            \image qt-logo.png
             \list
-            \o \l{http://doc.qt.nokia.com/nokia-qtsdk-1.0/index.html}{Nokia Qt SDK}
-            \o \l{What's New in Qt 4.7} - latest release
+            \o \l{http://doc.qt.nokia.com/nokia-qtsdk-1.0/index.html}{Qt SDK}
+            \o \l{http://developer.qt.nokia.com/wiki/QtCreatorWhitepaper}{Qt Creator}
+            \o \l{http://doc.qt.nokia.com/qtsimulator-1.1/index.html}{Qt Simulator}
             \endlist
             \list
             \o \l{http://developer.qt.nokia.com/wiki/QtWhitepaper}{Qt C++ Framework}
-            \o \l{http://developer.qt.nokia.com/wiki/QtCreatorWhitepaper}{Qt Creator}
             \o \l{Qt Quick}
             \o \l{http://doc.qt.nokia.com/qtmobility-1.1.0/index.html}{Qt Mobility}
-            \o \l{http://doc.qt.nokia.com/qtsimulator-1.1/index.html}{Qt Simulator}
+            \o \l{Qt WebKit}
+            \endlist
+            \list
             \o \l{Supported Platforms}{Platform Support}
-            \o \l{http://qt.nokia.com/products}{see more}
+            \o \l{What's New in Qt 4.7} - latest release
             \endlist
         \enddiv
         \div {sectionlist normallist}
             \div {heading}
+                \l See Qt
+            \enddiv
+            \image mobile.png
+            \list
+            \o \l{Qt Demonstrations}{Application Gallery}
+            \o \l{Tutorials}
+            \o \l{Qt Examples}{Examples}
+            \o \l{QML Examples and Demos}
+            \endlist
+        \enddiv
+    \enddiv
+\enddiv
+\div {indexbox tools}
+    \div {indexboxcont indexboxbar }
+        \div {sectionlist normallist}
+            \div {heading}
                 \l Develop with Qt
             \enddiv
-            \image qml.png
+            \image tools.png
             \list
             \o \l{Develop with Qt}{Steps to Programming Qt Applications}
             \o \l{qt-creator-configure-target}{Configure Qt and Creator for Platforms}
             \o \l{qt-technologies}{Qt Features and Technologies}
-            \o \l{qt-ui-creation}{Create UI with Qt}
             \o \l{qt-utilities}{Utilities and Testing}
             \o \l{qt-deployment}{Deploying Applications and Publish to Ovi Store}
             \endlist
-
+        \enddiv
+        \div {sectionlist normallist}
+            \div {heading}
+                \l Featured Articles
+            \enddiv
+            \image guide.png
             \list
-            \o \l Kevin's ABC
+            \o \l{Scalability}{How to Create Scalable Applications}
+            \o \l{http://doc.qt.nokia.com/nokia-qtsdk-1.0/creator-developing-symbian.html}{Setting Up Development Environment for Symbian}
+            \o \l{http://doc.qt.nokia.com/nokia-qtsdk-1.0/creator-developing-maemo.html}{Setting Up Development Environment for Maemo}
+            \o \l{http://doc.qt.nokia.com/qtcreator-snapshot/creator-publish-ovi.html}{Publishing Qt Applications to Ovi Store}
+            \endlist
+            \list
+            \o \l{Qt Development: The Steps from Challenge to Achievement}{The Steps from Challenge to Achievement}
+            A case analysis of a business development problem and a search for
+innovative solutions using Qt.
             \endlist
-
         \enddiv
         \div {sectionlist normallist}
             \div {heading}
-                \l See Qt
+                \l UI Creation with Qt
             \enddiv
-            \image mobile.png
+            \image qml.png
             \list
-            \o \l{Qt Demonstrations}{Application Gallery}
-            \o \l{Tutorials}
-            \o \l{Qt Examples}{Examples}
-            \o \l{QML Examples and Demos}
+            \o \l{qt-ui-creation}{Create UI with Qt}
+            \o \l{qt-rendering-painting-system}{Qt's Rendering and Painting Systems}
+            \o \l{Qt Quick} - develop fluid UIs with QML
+            \o \l{Widgets and Layouts} - elements for C++ interfaces
             \endlist
         \enddiv
     \enddiv
@@ -103,18 +140,13 @@
             \o \l{All Modules}{All Modules}
             \o \l{All Namespaces}{All Namespaces}
             \o \l{Global Qt Declarations}{Global Declarations}
-            \o \l{Qt Licenses and Credits}{Licenses and Credits}
+
             \endlist
         \enddiv
         \div {sectionlist normallist}
-            \div {heading}
-                Qt Quick and Mobility
-            \enddiv
             \list
-            \o \l{Intro to Qt Quick}{Introduction to Qt Quick}
+            \o \l{Qt Quick}
             \o \l{QML Elements}
-            \o \l{QML Examples and Demos}
-            \o \l{Qt Quick}{see more}
             \endlist
             \list
             \o \l{http://doc.qt.nokia.com/qtmobility-1.1.0/index.html}{Qt Mobility APIs}
@@ -123,14 +155,13 @@
         \enddiv
         \div {sectionlist normallist}
             \div {heading}
-                Qt Tools
+                Qt Manuals
             \enddiv
             \list
             \o \l{http://doc.qt.nokia.com/qtcreator-2.0/index.html}{Qt Creator}
             \o \l{http://doc.qt.nokia.com/qtsimulator/index.html}{Qt Simulator}
             \o \l{linguist-manual.html}{Qt Linguist}
             \o \l{assistant-manual.html}{Qt Assistant}
-            \o \l{http://qt.nokia.com/products/appdev}{Add-On Products and Services}
             \endlist
         \enddiv
     \enddiv
diff --git a/doc/src/mainpage.qdoc b/doc/src/mainpage.qdoc
index a8ab995..bcd4cda 100644
--- a/doc/src/mainpage.qdoc
+++ b/doc/src/mainpage.qdoc
@@ -55,7 +55,11 @@ to application testing and deployment.
     \o \l{http://doc.qt.nokia.com/qtcreator-snapshot/creator-build-settings.html}{Build Settings} - edit and set build configurations
     \o \l{http://doc.qt.nokia.com/qtcreator-snapshot/creator-run-settings.html}{Run Settings} - edit and set application run settings
     \endlist
+\o \l{http://doc.qt.nokia.com/nokia-qtsdk-1.0/creator-developing-symbian.html}{Setting Up Development Environment for Symbian}
+\o \l{http://doc.qt.nokia.com/nokia-qtsdk-1.0/creator-developing-maemo.html}{Setting Up Development Environment for Maemo}
 \endlist
+
+\keyword qt-platform-support
 \section2 Qt Platform Support
 Alternatively, Qt may be installed on its own without the Nokia Qt SDK.
 
@@ -124,6 +128,7 @@ that deal with inter-process communication.
 \o \l{Thread Support in Qt}{Thread Support} - overview of threading APIs and concurrent programming topics
 \endlist
 
+\keyword qt-rendering-painting-system
 \section2 Rendering and Paint System
 Qt has various support for different rendering and painting methods.
 \list
@@ -158,6 +163,9 @@ Qt supports many utilities that work on multiple platforms.
 \o \l{Qt Linguist Manual}{Qt Linguist} - for translating applications into local languages.
 \endlist
 For more information, visit the \l{Qt's Tools}{Qt Tools} page.
+\enddiv
+\div {indexboxcont indexboxbar normallist}
+\keyword qt-testing
 \section1 Testing Qt Applications
 Testing and debugging are part of the development process and Qt offers the
 developer multiple methods of testing their code.
@@ -217,6 +225,7 @@ Qt Information
 \o \l{Cross-platform and Platform-specific Development}
 \o \l{Qt and Key Technologies}
 \o \l{Best Practice Guides}
+\o \l{Qt Licenses and Credits}{Licenses and Credits}
 \endlist
 \enddiv
 */
-- 
cgit v0.12


From 9afac62064df735fa4667f61ce4fbda5289c94d9 Mon Sep 17 00:00:00 2001
From: Jerome Pasion <jerome.pasion@nokia.com>
Date: Mon, 21 Feb 2011 18:19:13 +0100
Subject: Removed GestureArea link from the elements page.

Additional merge conflicts fix.

Reviewed-by: David Boddie
---
 doc/src/declarative/elements.qdoc  | 1 -
 doc/src/examples/qml-examples.qdoc | 9 +--------
 doc/src/index.qdoc                 | 6 +++---
 3 files changed, 4 insertions(+), 12 deletions(-)

diff --git a/doc/src/declarative/elements.qdoc b/doc/src/declarative/elements.qdoc
index ff8e201..873d0de 100644
--- a/doc/src/declarative/elements.qdoc
+++ b/doc/src/declarative/elements.qdoc
@@ -77,7 +77,6 @@ To see the QML elements listed by functional area, see the
 \o \l {FocusScope} - Element that mediate keyboard focus changes
 \o \l {Flickable} - Provides a surface that can be "flicked"
 \o \l {Flipable} - Provides a surface that produces "flipping" effects
-\o \l {GestureArea} - Enables simple gesture handling
 \endlist
 
 \section1 Positioners and Repeater
diff --git a/doc/src/examples/qml-examples.qdoc b/doc/src/examples/qml-examples.qdoc
index 85b87ea..f77464f 100644
--- a/doc/src/examples/qml-examples.qdoc
+++ b/doc/src/examples/qml-examples.qdoc
@@ -283,7 +283,7 @@
     \title Positioners: Layout Direction Example
     \example declarative/positioners/layoutdirection
 
-    This example shows how to control the horizontal layout direction of 
+    This example shows how to control the horizontal layout direction of
     \l Row, \l Grid and \l Flow positioners.
 
     \image qml-positioners-layoutdirection-example.png
@@ -583,13 +583,6 @@
 */
 
 /*!
-    \title Touch Interaction: Gestures Example
-    \example declarative/touchinteraction/gestures
-
-    This example shows how to use the GestureArea element.
-*/
-
-/*!
     \title Touch Interaction: MouseArea Example
     \example declarative/touchinteraction/mousearea
 
diff --git a/doc/src/index.qdoc b/doc/src/index.qdoc
index 45f142d..3f629bf 100644
--- a/doc/src/index.qdoc
+++ b/doc/src/index.qdoc
@@ -38,7 +38,7 @@
     \div {indexboxcont indexboxbar }
         \div {sectionlist normallist}
             \div {heading}
-                \bold{What is Qt}
+                What is Qt
             \enddiv
             \image qt-logo.png
             \list
@@ -57,7 +57,7 @@
         \enddiv
         \div {sectionlist normallist}
             \div {heading}
-                \bold{Develop with Qt}
+                Develop with Qt
             \enddiv
             \image qml.png
             \list
@@ -72,7 +72,7 @@
         \enddiv
         \div {sectionlist normallist}
             \div {heading}
-                \bold{See Qt}
+                See Qt
             \enddiv
             \image mobile.png
             \list
-- 
cgit v0.12


From 16d87b86f6e400ba97ab5f79b9762836c3b186d2 Mon Sep 17 00:00:00 2001
From: Geir Vattekar <geir.vattekar@nokia.com>
Date: Mon, 21 Feb 2011 18:25:58 +0100
Subject: Doc: Work on scalability docs

---
 doc/src/howtos/scalabilityintro.qdoc | 55 ++++++++++++++++++------------------
 1 file changed, 28 insertions(+), 27 deletions(-)

diff --git a/doc/src/howtos/scalabilityintro.qdoc b/doc/src/howtos/scalabilityintro.qdoc
index 1abdc7a..6767c5e 100644
--- a/doc/src/howtos/scalabilityintro.qdoc
+++ b/doc/src/howtos/scalabilityintro.qdoc
@@ -27,6 +27,7 @@
 /*!
     \title Scalability
     \page scalability.html
+    \preliminary
 
     \omit preliminary docs for next SDK release \endomit
     \omit Somewhere I need to mention applications with more than
@@ -68,15 +69,19 @@
     Using small top-level layouts makes your codebase smaller and
     easier to maintain. Also, components that scales relative to their
     parent are more reusable. The layouts should be children of the
-    applications root item. You can change between them by, for
+    application's root item. You can change between them by, for
     instance, using the opacity property of Item; that is, if your
-    application has more tham one top-level layout.
+    application has more tham one top-level layout. Such a top-level
+    layout is also often referred to as a page, i.e., a layout that
+    uses the entire screen. For instance, an organizer application
+    will typically have separate pages for showing the calender and
+    editing todo items.
 
     You should define the measurements separate from the UI, for
     instance by using a JavaScript object that you fill in with a
     script on application start up.
 
-    QML's provides several ways of laying out components, e.g, using
+    QML provides several ways of laying out components, e.g, using
     anchor based layout, the more classic Grid; Column; and Row
     elements, and by setting the dimensions of Items directly. When
     laying out components in scalable applications, you should
@@ -100,10 +105,10 @@
     common components and attributes, and will most likely connect to
     the same data model.
 
-    Therefore, the top level definitions should be quite
+    Therefore, the top-level definitions should be quite
     straightforward and short, with the majority of the functionality
     refactored into contained Components. It is important to try to
-    avoid unnecessary duplication between these top level definitions,
+    avoid unnecessary duplication between these top-level definitions,
     in order to improve maintainability.
 
     There are some patterns that you might consider when designing
@@ -126,11 +131,12 @@
      definition, if defined appropriately using anchors.
     \endlist
 
-    The Loader component can be used to load separate QML files based
-    on some criteria, such as Device Profile resolution. In the case
-    of form factor, this information will not change during the
-    application's lifetime, therefore there is no issue with memory
-    usage or performance.
+    The \l{Loader} component can be used to load separate QML files
+    based on some criteria, such as Device Profile (configuration of
+    screen pixel resolution and DPI density). In the case of form
+    factor, this information will not change during the application's
+    lifetime, therefore there is no issue with memory usage or
+    performance.
 
     \section1 Defining Measurements
 
@@ -138,14 +144,11 @@
     component layout, there are a number aspects to consider:
 
     \list
-    \o The layout structure, the high level relationship between
+    \o The layout structure, the high-level relationship between
      items. Which item is the parent? How are the items arranged
      relatively on the screen? Are they in a grid or column?
     \o The layout measurements. How big is an item, or a margin
      inside the edge of an item, or an anchor between items?
-    \o The constraints imposed by the container. This might be
-     ApplicationWindow contents in the case of a Page, or it may
-     be some other container in the case of a Button.
     \o The implicit size of contained items. Some child items will
      require a certain amount of space, such as a button
      containing a text. That may also depend on the current
@@ -187,7 +190,7 @@
 
     \section1 Using QML's Layout Features
 
-    For a given form factor, top level Layouts structure definitions,
+    For a given form factor, top-level Layouts structure definitions,
     or component layout structure definitions, should in general be
     defined in a proportional way using a combination of
 
@@ -231,7 +234,7 @@
 
     \section1 Orientation Switches
 
-    Application top level page definitions, and reusable component
+    Application top-level page definitions, and reusable component
     definitions, should use one QML layout definition for the layout
     structure. This single definition should include the layout design
     for separate Device Orientations and Aspect Ratios. The reason for
@@ -241,13 +244,13 @@
     orientation changes.
 
     On the contrary, you should perform thorough tests if you choose
-    to use a Loader to load additional QML that is needed in separate
+    to use a \l{Loader} to load additional QML that is needed in separate
     orientations, as this will affect the performance of the
     orientation change.
 
     In order to enable layout animations between the orientations, the
     anchor definitions must reside within the same containing
-    component. Therefore the structure of an page or a component
+    component. Therefore the structure of a page or a component
     should consist of a common set of child components, a common set
     of anchor definitions, and a collection of states (defined in a
     StateGroup) representing the different aspect ratios supported by
@@ -255,7 +258,7 @@
     are not possible on Symbian due to compatibility support for S60
     applications).
 
-    If a component, contained within a Page element, needs to be
+    If a component contained within a page needs to be
     hosted in numerous different form factor definitions, then the
     layout states of the view should depend on the aspect ratio of the
     page (its immediate container). Similarly, different instances of
@@ -263,11 +266,9 @@
     in a UI, and so its layout states should be determined by the
     aspect ratio of its parent. The conclusion is that layout states
     should always follow the aspect ratio of the direct container (not
-    the "orientation" of the current device screen). The only
-    exception to this is of course the top level Window definition,
-    which is handled by the framework.
+    the "orientation" of the current device screen).
 
-    Within each layout State, you should define the relationships
+    Within each layout \l{State}, you should define the relationships
     between items using native QML layout definitions. See below for
     more information. During transitions between the states (triggered
     by the top level orientation change), in the case of anchor
@@ -283,7 +284,7 @@
     \list
     \o What if you have a single page that looks completely
      different between landscape and portrait, i.e. all of the
-     child items are different? For each Page, have two child
+     child items are different? For each page, have two child
      components, with separate layout definitions, and make one
      or other of the items have zero opacity in each state. You
      can use a cross-fade animation by simply applying a
@@ -308,15 +309,15 @@
      handler in this case, to ensure that the list item delegate
      has been constructed before the value is set.
     \o What if the two orientations take up too much memory to have
-     them both in memory at once? Use a Loader if necessary, if
+     them both in memory at once? Use a \l{Loader} if necessary, if
      you cannot keep both versions of the view in memory at once,
      but beware performance on the cross-fade animation during
      layout switch. One solution could be to have two "splash
      screen" items that are children of the Page, then you cross
      fade between those during rotation. Then you can use a
-     Loader to load another child component that loads the actual
+     \l{Loader} to load another child component that loads the actual
      model data to another child Item, and cross-fade to that
-     when the Loader has completed.
+     when the \l{Loader} has completed.
     \endlist
    */
 
-- 
cgit v0.12


From ab83278ee142a595df3fbc04af4a4c1452f0756c Mon Sep 17 00:00:00 2001
From: Jerome Pasion <jerome.pasion@nokia.com>
Date: Mon, 21 Feb 2011 18:37:46 +0100
Subject: Whitespace and newline fix

---
 doc/src/mainpage.qdoc | 1 -
 1 file changed, 1 deletion(-)

diff --git a/doc/src/mainpage.qdoc b/doc/src/mainpage.qdoc
index 9799247..18b0db9 100644
--- a/doc/src/mainpage.qdoc
+++ b/doc/src/mainpage.qdoc
@@ -230,4 +230,3 @@ Qt Information
 \enddiv
 */
 
-
-- 
cgit v0.12


From 1464b5e16a40f9af62ff153cfc7650c846bdf765 Mon Sep 17 00:00:00 2001
From: Jerome Pasion <jerome.pasion@nokia.com>
Date: Tue, 22 Feb 2011 09:30:52 +0100
Subject: Fixed snippets' license headers.

Some text were wrapped, therefore failing regression tests.
---
 doc/src/snippets/declarative/bestpractices/group.qml      | 15 ++++++++-------
 doc/src/snippets/declarative/focus/advancedFocus.qml      |  2 +-
 doc/src/snippets/declarative/focus/basicwidget.qml        |  2 +-
 doc/src/snippets/declarative/focus/focusscopewidget.qml   |  2 +-
 doc/src/snippets/declarative/focus/myclickablewidget.qml  |  2 +-
 doc/src/snippets/declarative/focus/myfocusscopewidget.qml |  2 +-
 doc/src/snippets/declarative/focus/mywidget.qml           |  2 +-
 doc/src/snippets/declarative/focus/widget.qml             |  2 +-
 doc/src/snippets/declarative/listview-decorations.qml     | 14 +++++++-------
 doc/src/snippets/declarative/listview-sections.qml        | 14 +++++++-------
 doc/src/snippets/declarative/listview.qml                 | 14 +++++++-------
 11 files changed, 36 insertions(+), 35 deletions(-)

diff --git a/doc/src/snippets/declarative/bestpractices/group.qml b/doc/src/snippets/declarative/bestpractices/group.qml
index 07243dc..8a2b398 100644
--- a/doc/src/snippets/declarative/bestpractices/group.qml
+++ b/doc/src/snippets/declarative/bestpractices/group.qml
@@ -13,15 +13,15 @@
 ** 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.
+**     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.
+**     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.
+**     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
@@ -38,6 +38,7 @@
 **
 ****************************************************************************/
 
+
 //! [document]
 import QtQuick 1.0
 
diff --git a/doc/src/snippets/declarative/focus/advancedFocus.qml b/doc/src/snippets/declarative/focus/advancedFocus.qml
index fda37c1..409663b 100644
--- a/doc/src/snippets/declarative/focus/advancedFocus.qml
+++ b/doc/src/snippets/declarative/focus/advancedFocus.qml
@@ -4,7 +4,7 @@
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
-** This file is part of the FOO module of the Qt Toolkit.
+** 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:
diff --git a/doc/src/snippets/declarative/focus/basicwidget.qml b/doc/src/snippets/declarative/focus/basicwidget.qml
index b74c1cd..bf834b4 100644
--- a/doc/src/snippets/declarative/focus/basicwidget.qml
+++ b/doc/src/snippets/declarative/focus/basicwidget.qml
@@ -4,7 +4,7 @@
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
-** This file is part of the FOO module of the Qt Toolkit.
+** 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:
diff --git a/doc/src/snippets/declarative/focus/focusscopewidget.qml b/doc/src/snippets/declarative/focus/focusscopewidget.qml
index d8c0d47..6a97512 100644
--- a/doc/src/snippets/declarative/focus/focusscopewidget.qml
+++ b/doc/src/snippets/declarative/focus/focusscopewidget.qml
@@ -4,7 +4,7 @@
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
-** This file is part of the FOO module of the Qt Toolkit.
+** 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:
diff --git a/doc/src/snippets/declarative/focus/myclickablewidget.qml b/doc/src/snippets/declarative/focus/myclickablewidget.qml
index 4777dd1..30b1c69 100644
--- a/doc/src/snippets/declarative/focus/myclickablewidget.qml
+++ b/doc/src/snippets/declarative/focus/myclickablewidget.qml
@@ -4,7 +4,7 @@
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
-** This file is part of the FOO module of the Qt Toolkit.
+** 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:
diff --git a/doc/src/snippets/declarative/focus/myfocusscopewidget.qml b/doc/src/snippets/declarative/focus/myfocusscopewidget.qml
index 9617427..6462301 100644
--- a/doc/src/snippets/declarative/focus/myfocusscopewidget.qml
+++ b/doc/src/snippets/declarative/focus/myfocusscopewidget.qml
@@ -4,7 +4,7 @@
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
-** This file is part of the FOO module of the Qt Toolkit.
+** 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:
diff --git a/doc/src/snippets/declarative/focus/mywidget.qml b/doc/src/snippets/declarative/focus/mywidget.qml
index 477c015..0cca747 100644
--- a/doc/src/snippets/declarative/focus/mywidget.qml
+++ b/doc/src/snippets/declarative/focus/mywidget.qml
@@ -4,7 +4,7 @@
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
-** This file is part of the FOO module of the Qt Toolkit.
+** 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:
diff --git a/doc/src/snippets/declarative/focus/widget.qml b/doc/src/snippets/declarative/focus/widget.qml
index a5053d9..a3a726e 100644
--- a/doc/src/snippets/declarative/focus/widget.qml
+++ b/doc/src/snippets/declarative/focus/widget.qml
@@ -4,7 +4,7 @@
 ** All rights reserved.
 ** Contact: Nokia Corporation (qt-info@nokia.com)
 **
-** This file is part of the FOO module of the Qt Toolkit.
+** 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:
diff --git a/doc/src/snippets/declarative/listview-decorations.qml b/doc/src/snippets/declarative/listview-decorations.qml
index 6b6d950..9ba9b70 100644
--- a/doc/src/snippets/declarative/listview-decorations.qml
+++ b/doc/src/snippets/declarative/listview-decorations.qml
@@ -13,15 +13,15 @@
 ** 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.
+**     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.
+**     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.
+**     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
diff --git a/doc/src/snippets/declarative/listview-sections.qml b/doc/src/snippets/declarative/listview-sections.qml
index a573059..74c96dd 100644
--- a/doc/src/snippets/declarative/listview-sections.qml
+++ b/doc/src/snippets/declarative/listview-sections.qml
@@ -13,15 +13,15 @@
 ** 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.
+**     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.
+**     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.
+**     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
diff --git a/doc/src/snippets/declarative/listview.qml b/doc/src/snippets/declarative/listview.qml
index 4bb48bc..081d2b0 100644
--- a/doc/src/snippets/declarative/listview.qml
+++ b/doc/src/snippets/declarative/listview.qml
@@ -13,15 +13,15 @@
 ** 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.
+**     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.
+**     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.
+**     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
-- 
cgit v0.12