aboutsummaryrefslogtreecommitdiffstats
path: root/src/quick/doc/src
diff options
context:
space:
mode:
authorSze Howe Koh <szehowe.koh@gmail.com>2013-04-17 23:03:16 +0800
committerThe Qt Project <gerrit-noreply@qt-project.org>2013-04-23 18:29:25 +0200
commit59f075df52f5e78b95b360fb0533c2249924e7a7 (patch)
treeeab4bff86cbabf6ced5beed81238c5744a53d53e /src/quick/doc/src
parentee2a4a90cdfc024d452ca82dfb2e1d84c050595f (diff)
Doc: Qt Quick: Fix module name format (Pt 1/2)
Follow the conventions at http://qt-project.org/wiki/Spelling_Module_Names_in_Qt_Documentation Attempt to differentiate between the whole module ("Qt Quick") and the QML import ("QtQuick") by encoding the latter with monospace font. There are places in the text where both representations are valid. Change-Id: Id6e157a4191aaa4e23a9cd5c76abfe902fe43d33 Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
Diffstat (limited to 'src/quick/doc/src')
-rw-r--r--src/quick/doc/src/appdevguide/performance.qdoc16
-rw-r--r--src/quick/doc/src/appdevguide/porting.qdoc30
-rw-r--r--src/quick/doc/src/appdevguide/usecases/animations.qdoc2
-rw-r--r--src/quick/doc/src/appdevguide/usecases/styling.qdoc4
-rw-r--r--src/quick/doc/src/appdevguide/usecases/text.qdoc2
-rw-r--r--src/quick/doc/src/appdevguide/usecases/userinput.qdoc4
-rw-r--r--src/quick/doc/src/appdevguide/usecases/visual.qdoc6
-rw-r--r--src/quick/doc/src/concepts/convenience/topic.qdoc2
-rw-r--r--src/quick/doc/src/concepts/effects/sprites.qdoc2
-rw-r--r--src/quick/doc/src/qmltypereference.qdoc18
-rw-r--r--src/quick/doc/src/whatsnew.qdoc14
11 files changed, 50 insertions, 50 deletions
diff --git a/src/quick/doc/src/appdevguide/performance.qdoc b/src/quick/doc/src/appdevguide/performance.qdoc
index 28217e06d6..9dcfc961ba 100644
--- a/src/quick/doc/src/appdevguide/performance.qdoc
+++ b/src/quick/doc/src/appdevguide/performance.qdoc
@@ -143,8 +143,8 @@ conversion.
If you must expose a QVariantMap to QML, use a "var" property rather than a "variant"
property. In general, "property var" should be considered to be superior to
-"property variant" for every use-case in QtQuick 2.0 (note that "property variant"
-is marked as obsolete in the QtQuick 2.0 documentation), as it allows a true JavaScript
+"property variant" for every use-case in Qt Quick 2 (note that "property variant"
+is marked as obsolete in the Qt Quick 2 documentation), as it allows a true JavaScript
reference to be stored (which can reduce the number of conversions required in certain
expressions).
@@ -525,7 +525,7 @@ will have a negative impact on performance.
\section2 Other JavaScript Objects
Different JavaScript engines provide different optimizations. The JavaScript engine
-which QtQuick 2 uses is optimized for object instantiation and property lookup, but
+which \l {Qt Quick}{Qt Quick 2} uses is optimized for object instantiation and property lookup, but
the optimizations which it provides relies on certain criteria. If your application
does not meet the criteria, the JavaScript engine falls back to a "slow-path" mode
with much worse performance. As such, always try to ensure you meet the following
@@ -698,7 +698,7 @@ an application already uses one.
\section3 Don't Use Dynamic Roles
-The ListModel element in QtQuick 2.0 is much more performant than in QtQuick 1.0. The
+The ListModel element in \c {QtQuick 2.0} is much more performant than in \c {QtQuick 1.0}. The
performance improvements mainly come from assumptions about the type of roles within each
element in a given model - if the type doesn't change, the caching performance improves
dramatically. If the type can change dynamically from element to element, this optimization
@@ -739,7 +739,7 @@ cause reduced frame rate when scrolling.
\section1 Visual Effects
-QtQuick 2 includes several features which allow developers and designers to create
+\l {Qt Quick}{Qt Quick 2} includes several features which allow developers and designers to create
exceptionally appealing user interfaces. Fluidity and dynamic transitions as well
as visual effects can be used to great effect in an application, but some care must
be taken when using some of the features in QML as they can have performance implications.
@@ -759,7 +759,7 @@ thread (and therefore can cause frames to be skipped if they take too long to co
\section2 Particles
-The QtQuick 2.0 Particles module allows beautiful particle effects to be integrated
+The \l {QtQuick.Particles 2}{Qt Quick 2.0 Particles} module allows beautiful particle effects to be integrated
seamlessly into user interfaces. However every platform has different graphics hardware
capabilities, and the Particles module is unable to limit parameters to what your hardware
can gracefully support. The more particles you attempt to render (and the larger they are),
@@ -834,7 +834,7 @@ See the upcoming section on Rendering for more information on active but invisib
\section1 Rendering
-The scene graph used for rendering in QtQuick 2.0 allows highly dynamic, animated user
+The scene graph used for rendering in \c {QtQuick 2.0} allows highly dynamic, animated user
interfaces to be rendered fluidly at 60 FPS. There are some things which can
dramatically decrease rendering performance, however, and developers should be careful
to avoid these pitfalls wherever possible.
@@ -867,7 +867,7 @@ any animations or bindings evaluation since they are still active).
The scene graph renderer is able to batch up certain operations to minimise the number of
OpenGL state changes required. However, this optimization is only possible for the
-built-in layout elements provided by QtQuick 2.0, and cannot be applied to manual layouts.
+built-in layout elements provided by \c {QtQuick 2.0}, and cannot be applied to manual layouts.
Therefore, application developers should use the Row, Column, Grid, GridView and ListView
elements instead of manual layouts wherever possible.
diff --git a/src/quick/doc/src/appdevguide/porting.qdoc b/src/quick/doc/src/appdevguide/porting.qdoc
index 750a0e1242..c560a5cc08 100644
--- a/src/quick/doc/src/appdevguide/porting.qdoc
+++ b/src/quick/doc/src/appdevguide/porting.qdoc
@@ -49,7 +49,7 @@ There are very few changes in the QML language which affect the porting of exist
\section1 QtQuick Module
-The QtQuick module has been updated to version 2.0. All QML applications should update their import
+The \c QtQuick module has been updated to version 2.0. All QML applications should update their import
statements to use the new version:
\qml
@@ -77,12 +77,12 @@ into a \c QtQuick.LocalStorage singleton type. Any code that requires the local
\e {QtQuick.LocalStorage} instead. See the \l {QtQuick.LocalStorage 2}{QtQuick.LocalStorage} documentation
for examples.
\li The \c LayoutItem type has been removed from the \c QtQuick module as it was specific to the
-Graphics View framework backend used in QtQuick 1.
+Graphics View framework backend used in \c {QtQuick 1}.
\endlist
\section2 Behavioral Changes
-QtQuick 2.0 includes a number of behavioral changes and you should thoroughly test your applications after
+\c {QtQuick 2.0} includes a number of behavioral changes and you should thoroughly test your applications after
porting. These changes will not necessarily lead to run-time errors, but may break certain assumptions in your code.
Below are the prominent changes to be aware of when porting your applications.
@@ -96,7 +96,7 @@ Item opacity and visibility:
\tt {(visible && opacity > 0.0)}.
\li Previously, if an item was in a positioner (i.e. a \l Row, \l Column, \l Grid and \l Flow)
and the item's \c opacity changed to 0, or its \c visible value became \c false, the positioner
- would remove the item from its layout and collapse the space for that item. In QtQuick 2.0, this
+ would remove the item from its layout and collapse the space for that item. In \c {QtQuick 2.0}, this
now only happens when an item's \c visible is \c false; the item opacity no longer affects whether
the item is laid out. (This is consistent with the existing behavior of ListView and GridView).
\endlist
@@ -127,9 +127,9 @@ Other:
\list
\li The \c Qt.labs.particles module has been removed. It is replaced by the fully-fledged \l
-QtQuick.particles module which is an enormous improvement on its predecessor.
+QtQuick.Particles module which is an enormous improvement on its predecessor.
\li The \c Qt.labs.shaders module has been removed as the \c ShaderEffectItem and \l
-ShaderEffectSource types from this module have been moved into the \l QtQuick module. Note the \c
+ShaderEffectSource types from this module have been moved into the \c QtQuick module. Note the \c
ShaderEffectItem type has been renamed to \l ShaderEffect.
\endlist
@@ -139,11 +139,11 @@ ShaderEffectItem type has been renamed to \l ShaderEffect.
In Qt 5, all QML applications are rendered with an OpenGL scenegraph architecture rather than the
Graphics View framework used in Qt 4. Due to the scale of this architectural change, the C++ API has
been extensively restructured and the \c QtDeclarative module has been deprecated in favour of two
-new modules: \l {Qt QML}, which implements the QML engine and language infrastructure, and \l QtQuick,
+new modules: \l {Qt QML}, which implements the QML engine and language infrastructure, and \l {Qt Quick},
which implements the visual canvas and scenegraph backend.
All classes that were previously in the \c QtDeclarative module have been moved into the \l {Qt QML}
-and \l QtQuick modules, and their class names have been changed to reflect their new module
+and \l {Qt Quick} modules, and their class names have been changed to reflect their new module
locations. The class name changes are as follows:
\table
@@ -176,8 +176,8 @@ locations. The class name changes are as follows:
\endlist
\endtable
-To use the new \c QQml* and \c QtQuick* classes in Qt 5, link against the approprate module from
-your qmake \c .pro file. For example the following will link against both the \l {Qt QML} and QtQuick
+To use the new \c QQml* and \c QQuick* classes in Qt 5, link against the approprate module from
+your qmake \c .pro file. For example the following will link against both the \l {Qt QML} and \l {Qt Quick}
modules:
\code
@@ -191,7 +191,7 @@ Required header files can then be included:
#include <QtQuick/QQuickView>
\endcode
-(The \c QtDeclarative module is still available to developers as the \l QtQuick1 module, as
+(The \c QtDeclarative module is still available to developers as the \c {Qt Quick 1} module, as
discussed in \l{Using the QtDeclarative module in Qt 5}{below}. However, it should not be used for
new applications.)
@@ -234,12 +234,12 @@ an overview of creating QML plugins in Qt 5.
\section2 QtDeclarative module in Qt 5
-For the purposes of porting older applications, the \c QtDeclarative module is still available in Qt
-5 but has been renamed to \c QtQuick1. Applications that required QtQuick 1 specific API (e.g.
+For the purposes of porting older applications, the \c {QtDeclarative} module is still available in Qt
+5 but has been renamed to \c {Qt Quick 1}. Applications that required Qt Quick 1 specific API (e.g.
QDeclarativeView or QDeclarativeItem and the Graphics View integration) can use this module. Note
-that new applications should use the new \l {Qt QML} and \l QtQuick modules instead.
+that new applications should use the new \l {Qt QML} and \l {Qt Quick} modules instead.
-To use the \c QtQuick1 module, add “quick1” module to your qmake \c .pro file:
+To use the \c {Qt Quick 1} module, add "quick1" to your qmake \c .pro file:
\code
QT += quick1
diff --git a/src/quick/doc/src/appdevguide/usecases/animations.qdoc b/src/quick/doc/src/appdevguide/usecases/animations.qdoc
index b237849caf..3249a632f5 100644
--- a/src/quick/doc/src/appdevguide/usecases/animations.qdoc
+++ b/src/quick/doc/src/appdevguide/usecases/animations.qdoc
@@ -29,7 +29,7 @@
\title Usecase - Animations In QML
\brief Example of how to include animations in QML applications
-QtQuick provides the ability to animate properties. Animating properties allows property values to move through
+\l {Qt Quick} provides the ability to animate properties. Animating properties allows property values to move through
intermediate values instead of immediately changing to the target value. To animate the position of an item, you can
animate the properties that controle the item's position, x and y for example, so that the item's position
changes each frame on the way to the target position.
diff --git a/src/quick/doc/src/appdevguide/usecases/styling.qdoc b/src/quick/doc/src/appdevguide/usecases/styling.qdoc
index 68b8d0302c..f8c7a94d30 100644
--- a/src/quick/doc/src/appdevguide/usecases/styling.qdoc
+++ b/src/quick/doc/src/appdevguide/usecases/styling.qdoc
@@ -29,8 +29,8 @@
\title Use Case - Style And Theme Support
\brief Example of how to style user interface components in QML
-The types provided in the QtQuick module are not complete user interface components on their own. A common use case is to
-develop a set of custom styled user interface components out of the types in the QtQuick module. This is easily
+The types provided in the \l {Qt Quick} module are not complete user interface components on their own. A common use case is to
+develop a set of custom styled user interface components out of the types in the \l {Qt Quick} module. This is easily
accomplished by creating your own reusable components.
With the reusable components approach, you define your own type with the appearance you want to have in your
diff --git a/src/quick/doc/src/appdevguide/usecases/text.qdoc b/src/quick/doc/src/appdevguide/usecases/text.qdoc
index d0b8901170..94400ff9d8 100644
--- a/src/quick/doc/src/appdevguide/usecases/text.qdoc
+++ b/src/quick/doc/src/appdevguide/usecases/text.qdoc
@@ -28,7 +28,7 @@
\page qtquick-usecase-text.html
\title Use Case - Displaying Text In QML
\brief Example of how to display text in QML
-To display text the Text type is provided by the QtQuick module. For related uses, the \l{TextInput} and
+To display text the Text type is provided by the \l {Qt Quick} module. For related uses, the \l{TextInput} and
\l{TextEdit} types provide editable text controls. For full HTML markup, see the \c{QtWebkit} module.
\section1 Displaying and Formatting Text
diff --git a/src/quick/doc/src/appdevguide/usecases/userinput.qdoc b/src/quick/doc/src/appdevguide/usecases/userinput.qdoc
index 1e20f9d275..460f86add0 100644
--- a/src/quick/doc/src/appdevguide/usecases/userinput.qdoc
+++ b/src/quick/doc/src/appdevguide/usecases/userinput.qdoc
@@ -31,7 +31,7 @@
\section1 Supported Types of User Input
-The \l QtQuick module provides support for the most common types of user input,
+The \l {Qt Quick} module provides support for the most common types of user input,
including mouse and touch events, text input and key-press events. Other
modules provide support for other types of user input (for example, the
\l QtSensors module provides support for shake-gestures in QML applications).
@@ -65,7 +65,7 @@ to true on a single \l Item and do all your key handling there.
\snippet qml/usecases/userinput-keys.qml 0
-For text input the \l QtQuick module provides several built-in types.
+For text input the \l {Qt Quick} module provides several built-in types.
In particular, the \l TextInput and \l TextEdit types allow for single-line
entry and multi-line editing respectively.
diff --git a/src/quick/doc/src/appdevguide/usecases/visual.qdoc b/src/quick/doc/src/appdevguide/usecases/visual.qdoc
index a022b185fe..7e9e654b88 100644
--- a/src/quick/doc/src/appdevguide/usecases/visual.qdoc
+++ b/src/quick/doc/src/appdevguide/usecases/visual.qdoc
@@ -31,7 +31,7 @@
\section1 The Rectangle Type
-For the most basic of visuals, QtQuick provides a \l Rectangle type to draw rectangles. These rectangles can be colored with a
+For the most basic of visuals, \l {Qt Quick} provides a \l Rectangle type to draw rectangles. These rectangles can be colored with a
color or a vertical gradient. The \l Rectangle type can also draw borders on the rectangle.
For drawing custom shapes beyond rectangles, see the \l Canvas type or display
@@ -42,7 +42,7 @@ a pre-rendered image using the \l Image type.
\section1 The Image Type
-QtQuick provides an \l Image type which may be used to display images. The
+\l {Qt Quick} provides an \l Image type which may be used to display images. The
\l Image type has a \l source property whose value can be a remote or local
URL, or the URL of an image file embedded in a compiled resource file.
@@ -58,7 +58,7 @@ For displaying video files and camera data, see the \l QtMultimedia module.
\section1 Shared Visual Properties
-All visual items provided by the QtQuick are based on the Item type, which provides a common set of attributes for
+All visual items provided by \l {Qt Quick} are based on the Item type, which provides a common set of attributes for
visual items, including opacity and transform attributes.
\section2 Opacity and Visibility
diff --git a/src/quick/doc/src/concepts/convenience/topic.qdoc b/src/quick/doc/src/concepts/convenience/topic.qdoc
index 113b4952a6..1a6feeaa61 100644
--- a/src/quick/doc/src/concepts/convenience/topic.qdoc
+++ b/src/quick/doc/src/concepts/convenience/topic.qdoc
@@ -66,7 +66,7 @@ required (or when it becomes available).
\section1 Dynamic Signal Connections
QML supports dynamic signal connections through a signal's \c{connect()}
-method. The QtQuick module provides the convenience \l Connections type which
+method. The \l {Qt Quick} module provides the convenience \l Connections type which
allows setting up a signal connection involving an object which isn't part of
the static object hierarchy. It also allows the connection to be dynamically
retargeted at runtime, which allows an application to process different signal
diff --git a/src/quick/doc/src/concepts/effects/sprites.qdoc b/src/quick/doc/src/concepts/effects/sprites.qdoc
index 7ee98a533b..3a82f1963b 100644
--- a/src/quick/doc/src/concepts/effects/sprites.qdoc
+++ b/src/quick/doc/src/concepts/effects/sprites.qdoc
@@ -36,7 +36,7 @@
\section1 Sprite Engine
-The QtQuick sprite engine is a stochastic state machine combined with the ability
+The \l {Qt Quick} sprite engine is a stochastic state machine combined with the ability
to chop up images containing multiple frames of an animation.
\section2 State Machine
diff --git a/src/quick/doc/src/qmltypereference.qdoc b/src/quick/doc/src/qmltypereference.qdoc
index 14f0151a3b..413d5aae9c 100644
--- a/src/quick/doc/src/qmltypereference.qdoc
+++ b/src/quick/doc/src/qmltypereference.qdoc
@@ -36,19 +36,19 @@ interfaces and applications with QML. This page lists every QML type provided
by this module, organized according to category and purpose.
-\section1 Importing QtQuick
+\section1 Importing \c QtQuick
-The types provided by the QtQuick module are only available in a QML document
+The types provided by the \l {Qt Quick} module are only available in a QML document
if that document imports the \c QtQuick namespace.
-The current version of the QtQuick module is version 2.0, and thus it may be
+The current version of the \c QtQuick module is version 2.0, and thus it may be
imported via the following statement:
\qml
import QtQuick 2.0
\endqml
-See the QtQuick module documentation for more
+See the \l {Qt Quick} module documentation for more
information about the concepts which are central to \c QtQuick.
\section2 Submodules
@@ -72,12 +72,12 @@ There are a number of basic types that are
\l{qtqml-typesystem-basictypes.html#basic-types-provided-by-the-qml-language}
{supported by default in the QML language}.
-In addition, the QtQuick module provides the following basic types:
+In addition, the \c QtQuick module provides the following basic types:
\annotatedlist qtquickbasictypes
\section1 Object Types
-All of the object types provided by QtQuick are based on the \l{Item} type,
+All of the object types provided by \c QtQuick are based on the \l{Item} type,
which itself derives from \l{QML::QtObject}. \l{qtqml-typereference-topic.html#object-types}
{QML object types} provided by the Qt QML module
(such as \l{QML::QtObject} and \l{QML::Component}) are also available when
@@ -286,14 +286,14 @@ Data Storage
/*!
\qmlmodule QtQuick 2
-\brief The QtQuick 2 module provides graphical primitives for use in QML.
+\brief The \c {QtQuick 2} module provides graphical primitives for use in QML.
-The QtQuick 2 module provides graphical primitive types. They can be used with the following import
+The \c {QtQuick 2} module provides graphical primitive types. They can be used with the following import
\code
import QtQuick 2.1
\endcode
-For a more detailed listing of types in the \c QtQuick 2 import, see the \l{Qt Quick QML Types} page.
+For a more detailed listing of types in the \c {QtQuick 2} import, see the \l{Qt Quick QML Types} page.
For more details about the module itself, see the \l{Qt Quick} module page.
*/
diff --git a/src/quick/doc/src/whatsnew.qdoc b/src/quick/doc/src/whatsnew.qdoc
index 7651fceaaa..c6f1196342 100644
--- a/src/quick/doc/src/whatsnew.qdoc
+++ b/src/quick/doc/src/whatsnew.qdoc
@@ -34,8 +34,8 @@
The QtQuick C++ module is new in Qt 5. It provides the visual canvas and scenegraph back-end
as well as the QtQuick QML module for QML application development.
-As of Qt 5, the QtQuick module is based on an OpenGL scenegraph. Many of the classes in
-the QtQuick module have been ported from the \c QtDeclarative module from Qt 4.8 to use
+As of Qt 5, the \l {Qt Quick} module is based on an OpenGL scenegraph. Many of the classes in
+the Qt Quick module have been ported from the \c QtDeclarative module from Qt 4.8 to use
the scenegraph architecture; these classes have been renamed to use a \c QQuick* prefix.
(See the \l {Porting QML Applications to Qt 5} for porting information.)
@@ -76,10 +76,10 @@ Custom rendering can be performed on the scenegraph using the following new clas
\section1 Qt 5.0 - QtQuick QML Module
-The QtQuick 2.0 QML module is a major update.
+The \c {QtQuick 2.0} QML module is a major update.
-Below are the additions in QtQuick 2.0. For a list of behavioral changes which may affect
-applications ported from QtQuick 1.x, see the \l {Porting QML Applications to Qt 5}.
+Below are the additions in \c {QtQuick 2.0}. For a list of behavioral changes which may affect
+applications ported from \c {QtQuick 1.x}, see the \l {Porting QML Applications to Qt 5}.
\section2 Visual types, Graphical Effects and Sprites
@@ -386,7 +386,7 @@ QtQuick also provides implementation for the various value type factory or utili
The \c Qt.rgba(), \c Qt.hsla(), \c Qt.tint(), \c Qt.lighter(), \c Qt.darker()
and \c Qt.fontFamilies() functions already existed in \c QtDeclarative prior
-to QtQuick 2.0; the other functions are all new in QtQuick 2.0.
+to \c {QtQuick 2.0}; the other functions are all new in \c {QtQuick 2.0}.
\section1 Qt 5.0 - Additional QML Modules
@@ -405,7 +405,7 @@ documentation for comprehensive details.
\section2 QtQuick.XmlListModel
-This new module contains XmlListModel and associated types, which were previously in the QtQuick
+This new module contains XmlListModel and associated types, which were previously in the \c QtQuick
module. See the \l{QtQuick.XmlListModel 2}{QtQuick.XmlListModel} documentation for details.
\section2 QtQuick.LocalStorage