Merge branch 'kinetic-declarativeui' of git@scm.dev.nokia.troll.no:qt/kinetic into kinetic-declarativeui

48 files changed, 451 insertions, 285 deletions

diff --git a/src/declarative/extra/qmlnumberformatter.cpp b/src/declarative/extra/qmlnumberformatter.cpp
index a12c4e6..60b154d 100644
--- a/src/declarative/extra/qmlnumberformatter.cpp
+++ b/src/declarative/extra/qmlnumberformatter.cpp
@@ -79,7 +79,7 @@ public:
     */
 /*!
     \class QmlNumberFormatter
-    \ingroup utility
+    \ingroup group_utility
     \brief The QmlNumberFormatter class allows you to format a number to a particular string format/locale specific number format.
 */
 
diff --git a/src/declarative/fx/qfxanchors.cpp b/src/declarative/fx/qfxanchors.cpp
index b7a7dd2..7372866 100644
--- a/src/declarative/fx/qfxanchors.cpp
+++ b/src/declarative/fx/qfxanchors.cpp
@@ -122,7 +122,7 @@ static qreal adjustedPosition(QFxItem *item, QFxAnchorLine::AnchorLine anchorLin
 /*!
     \internal
     \class QFxAnchors
-    \ingroup layouts
+    \ingroup group_layouts
     \brief The QFxAnchors class provides a way to lay out items relative to other items.
 
     \warning Currently, only anchoring to siblings or parent is supported.
diff --git a/src/declarative/fx/qfxblurfilter.cpp b/src/declarative/fx/qfxblurfilter.cpp
index 8cc9380..748fd8b 100644
--- a/src/declarative/fx/qfxblurfilter.cpp
+++ b/src/declarative/fx/qfxblurfilter.cpp
@@ -93,7 +93,7 @@ public:
 /*!
     \internal
     \class QFxBlurFilter
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxBlurFilter class allows you to blur an item.
 */
 
diff --git a/src/declarative/fx/qfxcomponentinstance.cpp b/src/declarative/fx/qfxcomponentinstance.cpp
index d561d05..b456716 100644
--- a/src/declarative/fx/qfxcomponentinstance.cpp
+++ b/src/declarative/fx/qfxcomponentinstance.cpp
@@ -60,6 +60,16 @@ QML_DEFINE_TYPE(QFxComponentInstance,ComponentInstance);
 /*!
     \qmlclass ComponentInstance QFxComponentInstance
     \brief The ComponentInstance element allows you to instantiate an arbitrary component.
+
+    \code
+    <Item>
+        <Component id="RedSquare">
+            <Rect color="red" width="10" height="10"/>
+        </Component>
+
+        <ComponentInstance component="{RedSquare}"/>
+    </Item>
+    \endcode
 */
 QFxComponentInstance::QFxComponentInstance(QFxItem *parent)
   : QFxItem(*(new QFxComponentInstancePrivate), parent)
@@ -73,6 +83,11 @@ QFxComponentInstance::QFxComponentInstance(QFxComponentInstancePrivate &dd, QFxI
     setOptions(IsFocusRealm);
 }
 
+/*!
+    \qmlproperty Component QFxComponentInstance::component
+
+    This property holds the component to instantiate.
+*/
 QmlComponent *QFxComponentInstance::component() const
 {
     Q_D(const QFxComponentInstance);
@@ -123,6 +138,11 @@ void QFxComponentInstance::updateSize()
     }
 }
 
+/*!
+    \qmlproperty Item QFxComponentInstance::instance
+
+    This property holds the instantiated component.
+*/
 QFxItem *QFxComponentInstance::instance() const
 {
     Q_D(const QFxComponentInstance);
diff --git a/src/declarative/fx/qfxcontentwrapper.cpp b/src/declarative/fx/qfxcontentwrapper.cpp
index 80710ca..5ce5430 100644
--- a/src/declarative/fx/qfxcontentwrapper.cpp
+++ b/src/declarative/fx/qfxcontentwrapper.cpp
@@ -95,7 +95,7 @@ QML_DEFINE_TYPE(QFxContent,Content);
 
 /*!
     \qmlclass Content QFxContent
-    \ingroup utility
+    \ingroup group_utility
     \brief Content is used as a placeholder for the content of a component.
     \inherits Item
 
diff --git a/src/declarative/fx/qfxflickable.cpp b/src/declarative/fx/qfxflickable.cpp
index 7e13036..e35d6cf 100644
--- a/src/declarative/fx/qfxflickable.cpp
+++ b/src/declarative/fx/qfxflickable.cpp
@@ -253,7 +253,7 @@ QML_DEFINE_TYPE(QFxFlickable,Flickable);
     \class QFxFlickable
     \brief The QFxFlickable class provides a view that can be "flicked".
 
-    \ingroup widgets
+    \ingroup group_widgets
 
     QFxFlickable allows its children to be dragged and flicked.
     
diff --git a/src/declarative/fx/qfxhighlightfilter.cpp b/src/declarative/fx/qfxhighlightfilter.cpp
index 6c6277a..d1ff3d3 100644
--- a/src/declarative/fx/qfxhighlightfilter.cpp
+++ b/src/declarative/fx/qfxhighlightfilter.cpp
@@ -96,7 +96,7 @@ public:
 /*!
     \internal
     \class QFxHighlightFilter
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxHightlightFilter class allows you to add a highlight to an item.
 */
 
diff --git a/src/declarative/fx/qfximage.cpp b/src/declarative/fx/qfximage.cpp
index a137bc3..9fe491c 100644
--- a/src/declarative/fx/qfximage.cpp
+++ b/src/declarative/fx/qfximage.cpp
@@ -99,7 +99,7 @@ QML_DEFINE_TYPE(QFxImage,Image);
     \class QFxImage Image
     \brief The QFxImage class provides an image item that you can add to a QFxView.
 
-    \ingroup coreitems
+    \ingroup group_coreitems
 
     Example:
     \code
diff --git a/src/declarative/fx/qfximageitem.cpp b/src/declarative/fx/qfximageitem.cpp
index 6c257fa..a6f6d8f 100644
--- a/src/declarative/fx/qfximageitem.cpp
+++ b/src/declarative/fx/qfximageitem.cpp
@@ -59,7 +59,7 @@ QT_BEGIN_NAMESPACE
 /*!
     \class QFxImageItem
     \brief The QFxImageItem class is an abstract base class for QFxView items that render using QPainter.
-    \ingroup coreitems
+    \ingroup group_coreitems
 
     This is a convenience class allowing easy use of a QPainter within a custom
     item.  The contents of the item are are cached behind the scenes.
diff --git a/src/declarative/fx/qfxitem.cpp b/src/declarative/fx/qfxitem.cpp
index 2f4c220..9aa742d 100644
--- a/src/declarative/fx/qfxitem.cpp
+++ b/src/declarative/fx/qfxitem.cpp
@@ -74,20 +74,49 @@ QML_DEFINE_TYPE(QFxItem,Item);
 QML_DEFINE_NOCREATE_TYPE(QSimpleCanvasFilter);
 
 /*!
-    \defgroup animation Animation
-    \defgroup coreitems Basic Items
-    \defgroup effects Effects
-    \defgroup layouts Layouts
-    \defgroup states States and Transitions
-    \defgroup utility Utility
-    \defgroup views Views
-    \defgroup widgets Widgets
+    \group group_animation
+    \title Animation
+*/
+
+/*!
+    \group group_coreitems
+    \title Basic Items
+*/
+
+/*!
+    \group group_effects
+    \title Effects
+*/
+
+/*!
+    \group group_layouts
+    \title Layouts
+*/
+
+/*!
+    \group group_states
+    \title States and Transitions
+*/
+
+/*!
+    \group group_utility
+    \title Utility
+*/
+
+/*!
+    \group group_views
+    \title Views
+*/
+
+/*!
+    \group group_widgets
+    \title Widgets
 */
 
 /*!
     \internal
     \class QFxContents
-    \ingroup utility
+    \ingroup group_utility
     \brief The QFxContents class gives access to the height and width of an item's contents.
 
 */
@@ -194,7 +223,7 @@ void QFxContents::setItem(QFxItem *item)
     \endqml
     \endqmltext
     
-    \ingroup coreitems
+    \ingroup group_coreitems
 */
 
 /*!
@@ -751,10 +780,10 @@ void QFxItem::setQml(const QString &qml)
     } else {
         d->_qmlcomp = 
             new QmlComponent(itemContext()->engine(), d->_qmlurl, this);
-        if(d->_qmlcomp->isReady())
+        if(!d->_qmlcomp->isLoading())
             qmlLoaded();
         else
-            QObject::connect(d->_qmlcomp, SIGNAL(readyChanged()),
+            QObject::connect(d->_qmlcomp, SIGNAL(statusChanged(Status)),
                              this, SLOT(qmlLoaded()));
     }
 }
@@ -768,7 +797,7 @@ void QFxItem::qmlLoaded()
         // ###
         for (int i=0; i<d->_qmlnewloading.length(); ++i) {
             QmlComponent *c = d->_qmlnewcomp.at(i);
-            if(!c->isReady())
+            if(c->isLoading())
                 continue;
 
             QmlContext *ctxt = new QmlContext(itemContext());
@@ -1618,10 +1647,10 @@ void QFxItem::newChild(const QString &type)
     d->_qmlnewloading.append(url);
     d->_qmlnewcomp.append(new QmlComponent(itemContext()->engine(), url, this));
 
-    if(d->_qmlnewcomp.last()->isReady())
+    if(!d->_qmlnewcomp.last()->isLoading())
         qmlLoaded();
     else
-        connect(d->_qmlnewcomp.last(), SIGNAL(readyChanged()), 
+        connect(d->_qmlnewcomp.last(), SIGNAL(statusChanged(Status)), 
                 this, SLOT(qmlLoaded()));
 }
 
diff --git a/src/declarative/fx/qfxkeyproxy.cpp b/src/declarative/fx/qfxkeyproxy.cpp
index 8598ad6..7d5726f 100644
--- a/src/declarative/fx/qfxkeyproxy.cpp
+++ b/src/declarative/fx/qfxkeyproxy.cpp
@@ -56,7 +56,7 @@ QML_DEFINE_TYPE(QFxKeyProxy,KeyProxy);
     \internal
     \class QFxKeyProxy
     \brief The QFxKeyProxy class proxies key presses to a number of other elements.
-    \ingroup utility
+    \ingroup group_utility
 */
 
 class QFxKeyProxyPrivate
diff --git a/src/declarative/fx/qfxlayouts.cpp b/src/declarative/fx/qfxlayouts.cpp
index 455b8a5..b89e795 100644
--- a/src/declarative/fx/qfxlayouts.cpp
+++ b/src/declarative/fx/qfxlayouts.cpp
@@ -65,7 +65,7 @@ QT_BEGIN_NAMESPACE
     that you use the move, remove and add transitions when those conditions
     arise.
 
-    \ingroup layouts
+    \ingroup group_layouts
 */
 QFxBaseLayout::QFxBaseLayout(AutoUpdateType at, QFxItem *parent)
     : QFxItem(*(new QFxBaseLayoutPrivate), parent)
@@ -577,7 +577,7 @@ QML_DEFINE_TYPE(QFxVerticalLayout, VerticalLayout);
     \internal
     \class QFxVerticalLayout
     \brief The QFxVerticalLayout class lines up items vertically.
-    \ingroup layouts
+    \ingroup group_layouts
 */
 QFxVerticalLayout::QFxVerticalLayout(QFxItem *parent)
 : QFxBaseLayout(Vertical, parent)
@@ -612,7 +612,6 @@ void QFxVerticalLayout::doLayout()
             setMovingItem(child);
             child->setY(voffset);
             setMovingItem(0);
-            child->setX(0);
         }
         voffset += child->height();
         voffset += spacing();
@@ -731,7 +730,7 @@ QML_DEFINE_TYPE(QFxHorizontalLayout,HorizontalLayout);
     \internal
     \class QFxHorizontalLayout
     \brief The QFxHorizontalLayout class lines up items horizontally.
-    \ingroup layouts
+    \ingroup group_layouts
 */
 QFxHorizontalLayout::QFxHorizontalLayout(QFxItem *parent)
 : QFxBaseLayout(Horizontal, parent)
@@ -766,7 +765,6 @@ void QFxHorizontalLayout::doLayout()
             setMovingItem(child);
             child->setX(hoffset);
             setMovingItem(0);
-            child->setY(0);
         }
         hoffset += child->width();
         hoffset += spacing();
@@ -910,7 +908,7 @@ QML_DEFINE_TYPE(QFxGridLayout,GridLayout);
     \internal
     \class QFxGridLayout
     \brief The QFxGridLayout class lays out items in a grid.
-    \ingroup layouts
+    \ingroup group_layouts
 
 */
 QFxGridLayout::QFxGridLayout(QFxItem *parent) :
diff --git a/src/declarative/fx/qfxmouseregion.cpp b/src/declarative/fx/qfxmouseregion.cpp
index 2bf7aa7..c6a7f96 100644
--- a/src/declarative/fx/qfxmouseregion.cpp
+++ b/src/declarative/fx/qfxmouseregion.cpp
@@ -242,7 +242,7 @@ QML_DEFINE_TYPE(QFxMouseRegion,MouseRegion);
     \class QFxMouseRegion
     \brief The QFxMouseRegion class provides a simple mouse handling abstraction for use within Qml.
 
-    \ingroup coreitems
+    \ingroup group_coreitems
 
     All QFxItem derived classes can do mouse handling but the QFxMouseRegion class exposes mouse
     handling data as properties and tracks flicking and dragging of the mouse.
diff --git a/src/declarative/fx/qfxpainted.cpp b/src/declarative/fx/qfxpainted.cpp
index a1eec69..8109efa 100644
--- a/src/declarative/fx/qfxpainted.cpp
+++ b/src/declarative/fx/qfxpainted.cpp
@@ -48,7 +48,7 @@ QT_BEGIN_NAMESPACE
     \class QFxPainted
     \brief QFxPainted is an abstract base class for QFxView items that paint using QPainter.
 
-    \ingroup coreitems
+    \ingroup group_coreitems
 
     This is a convenience class allowing easy use of QPainter within a custom item.
     The contents of the item are cached behind the scenes. Any time you change the contents
diff --git a/src/declarative/fx/qfxparticles.cpp b/src/declarative/fx/qfxparticles.cpp
index 3526541..939afba 100644
--- a/src/declarative/fx/qfxparticles.cpp
+++ b/src/declarative/fx/qfxparticles.cpp
@@ -110,7 +110,7 @@ QML_DEFINE_TYPE(QFxParticleMotion,ParticleMotion);
 
 /*!
     \class QFxParticleMotion
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxParticleMotion class is the base class for particle motion.
 
     This class causes the particles to remain static.
@@ -160,7 +160,7 @@ void QFxParticleMotion::destroy(QFxParticle &particle)
 /*!
     \internal
     \class QFxParticleMotionLinear
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxParticleMotionLinear class moves the particles linearly.
 
     \sa QFxParticles
@@ -184,7 +184,7 @@ void QFxParticleMotionLinear::advance(QFxParticle &p, int interval)
 /*!
     \internal
     \class QFxParticleMotionGravity
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxParticleMotionGravity class moves the particles towards a point.
 
     \sa QFxParticles
@@ -259,7 +259,7 @@ void QFxParticleMotionGravity::advance(QFxParticle &p, int interval)
 /*!
     \internal
     \class QFxParticleMotionWander
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxParticleMotionWander class moves particles in a somewhat random fashion.
 
     The particles will continue roughly in the original direction, however will randomly
@@ -544,7 +544,7 @@ QML_DEFINE_TYPE(QFxParticles,Particles);
 /*!
     \internal
     \class QFxParticles
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxParticles class generates and moves particles.
 */
 
diff --git a/src/declarative/fx/qfxpath.cpp b/src/declarative/fx/qfxpath.cpp
index 199f5fb..14c06bb 100644
--- a/src/declarative/fx/qfxpath.cpp
+++ b/src/declarative/fx/qfxpath.cpp
@@ -65,7 +65,7 @@ QML_DEFINE_TYPE(QFxPathCubic,PathCubic);
 /*!
     \internal
     \class QFxPath
-    \ingroup utility
+    \ingroup group_utility
     \brief The QFxPath class defines a path.
     \sa QFxPathView
 */
@@ -469,7 +469,7 @@ void QFxCurve::setY(int y)
 /*!
     \internal
     \class QFxPathAttribute
-    \ingroup utility
+    \ingroup group_utility
     \brief The QFxPathAttribute class allows to set the value of an attribute at a given position in the path.
 
     \sa QFxPath
@@ -527,7 +527,7 @@ void QFxPathAttribute::setValue(qreal value)
 /*!
     \internal
     \class QFxPathLine
-    \ingroup utility
+    \ingroup group_utility
     \brief The QFxPathLine class defines a straight line.
 
     \sa QFxPath
@@ -549,7 +549,7 @@ void QFxPathLine::addToPath(QPainterPath &path)
 /*!
     \internal
     \class QFxPathQuad
-    \ingroup utility
+    \ingroup group_utility
     \brief The QFxPathQuad class defines a quadratic Bezier curve with a control point.
 
     \sa QFxPath
@@ -613,7 +613,7 @@ void QFxPathQuad::addToPath(QPainterPath &path)
 /*!
     \internal
     \class QFxPathCubic
-    \ingroup utility
+    \ingroup group_utility
     \brief The QFxPathCubic class defines a cubic Bezier curve with two control points.
 
     \sa QFxPath
@@ -723,7 +723,7 @@ void QFxPathCubic::addToPath(QPainterPath &path)
 /*!
     \internal
     \class QFxPathPercent
-    \ingroup utility
+    \ingroup group_utility
     \brief The QFxPathPercent class manipulates the way a path is interpreted.
 
     QFxPathPercent allows you to bunch up items (or spread out items) along various
diff --git a/src/declarative/fx/qfxpathview.cpp b/src/declarative/fx/qfxpathview.cpp
index 79b0f8e..99f6e86 100644
--- a/src/declarative/fx/qfxpathview.cpp
+++ b/src/declarative/fx/qfxpathview.cpp
@@ -88,7 +88,7 @@ private:
     \class QFxPathView
     \brief The QFxPathView class lays out items provided by a model on a path.
 
-    \ingroup views
+    \ingroup group_views
 
     The model must be a \l QListModelInterface subclass.
 
diff --git a/src/declarative/fx/qfxpixmap.cpp b/src/declarative/fx/qfxpixmap.cpp
index 883dbdf..5a08679 100644
--- a/src/declarative/fx/qfxpixmap.cpp
+++ b/src/declarative/fx/qfxpixmap.cpp
@@ -85,7 +85,7 @@ public:
 /*!
     \internal
     \class QFxPixmap
-    \ingroup utility
+    \ingroup group_utility
     \brief Enacapsultes a pixmap for QFx items.
 
     This class is NOT reentrant.
diff --git a/src/declarative/fx/qfxrect.cpp b/src/declarative/fx/qfxrect.cpp
index 718dc76..2e84c74 100644
--- a/src/declarative/fx/qfxrect.cpp
+++ b/src/declarative/fx/qfxrect.cpp
@@ -49,7 +49,7 @@ QML_DEFINE_TYPE(QFxPen,Pen);
 /*!
     \internal
     \class QFxPen
-    \ingroup utility
+    \ingroup group_utility
     \brief The QFxPen class provides a pen used for drawing rect borders on a QFxView.
 
     Example:
@@ -126,7 +126,7 @@ QML_DEFINE_TYPE(QFxRect,Rect);
 
     A QFxRect object can be instantiated in Qml using the tag \l Rect.
 
-    \ingroup coreitems
+    \ingroup group_coreitems
 */
 QFxRect::QFxRect(QFxItem *parent)
   : QFxItem(*(new QFxRectPrivate), parent)
diff --git a/src/declarative/fx/qfxreflectionfilter.cpp b/src/declarative/fx/qfxreflectionfilter.cpp
index a541083..d67095b 100644
--- a/src/declarative/fx/qfxreflectionfilter.cpp
+++ b/src/declarative/fx/qfxreflectionfilter.cpp
@@ -111,7 +111,7 @@ public:
 /*!
     \internal
     \class QFxReflectionFilter
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxReflectionFilter class allows you to add a reflection to an item.
 */
 QFxReflectionFilter::QFxReflectionFilter(QObject *parent)
diff --git a/src/declarative/fx/qfxrepeater.cpp b/src/declarative/fx/qfxrepeater.cpp
index 823932c..ec1d88c 100644
--- a/src/declarative/fx/qfxrepeater.cpp
+++ b/src/declarative/fx/qfxrepeater.cpp
@@ -122,7 +122,7 @@ QML_DEFINE_TYPE(QFxRepeater,Repeater);
 /*!
     \internal
     \class QFxRepeater
-    \ingroup utility
+    \ingroup group_utility
     \qmlclass Repeater
 
     \brief The QFxRepeater class allows you to repeat a component based on a 
diff --git a/src/declarative/fx/qfxshadowfilter.cpp b/src/declarative/fx/qfxshadowfilter.cpp
index d10899f..3760a4d 100644
--- a/src/declarative/fx/qfxshadowfilter.cpp
+++ b/src/declarative/fx/qfxshadowfilter.cpp
@@ -90,7 +90,7 @@ public:
 /*!
     \internal
     \class QFxShadowFilter
-    \ingroup effects
+    \ingroup group_effects
     \brief The QFxShadowFilter class allows you to add a shadow to an item.
 */
 
@@ -128,7 +128,7 @@ void QFxShadowFilter::setXOffset(int offset)
 }
 
 /*!
-    \property QFxShadowFilter::xOffset
+    \property QFxShadowFilter::yOffset
     \brief the y offset of the shadow relative to the item.
 */
 int QFxShadowFilter::yOffset() const
diff --git a/src/declarative/fx/qfxtext.cpp b/src/declarative/fx/qfxtext.cpp
index 9cf1bb0..bc03d7c 100644
--- a/src/declarative/fx/qfxtext.cpp
+++ b/src/declarative/fx/qfxtext.cpp
@@ -93,7 +93,7 @@ QML_DEFINE_TYPE(QFxText,Text);
     \internal
     \class QFxText
     \qmlclass Text
-    \ingroup coreitems
+    \ingroup group_coreitems
 
     \brief The QFxText class provides a formatted text item that you can add to a QFxView.
 
diff --git a/src/declarative/fx/qfxtextedit.cpp b/src/declarative/fx/qfxtextedit.cpp
index ebfe799..96ebe0d 100644
--- a/src/declarative/fx/qfxtextedit.cpp
+++ b/src/declarative/fx/qfxtextedit.cpp
@@ -83,7 +83,7 @@ QML_DEFINE_TYPE(QFxTextEdit, TextEdit);
     \internal
     \class QFxTextEdit
     \qmlclass TextEdit
-    \ingroup coreitems
+    \ingroup group_coreitems
 
     \brief The QFxTextEdit class provides an editable formatted text item that you can add to a QFxView.
 
diff --git a/src/declarative/fx/qfxtransform.cpp b/src/declarative/fx/qfxtransform.cpp
index 8d8e5b4..90875a6 100644
--- a/src/declarative/fx/qfxtransform.cpp
+++ b/src/declarative/fx/qfxtransform.cpp
@@ -344,7 +344,7 @@ public:
     \class QFxFlipable
     \brief The QFxFlipable class provides a flipable surface.
 
-    \ingroup widgets
+    \ingroup group_widgets
 
     QFxFlipable allows you to specify a front and a back, as well as an
     axis for the flip.
diff --git a/src/declarative/fx/qfxwebview.cpp b/src/declarative/fx/qfxwebview.cpp
index c4a2750..9a9ee70 100644
--- a/src/declarative/fx/qfxwebview.cpp
+++ b/src/declarative/fx/qfxwebview.cpp
@@ -1029,7 +1029,7 @@ public:
         QmlEngine *engine = webview->itemContext()->engine();
         component = new QmlComponent(engine, url, this);
         item = 0;
-        connect(engine, SIGNAL(readyChanged()), this, SLOT(qmlLoaded()));
+        connect(engine, SIGNAL(statusChanged(Status)), this, SLOT(qmlLoaded()));
     }
 
 public Q_SLOTS:
diff --git a/src/declarative/qml/qmlcompiler.cpp b/src/declarative/qml/qmlcompiler.cpp
index 9af0a06..f03ce20 100644
--- a/src/declarative/qml/qmlcompiler.cpp
+++ b/src/declarative/qml/qmlcompiler.cpp
@@ -448,7 +448,7 @@ void QmlCompiler::reset(QmlCompiledComponent *cc, bool deleteMemory)
     }
 
 bool QmlCompiler::compile(QmlEngine *engine, 
-                          QmlCompositeTypeManager::TypeData *unit,
+                          QmlCompositeTypeData *unit,
                           QmlCompiledComponent *out)
 {
 #ifdef Q_ENABLE_PERFORMANCE_LOG
@@ -463,7 +463,7 @@ bool QmlCompiler::compile(QmlEngine *engine,
 
     // Compile types
     for(int ii = 0; ii < unit->types.count(); ++ii) {
-        QmlCompositeTypeManager::TypeData::TypeReference &tref = unit->types[ii];
+        QmlCompositeTypeData::TypeReference &tref = unit->types[ii];
         QmlCompiledComponent::TypeReference ref;
         if(tref.type)
             ref.type = tref.type;
diff --git a/src/declarative/qml/qmlcompiler_p.h b/src/declarative/qml/qmlcompiler_p.h
index 732d9ea..754e284 100644
--- a/src/declarative/qml/qmlcompiler_p.h
+++ b/src/declarative/qml/qmlcompiler_p.h
@@ -112,7 +112,7 @@ class Q_DECLARATIVE_EXPORT QmlCompiler
 public:
     QmlCompiler();
 
-    bool compile(QmlEngine *, QmlCompositeTypeManager::TypeData *, QmlCompiledComponent *);
+    bool compile(QmlEngine *, QmlCompositeTypeData *, QmlCompiledComponent *);
 
     bool isError() const;
     qint64 errorLine() const;
diff --git a/src/declarative/qml/qmlcomponent.cpp b/src/declarative/qml/qmlcomponent.cpp
index c863a00..0f60870 100644
--- a/src/declarative/qml/qmlcomponent.cpp
+++ b/src/declarative/qml/qmlcomponent.cpp
@@ -65,8 +65,43 @@ class QByteArray;
     \brief The QmlComponent class encapsulates a QML component description.
     \mainclass
 */
+
+/*!
+    \qmlclass Component QmlComponent
+    \brief The Component element encapsulates a QML component description.
+
+    Components are reusable, encapsulated Qml element with a well-defined interface.
+    They are often defined in \l {components}{Component Files}.
+
+    The \e Component element allows defining components within a QML file.
+    This can be useful for reusing a small component within a single QML
+    file, or for defining a component that logically belongs with the
+    file containing it.
+
+    \code
+    <Item>
+        <Component id="RedSquare">
+            <Rect color="red" width="10" height="10"/>
+        </Component>
+
+        <ComponentInstance component="{RedSquare}"/>
+        <ComponentInstance component="{RedSquare}" x="20"/>
+    </Item>
+    \endcode
+*/
 QML_DEFINE_TYPE(QmlComponent,Component);
 
+/*!
+    \enum QmlComponent::Status
+    
+    Specifies the loading status of the QmlComponent.
+
+    \o Null This QmlComponent has no data.  Call loadUrl() or setData() to add QML content.
+    \o Ready This QmlComponent is ready and create() may be called.
+    \o Loading This QmlComponent is loading network data.
+    \o Error An error has occured.  Calling errorDescription() to retrieve a description.
+*/
+
 void QmlComponentPrivate::typeDataReady()
 {
     Q_Q(QmlComponent);
@@ -76,19 +111,21 @@ void QmlComponentPrivate::typeDataReady()
     fromTypeData(typeData);
     typeData = 0;
 
-    emit q->readyChanged();
+    emit q->statusChanged(q->status());
 }
 
-void QmlComponentPrivate::fromTypeData(QmlCompositeTypeManager::TypeData *data)
+void QmlComponentPrivate::fromTypeData(QmlCompositeTypeData *data)
 {
-    name = data->url;
+    url = QUrl(data->url);
     QmlCompiledComponent *c = data->toCompiledComponent(engine);
 
     if(!c) {
-        Q_ASSERT(data->status == QmlCompositeTypeManager::TypeData::Error);
+        Q_ASSERT(data->status == QmlCompositeTypeData::Error);
 
+        errorDescription = data->errorDescription;
         qWarning().nospace() << "QmlComponent: "
                              << data->errorDescription.toLatin1().constData();
+
     } else {
 
         cc = c;
@@ -98,14 +135,26 @@ void QmlComponentPrivate::fromTypeData(QmlCompositeTypeManager::TypeData *data)
     data->release();
 }
 
+void QmlComponentPrivate::clear()
+{
+    if(typeData) {
+        typeData->remWaiter(this);
+        typeData->release();
+        typeData = 0;
+    }
+        
+    if(cc) { 
+        cc->release();
+        cc = 0;
+    }
+}
+
 /*!
-    Construct a null QmlComponent.
+    \internal
 */
 QmlComponent::QmlComponent(QObject *parent)
     : QObject(*(new QmlComponentPrivate), parent)
 {
-    Q_D(QmlComponent);
-    d->name = QLatin1String("<unspecified file>");
 }
 
 /*!
@@ -122,62 +171,66 @@ QmlComponent::~QmlComponent()
         d->cc->release();
 }
 
-/*!
-    \property QmlComponent::name
-    \brief the component's name.
-
-    The component's name is used in error and warning messages.  If available,
-    the XML source file name is used as the component's name, otherwise it is
-    set to "<unspecified file>".
-*/
-QString QmlComponent::name() const
+QmlComponent::Status QmlComponent::status() const
 {
     Q_D(const QmlComponent);
-    return d->name;
-}
 
-void QmlComponent::setName(const QString &name)
-{
-    Q_D(QmlComponent);
-    d->name = name;
+    if(d->typeData)
+        return Loading;
+    else if(d->engine && d->cc)
+        return Ready;
+    else if(!d->errorDescription.isEmpty())
+        return Error;
+    else
+        return Null;
 }
 
 /*!
-    \internal
+    Returns true if the component is in the Null state, false otherwise.
+
+    Equivalent to status() == QmlComponent::Null.
 */
-QmlComponent::QmlComponent(QmlEngine *engine, QmlCompiledComponent *cc, int start, int count, QObject *parent)
-    : QObject(*(new QmlComponentPrivate), parent)
+bool QmlComponent::isNull() const
 {
-    Q_D(QmlComponent);
-    d->engine = engine;
-    d->name = QLatin1String("<unspecified file>");
-    d->cc = cc;
-    cc->addref();
-    d->start = start;
-    d->count = count;
+    return status() == Null;
 }
 
-QmlComponent::QmlComponent(QmlEngine *engine, const QUrl &url, QObject *parent)
-: QObject(*(new QmlComponentPrivate), parent)
+/*!
+    Returns true if the component is in the Ready state, false otherwise.
+
+    Equivalent to status() == QmlComponent::Ready.
+*/
+bool QmlComponent::isReady() const
 {
-    Q_D(QmlComponent);
-    d->engine = engine;
-    d->name = url.toString();
+    return status() == Ready;
+}
 
-    QmlCompositeTypeManager::TypeData *data = 
-        engine->d_func()->typeManager.get(url);
+/*!
+    Returns true if the component is in the Error state, false otherwise.
 
-    if(data->status == QmlCompositeTypeManager::TypeData::Waiting) {
+    Equivalent to status() == QmlComponent::Error.
+*/
+bool QmlComponent::isError() const
+{
+    return status() == Error;
+}
 
-        d->typeData = data;
-        d->typeData->addWaiter(d);
+/*!
+    Returns true if the component is in the Loading state, false otherwise.
 
-    } else {
+    Equivalent to status() == QmlComponent::Loading.
+*/
+bool QmlComponent::isLoading() const
+{
+    return status() == Loading;
+}
 
-        d->fromTypeData(data);
+/*!
+    \fn void QmlComponent::statusChanged(QmlComponent::Status status)
 
-    }
-}
+    Emitted whenever the component's status changes.  \a status will be the
+    new status.
+*/
 
 /*!
     Create a QmlComponent with no data. Set setData().
@@ -190,6 +243,17 @@ QmlComponent::QmlComponent(QmlEngine *engine, QObject *parent)
 }
 
 /*!
+    Create a QmlComponent from the given \a url.
+*/
+QmlComponent::QmlComponent(QmlEngine *engine, const QUrl &url, QObject *parent)
+: QObject(*(new QmlComponentPrivate), parent)
+{
+    Q_D(QmlComponent);
+    d->engine = engine;
+    loadUrl(url);
+}
+
+/*!
     Create a QmlComponent from the given XML \a data.  If provided, \a filename
     is used to set the component name, and to provide a base path for items
     resolved by this component.
@@ -203,27 +267,36 @@ QmlComponent::QmlComponent(QmlEngine *engine, const QByteArray &data, const QUrl
 }
 
 /*!
-    Sets the QmlComponent to use the given XML \a data.  If provided, \a filename
-    is used to set the component name, and to provide a base path for items
-    resolved by this component.
+    \internal
+*/
+QmlComponent::QmlComponent(QmlEngine *engine, QmlCompiledComponent *cc, int start, int count, QObject *parent)
+    : QObject(*(new QmlComponentPrivate), parent)
+{
+    Q_D(QmlComponent);
+    d->engine = engine;
+    d->cc = cc;
+    cc->addref();
+    d->start = start;
+    d->count = count;
+}
 
-    Currently only supported to call once per component.
+/*!
+    Sets the QmlComponent to use the given XML \a data.  If provided, 
+    \a filename is used to set the component name, and to provide a base path 
+    for items resolved by this component.
 */
 void QmlComponent::setData(const QByteArray &data, const QUrl &url)
 {
     Q_D(QmlComponent);
 
-    if(d->cc) d->cc->release();
-    if(d->typeData) d->typeData->release();
-    d->cc = 0;
-    d->typeData = 0;
+    d->clear();
 
-    d->name = url.toString();
+    d->url = url;
 
-    QmlCompositeTypeManager::TypeData *typeData = 
+    QmlCompositeTypeData *typeData = 
         d->engine->d_func()->typeManager.getImmediate(data, url);
     
-    if(typeData->status == QmlCompositeTypeManager::TypeData::Waiting) {
+    if(typeData->status == QmlCompositeTypeData::Waiting) {
 
         d->typeData = typeData;
         d->typeData->addWaiter(d);
@@ -234,13 +307,54 @@ void QmlComponent::setData(const QByteArray &data, const QUrl &url)
 
     }
 
+    emit statusChanged(status());
 }
 
-bool QmlComponent::isReady() const
+/*!
+    Load the QmlComponent from the provided \a url.
+*/
+void QmlComponent::loadUrl(const QUrl &url)
+{
+    Q_D(QmlComponent);
+
+    d->clear();
+
+    d->url = url;
+
+    QmlCompositeTypeData *data = 
+        d->engine->d_func()->typeManager.get(url);
+
+    if(data->status == QmlCompositeTypeData::Waiting) {
+
+        d->typeData = data;
+        d->typeData->addWaiter(d);
+
+    } else {
+
+        d->fromTypeData(data);
+
+    }
+
+    emit statusChanged(status());
+}
+
+QString QmlComponent::errorDescription() const
 {
     Q_D(const QmlComponent);
+    if(isError())
+        return d->errorDescription;
+    else
+        return QString();
+}
 
-    return d->engine && !d->typeData;
+/*!
+    Return the component URL.  This is the URL passed to either the constructor,
+    or the loadUrl() or setData() methods.
+*/
+QUrl QmlComponent::url() const
+{
+    Q_D(const QmlComponent);
+    return d->url;
 }
 
 /*!
@@ -249,9 +363,6 @@ bool QmlComponent::isReady() const
 QmlComponent::QmlComponent(QmlComponentPrivate &dd, QObject *parent)
     : QObject(dd, parent)
 {
-    Q_D(QmlComponent);
-    d->name = QLatin1String("<unspecified file>");
-    d->cc = new QmlCompiledComponent;
 }
 
 /*!
@@ -320,8 +431,9 @@ QObject *QmlComponent::beginCreate(QmlContext *context)
         qWarning("QmlComponent: Cannot create new component instance before completing the previous");
         return 0;
     }
-    if (!d->cc) {
-        qWarning("QmlComponent: Cannot load component data");
+
+    if(!isReady()) {
+        qWarning("QmlComponent: Cannot create un-ready component");
         return 0;
     }
 
@@ -345,7 +457,7 @@ QObject *QmlComponent::beginCreate(QmlContext *context)
                              << "QmlComponent: "
 #endif
                              << vme.errorDescription().toLatin1().constData() << " @"
-                             << d->name.toLatin1().constData() << ":" << vme.errorLine();
+                             << d->url.toString().toLatin1().constData() << ":" << vme.errorLine();
     }
 
 
diff --git a/src/declarative/qml/qmlcomponent.h b/src/declarative/qml/qmlcomponent.h
index 1a74fe9..91e0917 100644
--- a/src/declarative/qml/qmlcomponent.h
+++ b/src/declarative/qml/qmlcomponent.h
@@ -62,36 +62,43 @@ class Q_DECLARATIVE_EXPORT QmlComponent : public QObject
     Q_OBJECT
     Q_DECLARE_PRIVATE(QmlComponent);
 
-    Q_PROPERTY(QString name READ name WRITE setName);
-
 public:
-    QmlComponent(QObject *parent=0);
+    QmlComponent(QObject *parent = 0);
     QmlComponent(QmlEngine *, QObject *parent=0);
     QmlComponent(QmlEngine *, const QUrl &url, QObject *parent = 0);
-    QmlComponent(QmlEngine *, const QByteArray &, const QUrl &url=QUrl(), QObject *parent=0);
-    ~QmlComponent();
+    QmlComponent(QmlEngine *, const QByteArray &data, 
+                 const QUrl &baseUrl=QUrl(), QObject *parent=0);
+    virtual ~QmlComponent();
 
-    virtual QObject *create(QmlContext *context = 0);
-    virtual QObject *beginCreate(QmlContext *);
-    virtual void completeCreate();
+    enum Status { Null, Ready, Loading, Error };
+    Status status() const;
 
-    QString name() const;
-    void setName(const QString &name);
+    bool isNull() const;
+    bool isReady() const;
+    bool isError() const;
+    bool isLoading() const;
+    QString errorDescription() const;
 
-    void setData(const QByteArray &, const QUrl &url);
+    QUrl url() const;
 
-    bool isReady() const;
+    virtual QObject *create(QmlContext *context = 0);
+    virtual QObject *beginCreate(QmlContext *);
+    virtual void completeCreate();
 
-    QmlComponent(QmlEngine *, QmlCompiledComponent *, int, int, QObject *parent);
+    void loadUrl(const QUrl &url);
+    void setData(const QByteArray &, const QUrl &baseUrl = QUrl());
 
 Q_SIGNALS:
-    void readyChanged();
+    void statusChanged(Status);
 
 protected:
     QmlComponent(QmlComponentPrivate &dd, QObject* parent);
 
 private:
+    QmlComponent(QmlEngine *, QmlCompiledComponent *, int, int, QObject *parent);
+
     friend class QmlVME;
+    friend class QmlCompositeTypeData;
 };
 QML_DECLARE_TYPE(QmlComponent);
 
diff --git a/src/declarative/qml/qmlcomponent_p.h b/src/declarative/qml/qmlcomponent_p.h
index e97ec67..8074775 100644
--- a/src/declarative/qml/qmlcomponent_p.h
+++ b/src/declarative/qml/qmlcomponent_p.h
@@ -63,12 +63,13 @@ class QmlComponentPrivate : public QObjectPrivate
 public:
     QmlComponentPrivate() : typeData(0), start(-1), count(-1), cc(0), completePending(false), engine(0) {}
 
-    QmlCompositeTypeManager::TypeData *typeData;
+    QmlCompositeTypeData *typeData;
     void typeDataReady();
     
-    void fromTypeData(QmlCompositeTypeManager::TypeData *data);
+    void fromTypeData(QmlCompositeTypeData *data);
 
-    QString name;
+    QString errorDescription;
+    QUrl url;
 
     int start;
     int count;
@@ -78,6 +79,8 @@ public:
     bool completePending;
 
     QmlEngine *engine;
+
+    void clear();
 };
 
 #endif // QMLCOMPONENT_P_H
diff --git a/src/declarative/qml/qmlcompositetypemanager.cpp b/src/declarative/qml/qmlcompositetypemanager.cpp
index 65596ae..b0d121c 100644
--- a/src/declarative/qml/qmlcompositetypemanager.cpp
+++ b/src/declarative/qml/qmlcompositetypemanager.cpp
@@ -50,12 +50,12 @@
 #include <QtDeclarative/qmlcomponent.h>
 #include <private/qmlcomponent_p.h>
 
-QmlCompositeTypeManager::TypeData::TypeData()
+QmlCompositeTypeData::QmlCompositeTypeData()
 : status(Invalid), component(0), compiledComponent(0)
 {
 }
 
-QmlCompositeTypeManager::TypeData::~TypeData()
+QmlCompositeTypeData::~QmlCompositeTypeData()
 {
     for(int ii = 0; ii < dependants.count(); ++ii)
         dependants.at(ii)->release();
@@ -67,17 +67,17 @@ QmlCompositeTypeManager::TypeData::~TypeData()
         delete component;
 }
 
-void QmlCompositeTypeManager::TypeData::addWaiter(QmlComponentPrivate *p)
+void QmlCompositeTypeData::addWaiter(QmlComponentPrivate *p)
 {
     waiters << p;
 }
 
-void QmlCompositeTypeManager::TypeData::remWaiter(QmlComponentPrivate *p)
+void QmlCompositeTypeData::remWaiter(QmlComponentPrivate *p)
 {
     waiters.removeAll(p);
 }
 
-QmlComponent *QmlCompositeTypeManager::TypeData::toComponent(QmlEngine *engine)
+QmlComponent *QmlCompositeTypeData::toComponent(QmlEngine *engine)
 {
     if(!component) {
 
@@ -94,7 +94,7 @@ QmlComponent *QmlCompositeTypeManager::TypeData::toComponent(QmlEngine *engine)
 }
 
 QmlCompiledComponent *
-QmlCompositeTypeManager::TypeData::toCompiledComponent(QmlEngine *engine)
+QmlCompositeTypeData::toCompiledComponent(QmlEngine *engine)
 {
     if(status == Complete && !compiledComponent) {
 
@@ -123,7 +123,7 @@ QmlCompositeTypeManager::TypeData::toCompiledComponent(QmlEngine *engine)
     return compiledComponent;
 }
 
-QmlCompositeTypeManager::TypeData::TypeReference::TypeReference()
+QmlCompositeTypeData::TypeReference::TypeReference()
 : type(0), unit(0), parser(0) 
 {
 }
@@ -133,13 +133,13 @@ QmlCompositeTypeManager::QmlCompositeTypeManager(QmlEngine *e)
 {
 }
 
-QmlCompositeTypeManager::TypeData *QmlCompositeTypeManager::get(const QUrl &url)
+QmlCompositeTypeData *QmlCompositeTypeManager::get(const QUrl &url)
 {
-    TypeData *unit = components.value(url.toString());
+    QmlCompositeTypeData *unit = components.value(url.toString());
 
     if(!unit) {
-        unit = new TypeData;
-        unit->status = TypeData::Waiting;
+        unit = new QmlCompositeTypeData;
+        unit->status = QmlCompositeTypeData::Waiting;
         unit->url = url.toString();
         components.insert(url.toString(), unit);
 
@@ -150,11 +150,11 @@ QmlCompositeTypeManager::TypeData *QmlCompositeTypeManager::get(const QUrl &url)
     return unit;
 }
 
-QmlCompositeTypeManager::TypeData *
+QmlCompositeTypeData *
 QmlCompositeTypeManager::getImmediate(const QByteArray &data, const QUrl &url)
 {
-    TypeData *unit = new TypeData;
-    unit->status = TypeData::Waiting;
+    QmlCompositeTypeData *unit = new QmlCompositeTypeData;
+    unit->status = QmlCompositeTypeData::Waiting;
     unit->url = url.toString();
     setData(unit, data, url);
     return unit;
@@ -163,7 +163,7 @@ QmlCompositeTypeManager::getImmediate(const QByteArray &data, const QUrl &url)
 void QmlCompositeTypeManager::clearCache()
 {
     for(Components::Iterator iter = components.begin(); iter != components.end();) {
-        if((*iter)->status != TypeData::Waiting) {
+        if((*iter)->status != QmlCompositeTypeData::Waiting) {
             (*iter)->release();
             iter = components.erase(iter);
         } else {
@@ -177,7 +177,7 @@ void QmlCompositeTypeManager::replyFinished()
 {
     QNetworkReply *reply = static_cast<QNetworkReply *>(sender());
 
-    TypeData *unit = components.value(reply->url().toString());
+    QmlCompositeTypeData *unit = components.value(reply->url().toString());
     Q_ASSERT(unit);
 
     if(reply->error() != QNetworkReply::NoError) {
@@ -187,7 +187,7 @@ void QmlCompositeTypeManager::replyFinished()
         errorDescription = QLatin1String("Network error for URL ") + 
                       reply->url().toString();
 
-        unit->status = TypeData::Error;
+        unit->status = QmlCompositeTypeData::Error;
         unit->errorDescription = errorDescription;
         doComplete(unit);
 
@@ -200,7 +200,7 @@ void QmlCompositeTypeManager::replyFinished()
     reply->deleteLater();
 }
 
-void QmlCompositeTypeManager::loadSource(TypeData *unit)
+void QmlCompositeTypeManager::loadSource(QmlCompositeTypeData *unit)
 {
     QUrl url(unit->url);
 
@@ -214,7 +214,7 @@ void QmlCompositeTypeManager::loadSource(TypeData *unit)
             QString errorDescription;
             // ### - Fill in error
             errorDescription = QLatin1String("File error for URL ") + url.toString();
-            unit->status = TypeData::Error;
+            unit->status = QmlCompositeTypeData::Error;
             unit->errorDescription = errorDescription;
             doComplete(unit);
         }
@@ -227,12 +227,13 @@ void QmlCompositeTypeManager::loadSource(TypeData *unit)
     }
 }
 
-void QmlCompositeTypeManager::setData(TypeData *unit, const QByteArray &data,
-                              const QUrl &url)
+void QmlCompositeTypeManager::setData(QmlCompositeTypeData *unit, 
+                                     const QByteArray &data,
+                                     const QUrl &url)
 {
     if(!unit->data.parse(data, url)) {
 
-        unit->status = TypeData::Error;
+        unit->status = QmlCompositeTypeData::Error;
         unit->errorDescription = unit->data.errorDescription();
         doComplete(unit);
 
@@ -244,7 +245,7 @@ void QmlCompositeTypeManager::setData(TypeData *unit, const QByteArray &data,
     }
 }
 
-void QmlCompositeTypeManager::doComplete(TypeData *unit)
+void QmlCompositeTypeManager::doComplete(QmlCompositeTypeData *unit)
 {
     for(int ii = 0; ii < unit->dependants.count(); ++ii) {
         checkComplete(unit->dependants.at(ii));
@@ -258,34 +259,34 @@ void QmlCompositeTypeManager::doComplete(TypeData *unit)
     }
 }
 
-void QmlCompositeTypeManager::checkComplete(TypeData *unit)
+void QmlCompositeTypeManager::checkComplete(QmlCompositeTypeData *unit)
 {
-    if(unit->status != TypeData::Waiting)
+    if(unit->status != QmlCompositeTypeData::Waiting)
         return;
 
     int waiting = 0;
     for(int ii = 0; ii < unit->types.count(); ++ii) {
-        TypeData *u = unit->types.at(ii).unit;
+        QmlCompositeTypeData *u = unit->types.at(ii).unit;
 
         if(!u)
             continue;
 
-        if(u->status == TypeData::Error) {
-            unit->status = TypeData::Error;
+        if(u->status == QmlCompositeTypeData::Error) {
+            unit->status = QmlCompositeTypeData::Error;
             unit->errorDescription = u->errorDescription;
             doComplete(unit);
             return;
-        } else if(u->status == TypeData::Waiting) {
+        } else if(u->status == QmlCompositeTypeData::Waiting) {
             waiting++;
         }
     }
     if(!waiting) {
-        unit->status = TypeData::Complete;
+        unit->status = QmlCompositeTypeData::Complete;
         doComplete(unit);
     }
 }
 
-void QmlCompositeTypeManager::compile(TypeData *unit)
+void QmlCompositeTypeManager::compile(QmlCompositeTypeData *unit)
 {
     QStringList typeNames = unit->data.types();
 
@@ -293,7 +294,7 @@ void QmlCompositeTypeManager::compile(TypeData *unit)
     for(int ii = 0; ii < typeNames.count(); ++ii) {
         QByteArray type = typeNames.at(ii).toLatin1();
 
-        TypeData::TypeReference ref;
+        QmlCompositeTypeData::TypeReference ref;
         if (type == QByteArray("Property") ||
             type == QByteArray("Signal")) {
             unit->types << ref;
@@ -317,11 +318,11 @@ void QmlCompositeTypeManager::compile(TypeData *unit)
         }
 
         QUrl url = engine->componentUrl(QUrl(type + ".qml"), QUrl(unit->url));
-        TypeData *urlUnit = components.value(url.toString());
+        QmlCompositeTypeData *urlUnit = components.value(url.toString());
 
         if(!urlUnit) {
-            urlUnit = new TypeData;
-            urlUnit->status = TypeData::Waiting;
+            urlUnit = new QmlCompositeTypeData;
+            urlUnit->status = QmlCompositeTypeData::Waiting;
             urlUnit->url = url.toString();
             components.insert(url.toString(), urlUnit);
 
@@ -330,17 +331,17 @@ void QmlCompositeTypeManager::compile(TypeData *unit)
 
         ref.unit = urlUnit;
         switch(urlUnit->status) {
-        case TypeData::Invalid:
-        case TypeData::Error:
-            unit->status = TypeData::Error;
+        case QmlCompositeTypeData::Invalid:
+        case QmlCompositeTypeData::Error:
+            unit->status = QmlCompositeTypeData::Error;
             unit->errorDescription = urlUnit->errorDescription;
             doComplete(unit);
             return;
 
-        case TypeData::Complete:
+        case QmlCompositeTypeData::Complete:
             break;
 
-        case TypeData::Waiting:
+        case QmlCompositeTypeData::Waiting:
             unit->addref();
             ref.unit->dependants << unit;
             waiting++;
@@ -351,9 +352,9 @@ void QmlCompositeTypeManager::compile(TypeData *unit)
     }
 
     if(waiting) {
-        unit->status = TypeData::Waiting;
+        unit->status = QmlCompositeTypeData::Waiting;
     } else {
-        unit->status = TypeData::Complete;
+        unit->status = QmlCompositeTypeData::Complete;
         doComplete(unit);
     }
 }
diff --git a/src/declarative/qml/qmlcompositetypemanager_p.h b/src/declarative/qml/qmlcompositetypemanager_p.h
index 6982844..814e753 100644
--- a/src/declarative/qml/qmlcompositetypemanager_p.h
+++ b/src/declarative/qml/qmlcompositetypemanager_p.h
@@ -53,70 +53,71 @@ class QmlEngine;
 class QmlCompiledComponent;
 class QmlComponentPrivate;
 class QmlComponent;
+struct QmlCompositeTypeData : public QmlRefCount
+{
+    QmlCompositeTypeData();
+    virtual ~QmlCompositeTypeData();
+
+    enum Status { 
+        Invalid,
+        Complete,
+        Error,
+        Waiting
+    };
+    Status status;
+    QString errorDescription;
+
+    QString url;
+    QList<QmlCompositeTypeData *> dependants;
+
+    // Return a QmlComponent if the QmlCompositeTypeData is not in the Waiting 
+    // state.  The QmlComponent is owned by the QmlCompositeTypeData, so a 
+    // reference should be kept to keep the QmlComponent alive.
+    QmlComponent *toComponent(QmlEngine *);
+    // Return a QmlCompiledComponent if possible, or 0 if an error
+    // occurs
+    QmlCompiledComponent *toCompiledComponent(QmlEngine *);
+
+    struct TypeReference 
+    {
+        TypeReference();
+
+        QmlType *type;
+        QmlCompositeTypeData *unit;
+        QmlCustomParser *parser;
+    };
+
+    QList<TypeReference> types;
+
+    // Add or remove p as a waiter.  When the QmlCompositeTypeData becomes 
+    // ready, the QmlComponentPrivate::typeDataReady() method will be invoked on
+    // p.  The waiter is automatically removed when the typeDataReady() method
+    // is invoked, so there is no need to call remWaiter() in this case.
+    void addWaiter(QmlComponentPrivate *p);
+    void remWaiter(QmlComponentPrivate *p);
+
+private:
+    friend class QmlCompositeTypeManager;
+    friend class QmlCompiler;
+
+    QmlXmlParser data;
+    QList<QmlComponentPrivate *> waiters;
+    QmlComponent *component;
+    QmlCompiledComponent *compiledComponent;
+};
+
 class QmlCompositeTypeManager : public QObject
 {
     Q_OBJECT
 public:
     QmlCompositeTypeManager(QmlEngine *);
 
-    struct TypeData : public QmlRefCount
-    {
-        TypeData();
-        virtual ~TypeData();
-
-        enum Status { 
-            Invalid,
-            Complete,
-            Error,
-            Waiting
-        };
-        Status status;
-        QString errorDescription;
-
-        QString url;
-        QList<TypeData *> dependants;
-
-        // Return a QmlComponent if the TypeData is not in the Waiting state.
-        // The QmlComponent is owned by the TypeData, so a reference should be
-        // kept to keep the QmlComponent alive.
-        QmlComponent *toComponent(QmlEngine *);
-        // Return a QmlCompiledComponent if possible, or 0 if an error
-        // occurs
-        QmlCompiledComponent *toCompiledComponent(QmlEngine *);
-
-        struct TypeReference 
-        {
-            TypeReference();
-
-            QmlType *type;
-            TypeData *unit;
-            QmlCustomParser *parser;
-        };
-
-        QList<TypeReference> types;
-
-        // Add or remove p as a waiter.  When the TypeData becomes ready, the
-        // QmlComponentPrivate::typeDataReady() method will be invoked on p.
-        // The waiter is automatically removed when the typeDataReady() method
-        // is invoked, so there is no need to call remWaiter() in this case.
-        void addWaiter(QmlComponentPrivate *p);
-        void remWaiter(QmlComponentPrivate *p);
-
-    private:
-        friend class QmlCompositeTypeManager;
-        friend class QmlCompiler;
-
-        QmlXmlParser data;
-        QList<QmlComponentPrivate *> waiters;
-        QmlComponent *component;
-        QmlCompiledComponent *compiledComponent;
-    };
-
-    // Return a TypeData for url.  The TypeData may be cached.
-    TypeData *get(const QUrl &url);
-    // Return a TypeData for data, with the provided base url.  The TypeData 
-    // will not be cached.
-    TypeData *getImmediate(const QByteArray &data, const QUrl &url);
+    // Return a QmlCompositeTypeData for url.  The QmlCompositeTypeData may be 
+    // cached.
+    QmlCompositeTypeData *get(const QUrl &url);
+    // Return a QmlCompositeTypeData for data, with the provided base url.  The
+   //  QmlCompositeTypeData will not be cached.
+    QmlCompositeTypeData *getImmediate(const QByteArray &data, const QUrl &url);
 
     // Clear cached types.  Only types that aren't in the Waiting state will
     // be cleared.
@@ -126,15 +127,15 @@ private Q_SLOTS:
     void replyFinished();
 
 private:
-    void loadSource(TypeData *);
-    void compile(TypeData *);
-    void setData(TypeData *, const QByteArray &, const QUrl &);
+    void loadSource(QmlCompositeTypeData *);
+    void compile(QmlCompositeTypeData *);
+    void setData(QmlCompositeTypeData *, const QByteArray &, const QUrl &);
 
-    void doComplete(TypeData *);
-    void checkComplete(TypeData *);
+    void doComplete(QmlCompositeTypeData *);
+    void checkComplete(QmlCompositeTypeData *);
 
     QmlEngine *engine;
-    typedef QHash<QString, TypeData *> Components;
+    typedef QHash<QString, QmlCompositeTypeData *> Components;
     Components components;
 };
 
diff --git a/src/declarative/qml/qmllist.h b/src/declarative/qml/qmllist.h
index 3a1e665..cc13924 100644
--- a/src/declarative/qml/qmllist.h
+++ b/src/declarative/qml/qmllist.h
@@ -56,7 +56,9 @@ class QmlList : private QmlPrivate::ListInterface
 public:
     virtual void append(T) = 0;
     virtual void insert(int, T) = 0;
+    virtual void removeAt(int) = 0;
     virtual T at(int) const = 0;
+    virtual int count() const = 0;
     virtual void clear() = 0;
     QmlList<T> &operator<<(T t) { append(t); return *this; }
 
diff --git a/src/declarative/qml/qmlmetatype.cpp b/src/declarative/qml/qmlmetatype.cpp
index 584ccde..51d5607 100644
--- a/src/declarative/qml/qmlmetatype.cpp
+++ b/src/declarative/qml/qmlmetatype.cpp
@@ -667,11 +667,6 @@ QmlMetaType::attachedPropertiesFunc(const QByteArray &name)
 QMetaProperty QmlMetaType::defaultProperty(const QMetaObject *metaObject)
 {
     int idx = metaObject->indexOfClassInfo("DefaultProperty");
-    while(idx == -1 && metaObject) {
-        metaObject = metaObject->superClass();
-        if(metaObject)
-            idx = metaObject->indexOfClassInfo("DefaultProperty");
-    }
     if(-1 == idx)
         return QMetaProperty();
 
@@ -698,11 +693,6 @@ QMetaProperty QmlMetaType::defaultProperty(QObject *obj)
 QMetaMethod QmlMetaType::defaultMethod(const QMetaObject *metaObject)
 {
     int idx = metaObject->indexOfClassInfo("DefaultMethod");
-    while(idx == -1 && metaObject) {
-        metaObject = metaObject->superClass();
-        if(metaObject)
-            idx = metaObject->indexOfClassInfo("DefaultMethod");
-    }
     if(-1 == idx)
         return QMetaMethod();
 
diff --git a/src/declarative/qml/script/tokens.cpp b/src/declarative/qml/script/tokens.cpp
index 51b46f0..a2fb100 100644
--- a/src/declarative/qml/script/tokens.cpp
+++ b/src/declarative/qml/script/tokens.cpp
@@ -12,7 +12,6 @@
 
 
 /*!
-  \relates <tokens.h>
   Returns a string representation of token \a tok.
 */
 const char *tokenToString(Token tok)
diff --git a/src/declarative/timeline/gfxeasing.cpp b/src/declarative/timeline/gfxeasing.cpp
index c89ba88..59767b2 100644
--- a/src/declarative/timeline/gfxeasing.cpp
+++ b/src/declarative/timeline/gfxeasing.cpp
@@ -357,7 +357,7 @@ Q_GLOBAL_STATIC(ConfigFunctionMap, configFunctionMap);
 
 /*!
     \class GfxEasing
-    \ingroup animation
+    \ingroup group_animation
     \brief The GfxEasing class provides easing curves for controlling animation.
 
     Easing curves describe a function that controls how a value changes over
diff --git a/src/declarative/timeline/gfxtimeline.cpp b/src/declarative/timeline/gfxtimeline.cpp
index 36b18d0..3e84df8 100644
--- a/src/declarative/timeline/gfxtimeline.cpp
+++ b/src/declarative/timeline/gfxtimeline.cpp
@@ -261,7 +261,7 @@ qreal QmlTimeLinePrivate::value(const Op &op, int time, qreal base, bool *change
 
 /*!
     \class QmlTimeLine
-    \ingroup animation
+    \ingroup group_animation
     \brief The QmlTimeLine class provides a timeline for controlling animations.
 
     QmlTimeLine is similar to QTimeLine except:
@@ -872,7 +872,7 @@ void QmlTimeLine::remove(QmlTimeLineObject *v)
 
 /*!
     \class GfxValue
-    \ingroup animation
+    \ingroup group_animation
     \brief The GfxValue class is modified by QmlTimeLine.
 */
 
diff --git a/src/declarative/util/qfxview.cpp b/src/declarative/util/qfxview.cpp
index 3fb30e9..4aa0932 100644
--- a/src/declarative/util/qfxview.cpp
+++ b/src/declarative/util/qfxview.cpp
@@ -200,16 +200,16 @@ void QFxView::execute()
         d->component = new QmlComponent(&d->engine, d->xml.toUtf8(), d->source);
     }
 
-    if(d->component->isReady()) {
+    if(!d->component->isLoading()) {
         continueExecute();
     } else {
-        connect(d->component, SIGNAL(readyChanged()), this, SLOT(continueExecute()));
+        connect(d->component, SIGNAL(statusChanged(Status)), this, SLOT(continueExecute()));
     }
 }
 
 void QFxView::continueExecute()
 {
-    disconnect(d->component, SIGNAL(readyChanged()), this, SLOT(continueExecute()));
+    disconnect(d->component, SIGNAL(statusChanged(Status)), this, SLOT(continueExecute()));
 
     if(!d->component){
         qWarning() << "Error in loading" << d->source;
diff --git a/src/declarative/util/qmlanimation.cpp b/src/declarative/util/qmlanimation.cpp
index 729d53a..de6d84c 100644
--- a/src/declarative/util/qmlanimation.cpp
+++ b/src/declarative/util/qmlanimation.cpp
@@ -538,14 +538,15 @@ void QmlAbstractAnimation::timelineComplete()
 /*!
     \internal
     \class QmlPauseAnimation
-    \ingroup animation states
+    \ingroup group_animation
+    \ingroup group_states
     \brief The QmlPauseAnimation class provides a pause for an animation.
 
     When used in a QmlSequentialAnimation, QmlPauseAnimation is a step when
     nothing happens, for a specified duration.
 
     A QmlPauseAnimation object can be instantiated in Qml using the tag
-    \ref xmlPauseAnimation "&lt;PauseAnimation&gt;".
+    \l{xmlPauseAnimation} {&lt;PauseAnimation&gt;}.
 */
 
 QML_DEFINE_TYPE(QmlPauseAnimation,PauseAnimation);
@@ -629,11 +630,12 @@ QAbstractAnimation *QmlPauseAnimation::qtAnimation()
 /*!
     \internal
     \class QmlColorAnimation
-    \ingroup animation states
+    \ingroup group_animation
+    \ingroup group_states
     \brief The QmlColorAnimation class allows you to animate color changes.
 
     A QmlColorAnimation object can be instantiated in Qml using the tag
-    \ref xmlColorAnimation "&lt;ColorAnimation&gt;".
+    \l{xmlColorAnimation} {&lt;ColorAnimation&gt;}.
 */
 
 QmlColorAnimation::QmlColorAnimation(QObject *parent)
@@ -930,9 +932,9 @@ QML_DEFINE_TYPE(QmlColorAnimation,ColorAnimation);
 /*!
     \internal
     \class QmlRunScriptAction
-    \brief The QmlRunScriptAction class allows scropts to be run during transitions
+    \brief The QmlRunScriptAction class allows scripts to be run during transitions
 
-    \ref xmlRunScriptAction
+    \sa xmlRunScriptAction
 */
 QmlRunScriptAction::QmlRunScriptAction(QObject *parent)
     :QmlAbstractAnimation(*(new QmlRunScriptActionPrivate), parent)
@@ -1039,7 +1041,7 @@ QML_DEFINE_TYPE(QmlRunScriptAction, RunScriptAction);
     \brief The QmlSetPropertyAction class allows property changes during transitions.
 
     A QmlSetPropertyAction object can be instantiated in Qml using the tag
-    \ref xmlSetPropertyAction "&lt;SetPropertyAction&gt;".
+    \l{xmlSetPropertyAction} {&lt;SetPropertyAction&gt;}.
 */
 QmlSetPropertyAction::QmlSetPropertyAction(QObject *parent)
 : QmlAbstractAnimation(*(new QmlSetPropertyActionPrivate), parent)
@@ -1337,11 +1339,12 @@ QML_DEFINE_TYPE(QmlParentChangeAction,ParentChangeAction);
 /*!
     \internal
     \class QmlNumericAnimation
-    \ingroup animation states
+    \ingroup group_animation
+    \ingroup group_states
     \brief The QmlNumericAnimation class allows you to animate changes in properties of type qreal.
 
     A QmlNumericAnimation object can be instantiated in Qml using the tag
-    \ref xmlNumericAnimation "&lt;NumericAnimation&gt;".
+    \l{xmlNumericAnimation} {&lt;NumericAnimation&gt;}.
 */
 
 QmlNumericAnimation::QmlNumericAnimation(QObject *parent)
@@ -1766,7 +1769,8 @@ QML_DEFINE_TYPE(QmlSequentialAnimation,SequentialAnimation);
 /*!
     \internal
     \class QmlParallelAnimation
-    \ingroup animation states
+    \ingroup group_animation
+    \ingroup group_states
     \brief The QmlParallelAnimation class allows you to run animations in parallel.
 
     Animations controlled by QmlParallelAnimation will be run at the same time.
@@ -1774,7 +1778,7 @@ QML_DEFINE_TYPE(QmlSequentialAnimation,SequentialAnimation);
     \sa QmlSequentialAnimation
 
     A QmlParallelAnimation object can be instantiated in Qml using the tag
-    \ref xmlParallelAnimation "&lt;ParallelAnimation&gt;".
+    \l{xmlParallelAnimation} {&lt;ParallelAnimation&gt;}.
 */
 
 QmlParallelAnimation::QmlParallelAnimation(QObject *parent) :
diff --git a/src/declarative/util/qmlbind.cpp b/src/declarative/util/qmlbind.cpp
index d71d711..4451ca2 100644
--- a/src/declarative/util/qmlbind.cpp
+++ b/src/declarative/util/qmlbind.cpp
@@ -77,10 +77,10 @@ QML_DEFINE_TYPE(QmlBind,Bind);
     property into QML.  You could use Bind to update the enteredText property 
     like this.
     \code
-    <LineEdit id="myTextField" text="Please type here..." />
+    <TextEdit id="myTextField" text="Please type here..." />
     <Bind target="{app}" property="enteredText" value="{myTextField.text}" />
     \endcode
-    Whenever the text in the LineEdit is updated, the C++ property will be
+    Whenever the text in the TextEdit is updated, the C++ property will be
     updated also.
 
     If the bind target or bind property is changed, the bound value is 
@@ -91,7 +91,7 @@ QML_DEFINE_TYPE(QmlBind,Bind);
 /*!
     \internal
     \class QmlBind
-    \ingroup utility
+    \ingroup group_utility
     \brief The QmlBind class allows arbitrary property bindings to be created.
 
     Simple bindings are usually earier to do in-place rather than creating a
diff --git a/src/declarative/util/qmldatetimeformatter.cpp b/src/declarative/util/qmldatetimeformatter.cpp
index 138f68b..efddd81 100644
--- a/src/declarative/util/qmldatetimeformatter.cpp
+++ b/src/declarative/util/qmldatetimeformatter.cpp
@@ -85,7 +85,7 @@ public:
 /*!
     \internal
     \class QmlDateTimeFormatter
-    \ingroup utility
+    \ingroup group_utility
     \brief The QmlDateTimeFormatter class allows you to format a date string.
 */
 
diff --git a/src/declarative/util/qmlfont.cpp b/src/declarative/util/qmlfont.cpp
index ad91edd..9f3225a 100644
--- a/src/declarative/util/qmlfont.cpp
+++ b/src/declarative/util/qmlfont.cpp
@@ -56,7 +56,7 @@ QML_DEFINE_TYPE(QmlFont,Font);
 /*!
     \internal
     \class QmlFont
-    \ingroup utility
+    \ingroup group_utility
     \brief The QmlFont class provides a font used for drawing text on a QFxView.
 */
 QmlFont::QmlFont(QObject *parent)
diff --git a/src/declarative/util/qmlscript.cpp b/src/declarative/util/qmlscript.cpp
index a24c427..859e21e 100644
--- a/src/declarative/util/qmlscript.cpp
+++ b/src/declarative/util/qmlscript.cpp
@@ -79,7 +79,7 @@ public:
 /*!
     \qmlclass Script QmlScript
     \brief The Script element adds JavaScript snippets.
-    \ingroup utility
+    \ingroup group_utility
 
     QmlScript is used to add convenient JavaScript "glue" methods to
     your Qt Declarative application or component. While you can have any JavaScript code
@@ -139,7 +139,7 @@ void QmlScript::setScript(const QString &script)
     the file specified.
  */
 /*!
-    \property QmlScript::source
+    \property QmlScript::src
     \brief the path to a script file.
 */
 QString QmlScript::source() const
diff --git a/src/declarative/util/qmlsetproperties.cpp b/src/declarative/util/qmlsetproperties.cpp
index f385391..61890b9 100644
--- a/src/declarative/util/qmlsetproperties.cpp
+++ b/src/declarative/util/qmlsetproperties.cpp
@@ -122,7 +122,7 @@ void QmlSetPropertiesMetaObject::propertyWrite(int id)
     \class QmlSetProperties
     \brief The QmlSetProperties class describes new property values for a state.
 
-    \ingroup states
+    \ingroup group_states
 
     QmlSetProperties is a convenience class for changing many properties on a single
     object. It allows you to specify the property names and values similar to how
diff --git a/src/declarative/util/qmlstate.cpp b/src/declarative/util/qmlstate.cpp
index 50ae6b5..f07fecb 100644
--- a/src/declarative/util/qmlstate.cpp
+++ b/src/declarative/util/qmlstate.cpp
@@ -97,7 +97,7 @@ QmlStateOperation::QmlStateOperation(QObjectPrivate &dd, QObject *parent)
     \class QmlState
     \brief The QmlState class allows you to define configurations of objects and properties.
 
-    \ingroup states
+    \ingroup group_states
 
     QmlState allows you to specify a state as a set of batched changes from the default
     configuration.
diff --git a/src/declarative/util/qmlstateoperations.cpp b/src/declarative/util/qmlstateoperations.cpp
index c2ba4b8..a8779f9 100644
--- a/src/declarative/util/qmlstateoperations.cpp
+++ b/src/declarative/util/qmlstateoperations.cpp
@@ -236,7 +236,7 @@ QmlRunScript::ActionList QmlRunScript::actions()
     \class QmlSetProperty
     \brief The QmlSetProperty class describes a new property value or binding for a state.
 
-    \ingroup states
+    \ingroup group_states
 
     \sa QmlSetProperties
 */
diff --git a/src/declarative/util/qmltransition.cpp b/src/declarative/util/qmltransition.cpp
index fb09e32..181fdb9 100644
--- a/src/declarative/util/qmltransition.cpp
+++ b/src/declarative/util/qmltransition.cpp
@@ -62,7 +62,7 @@ QT_BEGIN_NAMESPACE
     \class QmlTransition
     \brief The QmlTransition class allows you to define animated transitions that occur on state changes.
 
-    \ingroup states
+    \ingroup group_states
 */
 
 //ParallelAnimationWrapperallows us to do a "callback" when the animation finishes, rather than connecting