Doc

1 files changed, 57 insertions, 47 deletions

diff --git a/doc/src/declarative/qtdeclarative.qdoc b/doc/src/declarative/qtdeclarative.qdoc
index fa5c0e6..549330b 100644
--- a/doc/src/declarative/qtdeclarative.qdoc
+++ b/doc/src/declarative/qtdeclarative.qdoc
@@ -40,58 +40,68 @@
 ****************************************************************************/
 
 /*!
-    \module QtDeclarative
-    \title QtDeclarative Module
-    \ingroup modules
+\module QtDeclarative
+\title QtDeclarative Module
+\ingroup modules
 
-    \brief The Qt Declarative module provides a declarative framework for building
-    highly dynamic, custom UIs
+\brief The Qt Declarative module provides a declarative framework for building
+highly dynamic, custom UIs
 
-    Qt Declarative is targetted at the sorts of user
-    interface (and the sorts of hardware) in embedded devices such as phones, media
-    players, and set-top boxes. It is also appropriate for highly custom desktop
-    user interfaces, or special elements in more traditional desktop
-    user interfaces.
+Qt Declarative aids programmers and designers in building the animation rich, 
+highly fluid user interfaces that are becoming common in portable consumer 
+electronics devices, such as mobile phones, media players, set-top boxes and 
+netbooks.  The Qt Declarative module provides an engine for interpreting the 
+declarative QML language, and a rich set of \l {QML Elements} that can be used 
+from QML.
 
-    Building fluid applications is done declaratively, rather than procedurally.
-    That is, you specify \e what the UI should look like and how it should behave
-    in an declarative format called QML, rather than specifying step-by-step \e how to
-    build it in a language like C++ or JavaScript.  Specifying a UI declaratively
-    does not just include the layout of the interface items, but also the way each
-    individual item looks and behaves and the overall flow of the application.
+QML is an extension to \l {http://www.ecma-international.org/publications/standards/Ecma-262.htm}
+{ECMAScript}, that provides a mechanism to declaratively build an object tree 
+of \l {QML Elements}.  QML improves the integration between ECMAScript and Qt's
+existing QObject based type system, adds support for automatic 
+\l {Property Binding}s and provides \l {Network Transparency} at the language 
+level.
 
-    Getting Started:
-    \list
-    \o \l {Introduction to the QML language}
-    \o \l {tutorial}{Tutorial: 'Hello World'}
-    \o \l {tutorials-declarative-contacts.html}{Tutorial: 'Introduction to QML'}
-    \o \l {advtutorial.html}{Advanced Tutorial: 'Same Game'}
-    \o \l {qmlexamples}{Examples}
-    \endlist
+The \l {QML Elements} are a sophisticated set of graphical and behavioral building
+blocks.  \l {QML Elements} are combined together in QML files to build components 
+ranging in complexity from simple pushbuttons and sliders, to complete 
+internet-enabled applications like a \l {http://www.flickr.com}{flickr} photo browser.
 
-    Core QML Features:
-    \list
-    \o \l {Anatomy of a QML Document}
-    \o \l {Property Binding}
-    \o \l {ECMAScript Blocks}
-    \o \l {Network Transparency}
-    \o \l {qmlmodels}{Data Models}
-    \o \l {anchor-layout}{Anchor-based Layout}
-    \o \l {qmlanimation}{Animation}
-    \o \l {qmlmodules}{Modules}
-    \o \l {qmlfocus}{Keyboard Focus}
-    \o \l {Extending types from QML}
-    \endlist
+Qt Declarative builds on \l {QML for Qt programmers}{Qt's existing strengths}.
+QML can be be used to incrementally extend an existing application or to build 
+completely new applications.  QML is fully \l {Extending QML}{extensible from C++}.
 
-    QML Reference:
-    \list
-    \o \l {QML Format Reference}
-    \o \l {QML Elements}
-    \endlist
+\section1 Getting Started:
+\list
+\o \l {Introduction to the QML language}
+\o \l {tutorial}{Tutorial: 'Hello World'}
+\o \l {tutorials-declarative-contacts.html}{Tutorial: 'Introduction to QML'}
+\o \l {advtutorial.html}{Advanced Tutorial: 'Same Game'}
+\o \l {qmlexamples}{Examples}
+\endlist
 
-    C++ Reference:
-    \list
-    \o \l {Extending QML}
-    \o \l {qtbinding}{QML/C++ Data Binding}
-    \endlist
+\section1 Core QML Features:
+\list
+\o \l {Anatomy of a QML Document}
+\o \l {Property Binding}
+\o \l {ECMAScript Blocks}
+\o \l {Network Transparency}
+\o \l {qmlmodels}{Data Models}
+\o \l {anchor-layout}{Anchor-based Layout}
+\o \l {qmlanimation}{Animation}
+\o \l {qmlmodules}{Modules}
+\o \l {qmlfocus}{Keyboard Focus}
+\o \l {Extending types from QML}
+\endlist
+
+\section1 QML Reference:
+\list
+\o \l {QML Format Reference}
+\o \l {QML Elements}
+\endlist
+
+\section1 C++ Reference:
+\list
+\o \l {Extending QML}
+\o \l {qtbinding}{QML/C++ Data Binding}
+\endlist
 */