summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorGeir Vattekar <geir.vattekar@digia.com>2012-10-04 13:48:23 +0200
committerThe Qt Project <gerrit-noreply@qt-project.org>2012-10-12 15:16:15 +0200
commit9d4d08421acb628e0115b140e54656fc779d13db (patch)
treeeb87c8fbbe0722f70fa536227fa7a311febdea81
parent8f624bb5d19edb47fc4803a5eb0d6343de5bbae9 (diff)
Doc: Modularized the Qt Sensor Docs
Change-Id: Ie8636ec443f43b1f238342e0f6f7d321e13dce09 Reviewed-by: Jerome Pasion <jerome.pasion@digia.com>
-rw-r--r--examples/sensors/accel/accel.pro9
-rw-r--r--examples/sensors/accel/main.cpp77
-rw-r--r--examples/sensors/accelbubble/doc/src/accelbubble.qdoc (renamed from doc/src/examples/accelbubble.qdoc)10
-rw-r--r--examples/sensors/cubehouse/doc/src/cubehouse.qdoc (renamed from doc/src/examples/cubehouse.qdoc)12
-rw-r--r--examples/sensors/grue/doc/src/grue.qdoc (renamed from doc/src/examples/grue.qdoc)14
-rw-r--r--examples/sensors/maze/doc/src/maze.qdoc (renamed from doc/src/examples/maze.qdoc)14
-rw-r--r--examples/sensors/qmlqtsensors/doc/src/qmlqtsensors.qdoc (renamed from doc/src/examples/qmlqtsensors.qdoc)16
-rw-r--r--examples/sensors/qmlsensorgestures/doc/src/qmlsensorgtestures.qdoc (renamed from doc/src/examples/qmlsensorgtestures.qdoc)12
-rw-r--r--examples/sensors/sensor_explorer/doc/src/sensor_explorer.qdoc (renamed from doc/src/examples/sensor_explorer.qdoc)16
-rw-r--r--examples/sensors/sensorgestures/doc/images/sensorgesturecpp.png (renamed from doc/src/images/sensorgesturecpp.png)bin33013 -> 33013 bytes
-rw-r--r--examples/sensors/sensorgestures/doc/src/sensorgestures.qdoc (renamed from doc/src/examples/sensorgestures.qdoc)8
-rw-r--r--examples/sensors/sensors.pro2
-rw-r--r--examples/sensors/shakeit/doc/images/shakeit.png (renamed from doc/src/images/shakeit.png)bin29380 -> 29380 bytes
-rw-r--r--examples/sensors/shakeit/doc/src/shakeit.qdoc (renamed from doc/src/examples/shakeit.qdoc)12
-rw-r--r--qtsensors.pro5
-rw-r--r--src/sensors/doc/images/XAngle.gif (renamed from doc/src/images/XAngle.gif)bin46224 -> 46224 bytes
-rw-r--r--src/sensors/doc/images/XAngleNegative.gif (renamed from doc/src/images/XAngleNegative.gif)bin38468 -> 38468 bytes
-rw-r--r--src/sensors/doc/images/YAngle.gif (renamed from doc/src/images/YAngle.gif)bin44322 -> 44322 bytes
-rw-r--r--src/sensors/doc/images/YAngleNegative.gif (renamed from doc/src/images/YAngleNegative.gif)bin39741 -> 39741 bytes
-rw-r--r--src/sensors/doc/images/cubehouse.png (renamed from doc/src/images/cubehouse.png)bin39408 -> 39408 bytes
-rw-r--r--src/sensors/doc/images/maze.png (renamed from doc/src/images/maze.png)bin215132 -> 215132 bytes
-rw-r--r--src/sensors/doc/images/qmlqtsensors.png (renamed from doc/src/images/qmlqtsensors.png)bin82345 -> 82345 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-cover.png (renamed from doc/src/images/sensorgesture-cover.png)bin23183 -> 23183 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-doubletap.png (renamed from doc/src/images/sensorgesture-doubletap.png)bin30073 -> 30073 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-facedown.png (renamed from doc/src/images/sensorgesture-facedown.png)bin17917 -> 17917 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-faceup.png (renamed from doc/src/images/sensorgesture-faceup.png)bin35115 -> 35115 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-flat.png (renamed from doc/src/images/sensorgesture-flat.png)bin21828 -> 21828 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-hover.png (renamed from doc/src/images/sensorgesture-hover.png)bin22512 -> 22512 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-shake.png (renamed from doc/src/images/sensorgesture-shake.png)bin34512 -> 34512 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-slam_1.png (renamed from doc/src/images/sensorgesture-slam_1.png)bin26212 -> 26212 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-slam_2.png (renamed from doc/src/images/sensorgesture-slam_2.png)bin29763 -> 29763 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-twist.png (renamed from doc/src/images/sensorgesture-twist.png)bin29643 -> 29643 bytes
-rw-r--r--src/sensors/doc/images/sensorgesture-whip.png (renamed from doc/src/images/sensorgesture-whip.png)bin32058 -> 32058 bytes
-rw-r--r--src/sensors/doc/images/sensors-coordinates.jpg (renamed from doc/src/images/sensors-coordinates.jpg)bin43508 -> 43508 bytes
-rw-r--r--src/sensors/doc/images/sensors-coordinates2.jpg (renamed from doc/src/images/sensors-coordinates2.jpg)bin58471 -> 58471 bytes
-rw-r--r--src/sensors/doc/images/sensors-coordinates3.jpg (renamed from doc/src/images/sensors-coordinates3.jpg)bin47920 -> 47920 bytes
-rw-r--r--src/sensors/doc/images/sensors-dynamic.png (renamed from doc/src/images/sensors-dynamic.png)bin34911 -> 34911 bytes
-rw-r--r--src/sensors/doc/images/sensors-geo-vs-raw-magnetism.jpg (renamed from doc/src/images/sensors-geo-vs-raw-magnetism.jpg)bin171856 -> 171856 bytes
-rw-r--r--src/sensors/doc/images/sensors-orientation.jpg (renamed from doc/src/images/sensors-orientation.jpg)bin39716 -> 39716 bytes
-rw-r--r--src/sensors/doc/images/sensors-overview.png (renamed from doc/src/images/sensors-overview.png)bin9670 -> 9670 bytes
-rw-r--r--src/sensors/doc/images/sensors-rotation-anim.gif (renamed from doc/src/images/sensors-rotation-anim.gif)bin296580 -> 296580 bytes
-rw-r--r--src/sensors/doc/images/sensors-rotation.jpg (renamed from doc/src/images/sensors-rotation.jpg)bin36653 -> 36653 bytes
-rw-r--r--src/sensors/doc/images/sensors-rotation2.jpg (renamed from doc/src/images/sensors-rotation2.jpg)bin39953 -> 39953 bytes
-rw-r--r--src/sensors/doc/images/sensors-rotation3.jpg (renamed from doc/src/images/sensors-rotation3.jpg)bin31417 -> 31417 bytes
-rw-r--r--src/sensors/doc/images/sensors-sides.jpg (renamed from doc/src/images/sensors-sides.jpg)bin48614 -> 48614 bytes
-rw-r--r--src/sensors/doc/images/sensors-sides2.jpg (renamed from doc/src/images/sensors-sides2.jpg)bin22706 -> 22706 bytes
-rw-r--r--src/sensors/doc/images/sensors-static.png (renamed from doc/src/images/sensors-static.png)bin23472 -> 23472 bytes
-rw-r--r--src/sensors/doc/qtsensors.qdocconf47
-rw-r--r--src/sensors/doc/snippets/sensorgestures/creating.cpp (renamed from doc/src/snippets/sensorgestures/creating.cpp)0
-rw-r--r--src/sensors/doc/snippets/sensorgestures/main.cpp (renamed from doc/src/snippets/sensorgestures/main.cpp)0
-rw-r--r--src/sensors/doc/snippets/sensorgestures/myplugin.h (renamed from doc/src/snippets/sensorgestures/myplugin.h)0
-rw-r--r--src/sensors/doc/snippets/sensorgestures/plugin.cpp (renamed from doc/src/snippets/sensorgestures/plugin.cpp)0
-rw-r--r--src/sensors/doc/snippets/sensorgestures/sensorgestures.pro (renamed from doc/src/snippets/sensorgestures/sensorgestures.pro)0
-rw-r--r--src/sensors/doc/snippets/sensors/creating.cpp (renamed from doc/src/snippets/sensors/creating.cpp)0
-rw-r--r--src/sensors/doc/snippets/sensors/main.cpp (renamed from doc/src/snippets/sensors/main.cpp)0
-rw-r--r--src/sensors/doc/snippets/sensors/mybackend.h (renamed from doc/src/snippets/sensors/mybackend.h)0
-rw-r--r--src/sensors/doc/snippets/sensors/plugin.cpp (renamed from doc/src/snippets/sensors/plugin.cpp)0
-rw-r--r--src/sensors/doc/snippets/sensors/sensors.pro (renamed from doc/src/snippets/sensors/sensors.pro)0
-rw-r--r--src/sensors/doc/snippets/sensors/start.cpp (renamed from doc/src/snippets/sensors/start.cpp)0
-rw-r--r--src/sensors/doc/snippets/snippets.pro (renamed from doc/src/snippets/snippets.pro)0
-rw-r--r--src/sensors/doc/src/compatmap.qdoc (renamed from doc/src/compatmap.qdoc)0
-rw-r--r--src/sensors/doc/src/genericbackend.qdoc (renamed from doc/src/genericbackend.qdoc)0
-rw-r--r--src/sensors/doc/src/porting.qdoc (renamed from doc/src/porting.qdoc)21
-rw-r--r--src/sensors/doc/src/qtmobilitysensors1.qdoc (renamed from doc/src/imports/qtsensors5.qdoc)17
-rw-r--r--src/sensors/doc/src/qtsensorgestures-cpp.qdoc (renamed from doc/src/qtsensorgestures-cpp.qdoc)10
-rw-r--r--src/sensors/doc/src/qtsensorgestures-emulator.qdoc (renamed from doc/src/qtsensorgestures-emulator.qdoc)0
-rw-r--r--src/sensors/doc/src/qtsensorgestures-plugins.qdoc (renamed from doc/src/qtsensorgestures-plugins.qdoc)2
-rw-r--r--src/sensors/doc/src/qtsensors-backend.qdoc (renamed from doc/src/qtsensors-backend.qdoc)2
-rw-r--r--src/sensors/doc/src/qtsensors-cpp.qdoc (renamed from doc/src/qtsensors-cpp.qdoc)6
-rw-r--r--src/sensors/doc/src/qtsensors.qdoc (renamed from doc/src/qtsensors.qdoc)16
-rw-r--r--src/sensors/doc/src/qtsensors5.qdoc78
-rw-r--r--src/sensors/doc/src/sensor-examples.qdoc (renamed from doc/src/examples/sensors.qdoc)0
-rw-r--r--src/sensors/gestures/qsensorgesturemanager.cpp2
-rw-r--r--src/sensors/qlightsensor.cpp2
-rw-r--r--src/sensors/qsensor.cpp3
-rw-r--r--src/sensors/qsensorbackend.cpp2
-rw-r--r--src/sensors/sensors.pro2
77 files changed, 235 insertions, 182 deletions
diff --git a/examples/sensors/accel/accel.pro b/examples/sensors/accel/accel.pro
deleted file mode 100644
index 82fa706b..00000000
--- a/examples/sensors/accel/accel.pro
+++ /dev/null
@@ -1,9 +0,0 @@
-TEMPLATE=app
-TARGET=accel
-
-QT=core sensors
-
-SOURCES=main.cpp
-
-target.path = $$[QT_INSTALL_EXAMPLES]/qtsensors/accel
-INSTALLS += target
diff --git a/examples/sensors/accel/main.cpp b/examples/sensors/accel/main.cpp
deleted file mode 100644
index 29855363..00000000
--- a/examples/sensors/accel/main.cpp
+++ /dev/null
@@ -1,77 +0,0 @@
-/****************************************************************************
-**
-** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
-** Contact: http://www.qt-project.org/legal
-**
-** This file is part of the QtSensors module of the Qt Toolkit.
-**
-** $QT_BEGIN_LICENSE:BSD$
-** You may use this file under the terms of the BSD license as follows:
-**
-** "Redistribution and use in source and binary forms, with or without
-** modification, are permitted provided that the following conditions are
-** met:
-** * Redistributions of source code must retain the above copyright
-** notice, this list of conditions and the following disclaimer.
-** * Redistributions in binary form must reproduce the above copyright
-** notice, this list of conditions and the following disclaimer in
-** the documentation and/or other materials provided with the
-** distribution.
-** * Neither the name of Digia Plc and its Subsidiary(-ies) nor the names
-** of its contributors may be used to endorse or promote products derived
-** from this software without specific prior written permission.
-**
-**
-** THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
-** "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
-** LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
-** A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
-** OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
-** SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
-** LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
-** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
-** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
-** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
-** OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE."
-**
-** $QT_END_LICENSE$
-**
-****************************************************************************/
-
-#include <QtCore>
-#include <qaccelerometer.h>
-
-QAccelerometer *accelerometer;
-
-class AccelerometerFilter : public QAccelerometerFilter
-{
-public:
- bool filter(QAccelerometerReading *reading)
- {
- qDebug() << "acceleration: "
- << QString().sprintf("%0.2f %0.2f %0.2f",
- reading->x(),
- reading->y(),
- reading->z());
- return false; // don't store the reading in the sensor
- }
-};
-
-int main(int argc, char **argv)
-{
- QCoreApplication app(argc, argv);
-
- QAccelerometer sensor;
- accelerometer = &sensor;
- AccelerometerFilter filter;
- sensor.addFilter(&filter);
- sensor.start();
-
- if (!sensor.isActive()) {
- qWarning("Accelerometer didn't start!");
- return 1;
- }
-
- return app.exec();
-}
-
diff --git a/doc/src/examples/accelbubble.qdoc b/examples/sensors/accelbubble/doc/src/accelbubble.qdoc
index 9199b17d..83c5d3dc 100644
--- a/doc/src/examples/accelbubble.qdoc
+++ b/examples/sensors/accelbubble/doc/src/accelbubble.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \example sensors/accelbubble
+ \example accelbubble
\title Qt Sensors - Accel Bubble
\brief The AccelBubble example demonstrates the Legacy Accelerometer QML type.
\ingroup qtsensors-examples
@@ -36,19 +36,19 @@
Import the Legacy Sensors Declarative module.
-\snippet ../examples/sensors/accelbubble/accelbubble.qml 0
+\snippet accelbubble/accelbubble.qml 0
Add an Accelerometer QML type.
-\snippet ../examples/sensors/accelbubble/accelbubble.qml 1
+\snippet accelbubble/accelbubble.qml 1
Use the 'active' property to start the sensor
-\snippet ../examples/sensors/accelbubble/accelbubble.qml 2
+\snippet accelbubble/accelbubble.qml 2
Move the bubble according to a factor of the accelerator sensor
-\snippet ../examples/sensors/accelbubble/accelbubble.qml 3
+\snippet accelbubble/accelbubble.qml 3
*/
diff --git a/doc/src/examples/cubehouse.qdoc b/examples/sensors/cubehouse/doc/src/cubehouse.qdoc
index 37d5fe28..e286e32e 100644
--- a/doc/src/examples/cubehouse.qdoc
+++ b/examples/sensors/cubehouse/doc/src/cubehouse.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \example sensors/cubehouse
+ \example cubehouse
\title Qt Sensors - Cube House QML Accelerometer example
\ingroup qtsensors-examples
\brief The Cube House example demonstrates the use of the accelerometer to drive a camera to create a pseudo-3D effect.
@@ -37,24 +37,24 @@
Import the QtSensors declarative plugin:
-\snippet ../examples/sensors/cubehouse/cubehouse.qml 0
+\snippet cubehouse/cubehouse.qml 0
Add the Accelerometer QML types into your qml file.
-\snippet ../examples/sensors/cubehouse/cubehouse.qml 1
+\snippet cubehouse/cubehouse.qml 1
In additional two properties are added to save the calculated pitch and roll values:
-\snippet ../examples/sensors/cubehouse/cubehouse.qml 2
+\snippet cubehouse/cubehouse.qml 2
Reading out the Accelerometer data can be done by implementing the 'onReadingChanged' slot and
accessing the 'reading' property from the Accelerometer type:
-\snippet ../examples/sensors/cubehouse/cubehouse.qml 3
+\snippet cubehouse/cubehouse.qml 3
By using a timer the view can be rotated using the pitch and roll properties from the Accelerometer type:
-\snippet ../examples/sensors/cubehouse/cubehouse.qml 4
+\snippet cubehouse/cubehouse.qml 4
*/
diff --git a/doc/src/examples/grue.qdoc b/examples/sensors/grue/doc/src/grue.qdoc
index 1eed941c..9a0d4472 100644
--- a/doc/src/examples/grue.qdoc
+++ b/examples/sensors/grue/doc/src/grue.qdoc
@@ -57,7 +57,7 @@
*/
/*!
- \example sensors/grue/lib
+ \example grue/lib
\title Grue Sensor Definition
\brief The Grue sensor is defined in a library so that applications can use it.
@@ -78,7 +78,7 @@
*/
/*!
- \example sensors/grue/plugin
+ \example grue/plugin
\title Grue Sensor Implementation
\brief The Grue sensor implementation lives in a plugin that is loaded by the Qt Sensors library.
@@ -94,13 +94,13 @@
light sensor. In the start method, the backend should be sure to call the
sensorStopped() or sensorBusy() methods if it cannot start.
- \snippet ../examples/sensors/grue/plugin/gruesensorimpl.cpp start
+ \snippet grue/plugin/gruesensorimpl.cpp start
The setReading method is needed so that the sensors library knows where the
readings are coming from. This backend has a local copy of the reading so
it passes a pointer to the function.
- \snippet ../examples/sensors/grue/plugin/gruesensorimpl.cpp setReading
+ \snippet grue/plugin/gruesensorimpl.cpp setReading
However it is also possible to pass null to the setReading method in which
case the sensors library will create an instance and return a pointer.
@@ -123,7 +123,7 @@
*/
/*!
- \example sensors/grue/console_app
+ \example grue/console_app
\title Grue Sensor Console Application
\brief The Grue sensor console application demonstrates use of the Grue sensor.
@@ -135,7 +135,7 @@
*/
/*!
- \example sensors/grue/import
+ \example grue/import
\title Grue Sensor QML Import
\brief The Grue sensor QML import exports the GrueSensor class as a QML type.
@@ -145,7 +145,7 @@
*/
/*!
- \example sensors/grue
+ \example grue
\title Grue Sensor QML Application
\brief The Grue sensor QML application demonstrates use of the GrueSensor QML type.
diff --git a/doc/src/examples/maze.qdoc b/examples/sensors/maze/doc/src/maze.qdoc
index e1807289..d9b50beb 100644
--- a/doc/src/examples/maze.qdoc
+++ b/examples/sensors/maze/doc/src/maze.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \example sensors/maze
+ \example maze
\title Qt Sensors - Maze QML Example
\ingroup qtsensors-examples
\image maze.png
@@ -39,29 +39,29 @@
Import the QtSensors 5.x declarative plugin:
- \snippet ../examples/sensors/maze/maze.qml 0
+ \snippet maze/maze.qml 0
Add the Sensor QML types into your qml file.
In this example we use the TiltSensor with values based in degrees and an accuracy of 5 degree:
- \snippet ../examples/sensors/maze/maze.qml 1
+ \snippet maze/maze.qml 1
Starting the sensor can be done by setting the 'enabled' property to true:
- \snippet ../examples/sensors/maze/maze.qml 2
+ \snippet maze/maze.qml 2
The mouse should move by a factor of the tilt value:
- \snippet ../examples/sensors/maze/maze.qml 3
+ \snippet maze/maze.qml 3
The walk direction of the mouse takes into account some collision detection:
- \snippet ../examples/sensors/maze/maze.qml 4
+ \snippet maze/maze.qml 4
The rotation of the mouse image is determined according to the angle that the mouse is moving.
- \snippet ../examples/sensors/maze/Mouse.qml 0
+ \snippet maze/Mouse.qml 0
*/
diff --git a/doc/src/examples/qmlqtsensors.qdoc b/examples/sensors/qmlqtsensors/doc/src/qmlqtsensors.qdoc
index ed6c99f4..f6b4738c 100644
--- a/doc/src/examples/qmlqtsensors.qdoc
+++ b/examples/sensors/qmlqtsensors/doc/src/qmlqtsensors.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \example sensors/qmlqtsensors
+ \example qmlqtsensors
\title Qt Sensors - QML example
\ingroup qtsensors-examples
\image qmlqtsensors.png
@@ -39,32 +39,32 @@
Import the QtSensors 5.x declarative plugin:
- \snippet ../examples/sensors/qmlqtsensors/qmlqtsensors.qml 0
+ \snippet qmlqtsensors/qmlqtsensors.qml 0
Add the Sensor QML types into your qml file.
In this example we use the TiltSensor:
- \snippet ../examples/sensors/qmlqtsensors/qmlqtsensors.qml 1
+ \snippet qmlqtsensors/qmlqtsensors.qml 1
The Tilt-, AmbientLight- and the Proximity QML sensor types have the 'enabled' property in common.
To start or stop the sensor set this property to true or false.
- \snippet ../examples/sensors/qmlqtsensors/qmlqtsensors.qml 2
+ \snippet qmlqtsensors/qmlqtsensors.qml 2
Reading the data can be done for each sensor type like following:
\l {QtSensors::TiltSensor} {TiltSensor}
- \snippet ../examples/sensors/qmlqtsensors/qmlqtsensors.qml 3
- \snippet ../examples/sensors/qmlqtsensors/qmlqtsensors.qml 4
+ \snippet qmlqtsensors/qmlqtsensors.qml 3
+ \snippet qmlqtsensors/qmlqtsensors.qml 4
\l {QtSensors::AmbientLightSensor} {AmbientLightSensor}
- \snippet ../examples/sensors/qmlqtsensors/qmlqtsensors.qml 5
+ \snippet qmlqtsensors/qmlqtsensors.qml 5
\l {QtSensors::ProximitySensor} {ProximitySensor}
- \snippet ../examples/sensors/qmlqtsensors/qmlqtsensors.qml 6
+ \snippet qmlqtsensors/qmlqtsensors.qml 6
*/
diff --git a/doc/src/examples/qmlsensorgtestures.qdoc b/examples/sensors/qmlsensorgestures/doc/src/qmlsensorgtestures.qdoc
index 74e65ae2..83f3171d 100644
--- a/doc/src/examples/qmlsensorgtestures.qdoc
+++ b/examples/sensors/qmlsensorgestures/doc/src/qmlsensorgtestures.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \example sensors/qmlsensorgestures
+ \example qmlsensorgestures
\title Qt Sensors - SensorGesture QML Type example
\ingroup qtsensors-examples
@@ -37,25 +37,25 @@
Import the QtSensors 5.x declarative plugin:
-\snippet ../examples/sensors/qmlsensorgestures/GestureView.qml 0
+\snippet qmlsensorgestures/GestureView.qml 0
Add the SensorGesture QML type into your qml file.
-\snippet ../examples/sensors/qmlsensorgestures/GestureView.qml 1
+\snippet qmlsensorgestures/GestureView.qml 1
Each SensorGesture QML type contains a property called gestures.
In this example an alias 'gestureid' for this property is used.
-\snippet ../examples/sensors/qmlsensorgestures/GestureView.qml 2
+\snippet qmlsensorgestures/GestureView.qml 2
By using this alias property you define which gestures should be used:
-\snippet ../examples/sensors/qmlsensorgestures/qmlsensorgestures.qml 3
+\snippet qmlsensorgestures/qmlsensorgestures.qml 3
A list of all available gestures can be created by calling the 'availableGestures' property:
-\snippet ../examples/sensors/qmlsensorgestures/GestureList.qml 4
+\snippet qmlsensorgestures/GestureList.qml 4
\sa {Qt Sensors - ShakeIt QML Example}
\sa {Qt Sensor Gestures}
diff --git a/doc/src/examples/sensor_explorer.qdoc b/examples/sensors/sensor_explorer/doc/src/sensor_explorer.qdoc
index 92879c2d..be042156 100644
--- a/doc/src/examples/sensor_explorer.qdoc
+++ b/examples/sensors/sensor_explorer/doc/src/sensor_explorer.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \example sensors/sensor_explorer
+ \example sensor_explorer
\title Qt Sensors - Explorer QML example
\ingroup qtsensors-examples
@@ -54,31 +54,31 @@
Import the Explorer 1.0 declarative plugin:
- \snippet ../examples/sensors/sensor_explorer/sensor_explorer.qml 0
+ \snippet sensor_explorer/sensor_explorer.qml 0
Create a SensorExplorer QML item:
- \snippet ../examples/sensors/sensor_explorer/sensor_explorer.qml 1
+ \snippet sensor_explorer/sensor_explorer.qml 1
You can retrieve a list of all available sensors using the SensorExplorer:
- \snippet ../examples/sensors/sensor_explorer/sensor_explorer.qml 2
+ \snippet sensor_explorer/sensor_explorer.qml 2
To retrieve the properties of a SensorItem use:
- \snippet ../examples/sensors/sensor_explorer/sensor_explorer.qml 3
+ \snippet sensor_explorer/sensor_explorer.qml 3
Changing a property value can be done like:
- \snippet ../examples/sensors/sensor_explorer/sensor_explorer.qml 4
+ \snippet sensor_explorer/sensor_explorer.qml 4
Starting and stopping a sensor can be done like:
- \snippet ../examples/sensors/sensor_explorer/sensor_explorer.qml 5
+ \snippet sensor_explorer/sensor_explorer.qml 5
*/
/*!
- \example sensors/sensor_explorer/import
+ \example sensor_explorer/import
\title Sensor Explorer QML Import
\section2 Sensor Explorer Declarative Plugin
diff --git a/doc/src/images/sensorgesturecpp.png b/examples/sensors/sensorgestures/doc/images/sensorgesturecpp.png
index 4d453cf2..4d453cf2 100644
--- a/doc/src/images/sensorgesturecpp.png
+++ b/examples/sensors/sensorgestures/doc/images/sensorgesturecpp.png
Binary files differ
diff --git a/doc/src/examples/sensorgestures.qdoc b/examples/sensors/sensorgestures/doc/src/sensorgestures.qdoc
index d34f383d..a5c96cb5 100644
--- a/doc/src/examples/sensorgestures.qdoc
+++ b/examples/sensors/sensorgestures/doc/src/sensorgestures.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \page sensorgestureexample.html
+ \example sensorgestures
\title Qt Sensors - C++ Sensor Gestures Example
\ingroup qtsensors-examples
\brief The sensor gesture example demonstrates the steps for creating a C++ application
@@ -45,17 +45,17 @@
In order to know about custom signals that may be available, we need to ask the QSensorGestureManager about them,
Using the QSensorGesture::gestureIds() function, the manager will return a QStringList of known and valid gesture Ids.
- \snippet ../examples/sensors/sensorgestures/mainwindow.cpp 0
+ \snippet sensorgestures/mainwindow.cpp 0
We can then use this to create a QSensorGesture object that we can use to connect signals to,
and start the detection process. A QSensorGesture object will take a list of one or more
recognizer ids in it's constructor.
- \snippet ../examples/sensors/sensorgestures/mainwindow.cpp 1
+ \snippet sensorgestures/mainwindow.cpp 1
and later stop the detection process.
- \snippet ../examples/sensors/sensorgestures/mainwindow.cpp 2
+ \snippet sensorgestures/mainwindow.cpp 2
The QSensorGesture object will contain all the signals of the valid requested recognizers found on the system.
diff --git a/examples/sensors/sensors.pro b/examples/sensors/sensors.pro
index 7fe9a092..f98b4c15 100644
--- a/examples/sensors/sensors.pro
+++ b/examples/sensors/sensors.pro
@@ -1,6 +1,6 @@
TEMPLATE = subdirs
-SUBDIRS += accel grue
+SUBDIRS += grue
!isEmpty(QT.quick.name) {
SUBDIRS += \
diff --git a/doc/src/images/shakeit.png b/examples/sensors/shakeit/doc/images/shakeit.png
index 5ca1b58c..5ca1b58c 100644
--- a/doc/src/images/shakeit.png
+++ b/examples/sensors/shakeit/doc/images/shakeit.png
Binary files differ
diff --git a/doc/src/examples/shakeit.qdoc b/examples/sensors/shakeit/doc/src/shakeit.qdoc
index 1dc300fd..8f5931fd 100644
--- a/doc/src/examples/shakeit.qdoc
+++ b/examples/sensors/shakeit/doc/src/shakeit.qdoc
@@ -26,7 +26,7 @@
****************************************************************************/
/*!
- \example sensors/shakeit
+ \example shakeit
\title Qt Sensors - ShakeIt QML Example
\ingroup qtsensors-examples
\image shakeit.png
@@ -39,25 +39,25 @@
Import the Sensors Declarative module.
- \snippet ../examples/sensors/shakeit/shakeit.qml 0
+ \snippet shakeit/shakeit.qml 0
Add a SensorGesture QML type.
- \snippet ../examples/sensors/shakeit/shakeit.qml 1
+ \snippet shakeit/shakeit.qml 1
In the SensorGesture type, specify which gesture to be used.
Note that this can be a comma separated list. Here we are only interested in one
gesture recognizer.
- \snippet ../examples/sensors/shakeit/shakeit.qml 2
+ \snippet shakeit/shakeit.qml 2
Use the 'enabled' property to start the sensor gesture.
- \snippet ../examples/sensors/shakeit/shakeit.qml 3
+ \snippet shakeit/shakeit.qml 3
Use the onDetected signal to do stuff.
- \snippet ../examples/sensors/shakeit/shakeit.qml 4
+ \snippet shakeit/shakeit.qml 4
There are additional gestures to shake which are supported:
whip, twistRight, hover, cover, turnover and pickup.
diff --git a/qtsensors.pro b/qtsensors.pro
index e76adecd..83d9ebd1 100644
--- a/qtsensors.pro
+++ b/qtsensors.pro
@@ -6,11 +6,6 @@ blackberry {
load(qt_parts)
-SUBDIRS += module_qtsensors_snippets
-module_qtsensors_snippets.subdir = doc/src/snippets
-module_qtsensors_snippets.target = sub-snippets
-module_qtsensors_snippets.depends = sub_src
-
# Commands to rebuild the plugin.qmltypes files for our imports
# Run "make rebuild_qmltypes" after completing a build
sensors_qmltypes.commands = qmlplugindump QtSensors 5.0 $$QT.sensors.imports > $$PWD/src/imports/sensors/plugins.qmltypes
diff --git a/doc/src/images/XAngle.gif b/src/sensors/doc/images/XAngle.gif
index 045f235f..045f235f 100644
--- a/doc/src/images/XAngle.gif
+++ b/src/sensors/doc/images/XAngle.gif
Binary files differ
diff --git a/doc/src/images/XAngleNegative.gif b/src/sensors/doc/images/XAngleNegative.gif
index 92fc9233..92fc9233 100644
--- a/doc/src/images/XAngleNegative.gif
+++ b/src/sensors/doc/images/XAngleNegative.gif
Binary files differ
diff --git a/doc/src/images/YAngle.gif b/src/sensors/doc/images/YAngle.gif
index 004fdd15..004fdd15 100644
--- a/doc/src/images/YAngle.gif
+++ b/src/sensors/doc/images/YAngle.gif
Binary files differ
diff --git a/doc/src/images/YAngleNegative.gif b/src/sensors/doc/images/YAngleNegative.gif
index 1dce6532..1dce6532 100644
--- a/doc/src/images/YAngleNegative.gif
+++ b/src/sensors/doc/images/YAngleNegative.gif
Binary files differ
diff --git a/doc/src/images/cubehouse.png b/src/sensors/doc/images/cubehouse.png
index e3ff7fa5..e3ff7fa5 100644
--- a/doc/src/images/cubehouse.png
+++ b/src/sensors/doc/images/cubehouse.png
Binary files differ
diff --git a/doc/src/images/maze.png b/src/sensors/doc/images/maze.png
index f3ad8de4..f3ad8de4 100644
--- a/doc/src/images/maze.png
+++ b/src/sensors/doc/images/maze.png
Binary files differ
diff --git a/doc/src/images/qmlqtsensors.png b/src/sensors/doc/images/qmlqtsensors.png
index 0a54b653..0a54b653 100644
--- a/doc/src/images/qmlqtsensors.png
+++ b/src/sensors/doc/images/qmlqtsensors.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-cover.png b/src/sensors/doc/images/sensorgesture-cover.png
index 7b4fbc5f..7b4fbc5f 100644
--- a/doc/src/images/sensorgesture-cover.png
+++ b/src/sensors/doc/images/sensorgesture-cover.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-doubletap.png b/src/sensors/doc/images/sensorgesture-doubletap.png
index 6253d0f8..6253d0f8 100644
--- a/doc/src/images/sensorgesture-doubletap.png
+++ b/src/sensors/doc/images/sensorgesture-doubletap.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-facedown.png b/src/sensors/doc/images/sensorgesture-facedown.png
index a85664f1..a85664f1 100644
--- a/doc/src/images/sensorgesture-facedown.png
+++ b/src/sensors/doc/images/sensorgesture-facedown.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-faceup.png b/src/sensors/doc/images/sensorgesture-faceup.png
index c20ef089..c20ef089 100644
--- a/doc/src/images/sensorgesture-faceup.png
+++ b/src/sensors/doc/images/sensorgesture-faceup.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-flat.png b/src/sensors/doc/images/sensorgesture-flat.png
index e8eafafb..e8eafafb 100644
--- a/doc/src/images/sensorgesture-flat.png
+++ b/src/sensors/doc/images/sensorgesture-flat.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-hover.png b/src/sensors/doc/images/sensorgesture-hover.png
index fecf6b3a..fecf6b3a 100644
--- a/doc/src/images/sensorgesture-hover.png
+++ b/src/sensors/doc/images/sensorgesture-hover.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-shake.png b/src/sensors/doc/images/sensorgesture-shake.png
index 06f9eeaf..06f9eeaf 100644
--- a/doc/src/images/sensorgesture-shake.png
+++ b/src/sensors/doc/images/sensorgesture-shake.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-slam_1.png b/src/sensors/doc/images/sensorgesture-slam_1.png
index d56f8892..d56f8892 100644
--- a/doc/src/images/sensorgesture-slam_1.png
+++ b/src/sensors/doc/images/sensorgesture-slam_1.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-slam_2.png b/src/sensors/doc/images/sensorgesture-slam_2.png
index 5fe8ecba..5fe8ecba 100644
--- a/doc/src/images/sensorgesture-slam_2.png
+++ b/src/sensors/doc/images/sensorgesture-slam_2.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-twist.png b/src/sensors/doc/images/sensorgesture-twist.png
index bec15854..bec15854 100644
--- a/doc/src/images/sensorgesture-twist.png
+++ b/src/sensors/doc/images/sensorgesture-twist.png
Binary files differ
diff --git a/doc/src/images/sensorgesture-whip.png b/src/sensors/doc/images/sensorgesture-whip.png
index aa998bb7..aa998bb7 100644
--- a/doc/src/images/sensorgesture-whip.png
+++ b/src/sensors/doc/images/sensorgesture-whip.png
Binary files differ
diff --git a/doc/src/images/sensors-coordinates.jpg b/src/sensors/doc/images/sensors-coordinates.jpg
index e2e98908..e2e98908 100644
--- a/doc/src/images/sensors-coordinates.jpg
+++ b/src/sensors/doc/images/sensors-coordinates.jpg
Binary files differ
diff --git a/doc/src/images/sensors-coordinates2.jpg b/src/sensors/doc/images/sensors-coordinates2.jpg
index 8dd43a21..8dd43a21 100644
--- a/doc/src/images/sensors-coordinates2.jpg
+++ b/src/sensors/doc/images/sensors-coordinates2.jpg
Binary files differ
diff --git a/doc/src/images/sensors-coordinates3.jpg b/src/sensors/doc/images/sensors-coordinates3.jpg
index 02634000..02634000 100644
--- a/doc/src/images/sensors-coordinates3.jpg
+++ b/src/sensors/doc/images/sensors-coordinates3.jpg
Binary files differ
diff --git a/doc/src/images/sensors-dynamic.png b/src/sensors/doc/images/sensors-dynamic.png
index d2ba937d..d2ba937d 100644
--- a/doc/src/images/sensors-dynamic.png
+++ b/src/sensors/doc/images/sensors-dynamic.png
Binary files differ
diff --git a/doc/src/images/sensors-geo-vs-raw-magnetism.jpg b/src/sensors/doc/images/sensors-geo-vs-raw-magnetism.jpg
index 272fa310..272fa310 100644
--- a/doc/src/images/sensors-geo-vs-raw-magnetism.jpg
+++ b/src/sensors/doc/images/sensors-geo-vs-raw-magnetism.jpg
Binary files differ
diff --git a/doc/src/images/sensors-orientation.jpg b/src/sensors/doc/images/sensors-orientation.jpg
index 245533d5..245533d5 100644
--- a/doc/src/images/sensors-orientation.jpg
+++ b/src/sensors/doc/images/sensors-orientation.jpg
Binary files differ
diff --git a/doc/src/images/sensors-overview.png b/src/sensors/doc/images/sensors-overview.png
index 29e9ebd4..29e9ebd4 100644
--- a/doc/src/images/sensors-overview.png
+++ b/src/sensors/doc/images/sensors-overview.png
Binary files differ
diff --git a/doc/src/images/sensors-rotation-anim.gif b/src/sensors/doc/images/sensors-rotation-anim.gif
index 22c678d5..22c678d5 100644
--- a/doc/src/images/sensors-rotation-anim.gif
+++ b/src/sensors/doc/images/sensors-rotation-anim.gif
Binary files differ
diff --git a/doc/src/images/sensors-rotation.jpg b/src/sensors/doc/images/sensors-rotation.jpg
index 1bd1b14b..1bd1b14b 100644
--- a/doc/src/images/sensors-rotation.jpg
+++ b/src/sensors/doc/images/sensors-rotation.jpg
Binary files differ
diff --git a/doc/src/images/sensors-rotation2.jpg b/src/sensors/doc/images/sensors-rotation2.jpg
index 1bf34fee..1bf34fee 100644
--- a/doc/src/images/sensors-rotation2.jpg
+++ b/src/sensors/doc/images/sensors-rotation2.jpg
Binary files differ
diff --git a/doc/src/images/sensors-rotation3.jpg b/src/sensors/doc/images/sensors-rotation3.jpg
index d69a3e19..d69a3e19 100644
--- a/doc/src/images/sensors-rotation3.jpg
+++ b/src/sensors/doc/images/sensors-rotation3.jpg
Binary files differ
diff --git a/doc/src/images/sensors-sides.jpg b/src/sensors/doc/images/sensors-sides.jpg
index 8e842242..8e842242 100644
--- a/doc/src/images/sensors-sides.jpg
+++ b/src/sensors/doc/images/sensors-sides.jpg
Binary files differ
diff --git a/doc/src/images/sensors-sides2.jpg b/src/sensors/doc/images/sensors-sides2.jpg
index db66a9b5..db66a9b5 100644
--- a/doc/src/images/sensors-sides2.jpg
+++ b/src/sensors/doc/images/sensors-sides2.jpg
Binary files differ
diff --git a/doc/src/images/sensors-static.png b/src/sensors/doc/images/sensors-static.png
index 657aaad2..657aaad2 100644
--- a/doc/src/images/sensors-static.png
+++ b/src/sensors/doc/images/sensors-static.png
Binary files differ
diff --git a/src/sensors/doc/qtsensors.qdocconf b/src/sensors/doc/qtsensors.qdocconf
new file mode 100644
index 00000000..c2d27bca
--- /dev/null
+++ b/src/sensors/doc/qtsensors.qdocconf
@@ -0,0 +1,47 @@
+include($QT_INSTALL_DOCS/global/qt-html-templates-offline.qdocconf)
+include($QT_INSTALL_DOCS/global/qt-module-defaults.qdocconf)
+
+project = QtSensors
+description = Qt Contacts Reference Documentation
+url = http://qt-project.org/doc/qt-5.0/qtsensors-index.html
+version = 5.0.0
+
+qhp.projects = QtSensors
+
+qhp.QtSensors.file = qtsensors.qhp
+qhp.QtSensors.namespace = org.qt-project.qtsensors.500
+qhp.QtSensors.virtualFolder = qdoc
+qhp.QtSensors.indexTitle = Qt Sensors Reference Documentation
+qhp.QtSensors.indexRoot =
+
+qhp.QtSensors.filterAttributes = qtsensors 5.0.0 qtrefdoc
+qhp.QtSensors.customFilters.Qt.name = QtSensors 5.0.0
+qhp.QtSensors.customFilters.Qt.filterAttributes = qtsensors 5.0.0
+qhp.QtSensors.subprojects = classes overviews examples
+qhp.QtSensors.subprojects.classes.title = Classes
+qhp.QtSensors.subprojects.classes.indexTitle = Qt Sensors's Classes
+qhp.QtSensors.subprojects.classes.selectors = class fake:headerfile
+qhp.QtSensors.subprojects.classes.sortPages = true
+qhp.QtSensors.subprojects.overviews.title = Overviews
+qhp.QtSensors.subprojects.overviews.indexTitle = All Overviews and HOWTOs
+qhp.QtSensors.subprojects.overviews.selectors = fake:page,group,module
+qhp.QtSensors.subprojects.examples.title = Qt Sensors Examples
+qhp.QtSensors.subprojects.examples.indexTitle = Qt Sensors Examples
+qhp.QtSensors.subprojects.examples.selectors = fake:example
+
+outputdir = ../../../doc/qtsensors
+tagfile = ../../../doc/qtsensors/qtsensors.tags
+
+headerdirs += .. \
+ ../../imports/sensors2 \
+ ../../plugins/sensors
+
+sourcedirs += .. \
+ ../../imports/sensors2 \
+ ../../plugins/sensors
+
+exampledirs += ../../../examples/sensors \
+ snippets/
+
+
+imagedirs += images
diff --git a/doc/src/snippets/sensorgestures/creating.cpp b/src/sensors/doc/snippets/sensorgestures/creating.cpp
index 214f2d45..214f2d45 100644
--- a/doc/src/snippets/sensorgestures/creating.cpp
+++ b/src/sensors/doc/snippets/sensorgestures/creating.cpp
diff --git a/doc/src/snippets/sensorgestures/main.cpp b/src/sensors/doc/snippets/sensorgestures/main.cpp
index 08db48c6..08db48c6 100644
--- a/doc/src/snippets/sensorgestures/main.cpp
+++ b/src/sensors/doc/snippets/sensorgestures/main.cpp
diff --git a/doc/src/snippets/sensorgestures/myplugin.h b/src/sensors/doc/snippets/sensorgestures/myplugin.h
index d75f3cef..d75f3cef 100644
--- a/doc/src/snippets/sensorgestures/myplugin.h
+++ b/src/sensors/doc/snippets/sensorgestures/myplugin.h
diff --git a/doc/src/snippets/sensorgestures/plugin.cpp b/src/sensors/doc/snippets/sensorgestures/plugin.cpp
index 77982904..77982904 100644
--- a/doc/src/snippets/sensorgestures/plugin.cpp
+++ b/src/sensors/doc/snippets/sensorgestures/plugin.cpp
diff --git a/doc/src/snippets/sensorgestures/sensorgestures.pro b/src/sensors/doc/snippets/sensorgestures/sensorgestures.pro
index 46d68250..46d68250 100644
--- a/doc/src/snippets/sensorgestures/sensorgestures.pro
+++ b/src/sensors/doc/snippets/sensorgestures/sensorgestures.pro
diff --git a/doc/src/snippets/sensors/creating.cpp b/src/sensors/doc/snippets/sensors/creating.cpp
index 01e3e369..01e3e369 100644
--- a/doc/src/snippets/sensors/creating.cpp
+++ b/src/sensors/doc/snippets/sensors/creating.cpp
diff --git a/doc/src/snippets/sensors/main.cpp b/src/sensors/doc/snippets/sensors/main.cpp
index 08db48c6..08db48c6 100644
--- a/doc/src/snippets/sensors/main.cpp
+++ b/src/sensors/doc/snippets/sensors/main.cpp
diff --git a/doc/src/snippets/sensors/mybackend.h b/src/sensors/doc/snippets/sensors/mybackend.h
index 49d9d3c4..49d9d3c4 100644
--- a/doc/src/snippets/sensors/mybackend.h
+++ b/src/sensors/doc/snippets/sensors/mybackend.h
diff --git a/doc/src/snippets/sensors/plugin.cpp b/src/sensors/doc/snippets/sensors/plugin.cpp
index e467128f..e467128f 100644
--- a/doc/src/snippets/sensors/plugin.cpp
+++ b/src/sensors/doc/snippets/sensors/plugin.cpp
diff --git a/doc/src/snippets/sensors/sensors.pro b/src/sensors/doc/snippets/sensors/sensors.pro
index 20b5ae51..20b5ae51 100644
--- a/doc/src/snippets/sensors/sensors.pro
+++ b/src/sensors/doc/snippets/sensors/sensors.pro
diff --git a/doc/src/snippets/sensors/start.cpp b/src/sensors/doc/snippets/sensors/start.cpp
index d8cbd993..d8cbd993 100644
--- a/doc/src/snippets/sensors/start.cpp
+++ b/src/sensors/doc/snippets/sensors/start.cpp
diff --git a/doc/src/snippets/snippets.pro b/src/sensors/doc/snippets/snippets.pro
index f73d4a35..f73d4a35 100644
--- a/doc/src/snippets/snippets.pro
+++ b/src/sensors/doc/snippets/snippets.pro
diff --git a/doc/src/compatmap.qdoc b/src/sensors/doc/src/compatmap.qdoc
index 0fd4951c..0fd4951c 100644
--- a/doc/src/compatmap.qdoc
+++ b/src/sensors/doc/src/compatmap.qdoc
diff --git a/doc/src/genericbackend.qdoc b/src/sensors/doc/src/genericbackend.qdoc
index 689b4124..689b4124 100644
--- a/doc/src/genericbackend.qdoc
+++ b/src/sensors/doc/src/genericbackend.qdoc
diff --git a/doc/src/porting.qdoc b/src/sensors/doc/src/porting.qdoc
index 24e0d7e6..b52da351 100644
--- a/doc/src/porting.qdoc
+++ b/src/sensors/doc/src/porting.qdoc
@@ -39,12 +39,21 @@
\section1 QML
- QtSensors ships with a QML import that is compatible with the QtMobility.sensors import.
- The limitations of the QtMobility.sensors import have been fixed and some new properties
- may exist so apps may need to be updated if they are using custom properties on their
- sensor objects.
-
- See \l {Qt Sensors QML API} for more information.
+ Compatibility for QML applications is provided by shipping the legacy \c QtMobility.sensors
+ QML import. QML applications should not require any changes to continue operating.
+
+ Applications using the legacy QML import may not be able to trivially port over
+ to the new QML import because the new QML import does not provide types for
+ every sensor like the legacy QML import does.
+
+ \table
+ \row
+ \li \l {Qt Sensors QML Types}{QML API}
+ \li Information about the Qt Sensors QML API
+ \row
+ \li \l {QtMobility.sensors 1.x}{Legacy QML API}
+ \li Information about the legacy QtMobility.sensors QML API
+ \endtable
\section1 C++
diff --git a/doc/src/imports/qtsensors5.qdoc b/src/sensors/doc/src/qtmobilitysensors1.qdoc
index 02b53603..f9ba814f 100644
--- a/doc/src/imports/qtsensors5.qdoc
+++ b/src/sensors/doc/src/qtmobilitysensors1.qdoc
@@ -26,20 +26,25 @@
****************************************************************************/
/*!
- \qmlmodule QtSensors 5.0
- \title Qt Sensors QML API
- \brief QML import for QtSensors
+ \qmlmodule QtMobility.sensors 1.3
+ \title QtMobility.sensors 1.x
+ \brief Legacy QML import for QtSensors
\section1 Overview
- This is the QtSensors QML import.
+ This is the legacy QML import. It exists for compatibility with the QtMobiltiy 1.2 release
+ and is not recommended for new applications.
+
+ See \l{Qt Sensors} for more information about the Sensors API.
\section1 QML Module API
+ See \l {Qt Sensors} for more information about the Sensors API.
+
If the module is imported into a namespace, some additional methods become available.
\code
- import QtSensors 5.0 as Sensors
+ import QtMobility.sensors 1.3 as Sensors
...
Component.onCompleted: {
var types = Sensors.sensorTypes();
@@ -53,7 +58,7 @@
These types represent specific types of sensors.
- Note that most properties come from the abstract \l{QtSensors::Sensor}{Sensor} element.
+ Note that most properties come from the abstract \l{QtMobility.sensors1::Sensor}{Sensor} element.
\annotatedlist qml-sensors_type
diff --git a/doc/src/qtsensorgestures-cpp.qdoc b/src/sensors/doc/src/qtsensorgestures-cpp.qdoc
index 179fc700..e78ce4d6 100644
--- a/doc/src/qtsensorgestures-cpp.qdoc
+++ b/src/sensors/doc/src/qtsensorgestures-cpp.qdoc
@@ -27,17 +27,14 @@
/*!
\page qtsensorgestures-cpp.html
-\title QtSensorGestures C++ API
+\title Sensor Gestures C++ Overview
\brief Information about the QtSensorGestures C++ API
\tableofcontents
-\section1
-
-
\section1 Using QtSensorGestures
-With QtSensorGestures, you are able to easily utilize device gesturing using
+With the Sensor Gestures classes, you are able to easily utilize device gesturing using
sensors such as the accelerometer and proximity.
A list of currently supported sensor gestures and their descriptions can be found here:
@@ -48,7 +45,7 @@ Using QtSensorGestures is easy. There are two main classes you will need to use.
QSensorGestureManager can be used for determining what sensor gestures are available, and
QSensorGesture for connecting the sensor gesture signals.
-\snippet snippets/sensorgestures/creating.cpp Receiving sensor gesture signals
+\snippet sensorgestures/creating.cpp Receiving sensor gesture signals
More information about the sensor gesture recognizers can be found in
\l{QtSensorGestures Plugins}.
@@ -59,6 +56,5 @@ The primary classes that make up the QtSensorGestures API.
\annotatedlist sensorgestures_main
-
*/
diff --git a/doc/src/qtsensorgestures-emulator.qdoc b/src/sensors/doc/src/qtsensorgestures-emulator.qdoc
index af061e2a..af061e2a 100644
--- a/doc/src/qtsensorgestures-emulator.qdoc
+++ b/src/sensors/doc/src/qtsensorgestures-emulator.qdoc
diff --git a/doc/src/qtsensorgestures-plugins.qdoc b/src/sensors/doc/src/qtsensorgestures-plugins.qdoc
index a9996ca0..67734aad 100644
--- a/doc/src/qtsensorgestures-plugins.qdoc
+++ b/src/sensors/doc/src/qtsensorgestures-plugins.qdoc
@@ -57,7 +57,7 @@ This is the class in which the gesture recognizer system should be implemented f
\endlist
-\snippet snippets/sensorgestures/plugin.cpp Plugin
+\snippet sensorgestures/plugin.cpp Plugin
\section2 Recognizer Classes
diff --git a/doc/src/qtsensors-backend.qdoc b/src/sensors/doc/src/qtsensors-backend.qdoc
index d3c6e755..e26c05ad 100644
--- a/doc/src/qtsensors-backend.qdoc
+++ b/src/sensors/doc/src/qtsensors-backend.qdoc
@@ -76,7 +76,7 @@ that multiple sensor backends cannot be in a plugin.
An example follows.
-\snippet snippets/sensors/plugin.cpp Plugin
+\snippet sensors/plugin.cpp Plugin
*/
diff --git a/doc/src/qtsensors-cpp.qdoc b/src/sensors/doc/src/qtsensors-cpp.qdoc
index 49bb8a5a..2f60592a 100644
--- a/doc/src/qtsensors-cpp.qdoc
+++ b/src/sensors/doc/src/qtsensors-cpp.qdoc
@@ -27,7 +27,7 @@
/*!
\page qtsensors-cpp.html
-\title Qt Sensors C++ API
+\title Qt Sensors C++ Overview
\brief Information about the Qt Sensors C++ API
\tableofcontents
@@ -77,7 +77,7 @@ The life cycle of a QSensor is typically:
Here is an example of creating a sensor on the heap and on the stack.
-\snippet snippets/sensors/creating.cpp Creating a sensor
+\snippet sensors/creating.cpp Creating a sensor
\section1 Accessing sensor data in a generic fashion
@@ -99,7 +99,7 @@ For example, here is an example of how you can access a property of the accelero
This code does not require any compile-time links to \l QAccelerometer or
\l QAccelerometerReading.
-\snippet snippets/sensors/start.cpp Starting a sensor
+\snippet sensors/start.cpp Starting a sensor
You can discover all of this information at runtime too. The sensor_explorer example
shows you information about available sensors.
diff --git a/doc/src/qtsensors.qdoc b/src/sensors/doc/src/qtsensors.qdoc
index b437da28..61286733 100644
--- a/doc/src/qtsensors.qdoc
+++ b/src/sensors/doc/src/qtsensors.qdoc
@@ -26,12 +26,13 @@
****************************************************************************/
/*!
- \page index-qtsensors.html
+ \page qtsensors-index.html
\title Qt Sensors
\brief The Qt Sensors API provides access to sensors via QML and C++ interfaces.
\ingroup technology-apis
The Qt Sensors API provides access to sensor hardware via QML and C++ interfaces.
+ The Qt Sensors API also provides motion gesture recognition API for devices.
\section1 Information for Application Writers
@@ -39,12 +40,18 @@
\table
\row
- \li \l {Qt Sensors QML API}{QML API}
+ \li \l {Qt Sensors QML Types}{QML Types}
\li Information about the Qt Sensors QML API
\row
- \li \l {Qt Sensors C++ API}{C++ API}
+ \li \l {Qt Sensors C++ Classes}{C++ Classes}
\li Information about the Qt Sensors C++ API
\row
+ \li \l{Qt Sensors C++ Overview}
+ \li High-level information on how to use the C++ API.
+ \row
+ \li \l {Sensor Gestures C++ Overview}
+ \li High-level information specific to sensor gestures.
+ \row
\li \l {Qt Sensors Examples}{Examples}
\li Examples demonstrating use of the Qt Sensors APIs
\endtable
@@ -71,7 +78,7 @@
\li Information about the steps needed to port applications to the Qt Sensors API.
\endtable
-
+ \omit
\section1 Information for Qt SensorGestures API
Qt SensorGestures provides a motion gesture recognition API for devices.
@@ -95,6 +102,7 @@
\li \l {QtSensorGestures Emulator}{Emulator}
\li Information about Qt SensorGestures use in the Emulator.
\endtable
+ \endomit
\section1 Platform-specific Information
\table
diff --git a/src/sensors/doc/src/qtsensors5.qdoc b/src/sensors/doc/src/qtsensors5.qdoc
new file mode 100644
index 00000000..71b62dae
--- /dev/null
+++ b/src/sensors/doc/src/qtsensors5.qdoc
@@ -0,0 +1,78 @@
+/****************************************************************************
+**
+** Copyright (C) 2012 Digia Plc and/or its subsidiary(-ies).
+** Contact: http://www.qt-project.org/legal
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:FDL$
+** Commercial License Usage
+** Licensees holding valid commercial Qt licenses may use this file in
+** accordance with the commercial license agreement provided with the
+** Software or, alternatively, in accordance with the terms contained in
+** a written agreement between you and Digia. For licensing terms and
+** conditions see http://qt.digia.com/licensing. For further information
+** use the contact form at http://qt.digia.com/contact-us.
+**
+** GNU Free Documentation License Usage
+** 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. Please review the following information to ensure
+** the GNU Free Documentation License version 1.3 requirements
+** will be met: http://www.gnu.org/copyleft/fdl.html.
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+
+/*!
+ \module QtSensors
+ \title Qt Sensors C++ Classes
+ \ingroup modules
+
+ \brief The QtSensors module provides classes for reading sensor data.
+
+ Mobile devices contains sensor hardware that allow detecting changes in various physical
+ properties of the device itself or its immediate environment. Examples of device properties
+ include the angle at which the device is held, whereas environmental properties include for
+ example the current level of ambient light.
+*/
+
+/*!
+ \qmlmodule QtSensors 5
+ \title Qt Sensors QML Types
+ \ingroup qmlmodules
+
+ \brief The QtSensors QML module provides types for reading sensor data.
+
+ \section1 QML Module API
+
+ If the module is imported into a namespace, some additional methods become available.
+
+ \code
+ import QtSensors 5.0 as Sensors
+ ...
+ Component.onCompleted: {
+ var types = Sensors.sensorTypes();
+ console.log(types.join(", "));
+ }
+ \endcode
+
+ The documentation for the module API can be found in SensorGlobal.
+
+ \section1 QML Sensor types
+
+ These types represent specific types of sensors.
+
+ Note that most properties come from the abstract \l{QtSensors::Sensor}{Sensor} element.
+
+ \annotatedlist qml-sensors_type
+
+ \section1 QML Reading types
+
+ The data from a sensor comes through a reading class.
+
+ \annotatedlist qml-sensors_reading
+*/
+
diff --git a/doc/src/examples/sensors.qdoc b/src/sensors/doc/src/sensor-examples.qdoc
index d934c8a0..d934c8a0 100644
--- a/doc/src/examples/sensors.qdoc
+++ b/src/sensors/doc/src/sensor-examples.qdoc
diff --git a/src/sensors/gestures/qsensorgesturemanager.cpp b/src/sensors/gestures/qsensorgesturemanager.cpp
index 897e72f0..969347a2 100644
--- a/src/sensors/gestures/qsensorgesturemanager.cpp
+++ b/src/sensors/gestures/qsensorgesturemanager.cpp
@@ -53,7 +53,7 @@ QT_BEGIN_NAMESPACE
Sensor Gesture plugins register their recognizers using the registerSensorGestureRecognizer() function.
- \snippet snippets/sensorgestures/creating.cpp Receiving sensor gesture signals
+ \snippet sensorgestures/creating.cpp Receiving sensor gesture signals
*/
diff --git a/src/sensors/qlightsensor.cpp b/src/sensors/qlightsensor.cpp
index 30bd1de5..b712bb6e 100644
--- a/src/sensors/qlightsensor.cpp
+++ b/src/sensors/qlightsensor.cpp
@@ -49,7 +49,7 @@ IMPLEMENT_READING(QLightReading)
/*!
\class QLightReading
\ingroup sensors_reading
-
+ \inmodule QtSensors
\brief The QLightReading class represents one reading from the
light sensor.
diff --git a/src/sensors/qsensor.cpp b/src/sensors/qsensor.cpp
index 0e9fcea3..81cb6530 100644
--- a/src/sensors/qsensor.cpp
+++ b/src/sensors/qsensor.cpp
@@ -78,6 +78,7 @@ QT_BEGIN_NAMESPACE
/*!
\class qoutputrange
\relates QSensor
+ \inmodule QtSensors
\brief The qoutputrange class holds the specifics of an output range.
The class is defined as a simple struct.
@@ -507,7 +508,7 @@ void QSensor::setDataRate(int rate)
Backends have to implement QSensorBackend::isFeatureSupported() to make this work.
- \return whether or not the feature is supported if the backend is connected, or false if the backend is not connected.
+ Returns whether or not the feature is supported if the backend is connected, or false if the backend is not connected.
\since 5.0
*/
bool QSensor::isFeatureSupported(Feature feature) const
diff --git a/src/sensors/qsensorbackend.cpp b/src/sensors/qsensorbackend.cpp
index 44865549..304674ee 100644
--- a/src/sensors/qsensorbackend.cpp
+++ b/src/sensors/qsensorbackend.cpp
@@ -77,7 +77,7 @@ QSensorBackend::~QSensorBackend()
This is the backend side of QSensor::isFeatureSupported(). Reimplement this function if the
backend supports one of the additional sensor features of QSensor::Feature.
- \return whether the feature \a feature is supported by this backend. The default implementation returns false.
+ Returns whether the feature \a feature is supported by this backend. The default implementation returns false.
\since 5.0
*/
bool QSensorBackend::isFeatureSupported(QSensor::Feature feature) const
diff --git a/src/sensors/sensors.pro b/src/sensors/sensors.pro
index e0c68211..2cb33468 100644
--- a/src/sensors/sensors.pro
+++ b/src/sensors/sensors.pro
@@ -10,7 +10,7 @@ simulator {
QT += simulator
}
-QMAKE_DOCS = $$PWD/../../doc/config/qtsensors.qdocconf
+QMAKE_DOCS = $$PWD/doc/qtsensors.qdocconf
load(qt_module)