Merge branch '1.0' of scm.dev.nokia.troll.no:qtmobility/qtm-serviceframework into 1.0

author: Alex <qt-info@nokia.com> 2010-04-28 14:48:19 +1000
committer: Alex <qt-info@nokia.com> 2010-04-28 14:48:19 +1000
commit: 5611f3e48dd574e6f174e78b6963ee5989e22c07 (patch)
tree: a5b295d86b8cd629fc7a9058595c4c4fe099f5f4 /doc/src
parent: ba7e1de2d53af114332f3ddfa95226f9ef2315bb (diff)
parent: a45560afb2bc0dcdaa3af441c0d7161c5da082ab (diff)
8 files changed, 50 insertions, 62 deletions
diff --git a/doc/src/contacts.qdoc b/doc/src/contacts.qdoc
index 927e171ee5..661c53bacd 100644
--- a/doc/src/contacts.qdoc
+++ b/doc/src/contacts.qdoc
@@ -348,7 +348,7 @@ A backend implementor must implement the following interfaces:
 
 \section2 Synchronization and Serialization
 
-The contacts API is used by another Qt Mobility module: the \l {Versit API (technology preview)} {Versit}* module.  It allows
+The contacts API is used by another Qt Mobility module: the \l {Versit API} {Versit}* module.  It allows
 serialization of a QContact into a vCard document, and vice versa.
 
 [*] Versit \reg is a trademark of the Internet Mail Consortium.
diff --git a/doc/src/future.qdoc b/doc/src/future.qdoc
index 5ce8e517f6..4647f155ba 100644
--- a/doc/src/future.qdoc
+++ b/doc/src/future.qdoc
@@ -50,7 +50,7 @@
 \target {Management of Versit Documents}
 \section1 Management of Versit Documents
 
-\l{Versit API (technology preview)}{Versit API Documentation}
+\l{Versit API}{Versit API Documentation}
 
 Versit Classes.
 \annotatedlist versit
diff --git a/doc/src/index.qdoc b/doc/src/index.qdoc
index 088e3070fe..d52bcdb765 100644
--- a/doc/src/index.qdoc
+++ b/doc/src/index.qdoc
@@ -212,6 +212,14 @@
     eventually replace the Phonon API.
 
     For more details see the \l {Multimedia} {Multimedia API overview}.
+    
+    \section2 Sensors
+
+    An API for accessing hardware sensors. This covers both high-level
+    sensors such as screen orientation (portrait, landscape) and low-level,
+    real-time sensors such as accelerometer data.
+
+    For more details see the \l{Sensors API}{Sensors API overview}.
 
     \section2 Service Framework
 
@@ -239,32 +247,11 @@
     
     For more details see the \l {System Information} {System Information API overview}.
 
-    \section1 Included Technology Preview APIs
-    
-    Two additional APIs are included which show future additional APIs. These
-    are pre-release versions and the API will likely change before they are
-    officially released. You may use these APIs in accordance with the terms and
-    conditions contained in the Technology Preview License Agreement
-    accompanying this package.
-
-    We are making these available so that developers can see that future
-    updates will not only refine the API but add important features. We
-    are proud of the work we have done on this project and want to show
-    not only what we are delivering now but what is around the corner.
-    
-    \section2 Sensors
-
-    An API for accessing hardware sensors. This covers both high-level
-    sensors such as screen orientation (portrait, landscape) and low-level,
-    real-time sensors such as accelerometer data.
-
-    For more details see the \l{Sensors API}{Sensors API overview}.
-
     \section2 Versit
 
     An API to manage Versit \reg documents, such as vCards.
 
-    For more details see the \l{Versit API (technology preview)}{Versit API overview}.
+    For more details see the \l{Versit API}{Versit API overview}.
     
     \section1 The QtMobility Namespace 
 
diff --git a/doc/src/installation.qdoc b/doc/src/installation.qdoc
index 2c8eec7128..012ca9e23c 100644
--- a/doc/src/installation.qdoc
+++ b/doc/src/installation.qdoc
@@ -126,7 +126,7 @@ these domains have dependencies and these are outlined below:
        The gstengine plugin for Linux and Maemo depends on gstreamer-0.10 (>= 0.10.19), gstreamer-audio-0.10 (>= 0.10.19), gstreamer-base-0.10 (>= 0.10.19), gstreamer-interfaces-0.10 (>= 0.10.19) and gstreamer-video-0.10 (>= 0.10.19).
        If asound (auto-detected) is available, ALSA device detection will be enabled.
 
-       The QtMobilityMultimediaEngine for Symbian depends on QtMultimedia. 
+       The mmf plugin for Symbian depends on QtMultimedia. 
        To enable all mediaservices on symbian one must download sdk plugins. Sdk plugins are available at \l http://wiki.forum.nokia.com/index.php/SDK_API_Plug-in
        For 5th edition sdk plugins are installed with installer (all at once), but for FP1 and FP2 devices a zip is provided. You will need following plugins to compile all features: 
        MediaPlayerEngine (MediaPlayerUtilityAPI for 3rd FP2), AudioRoutingAPI , Tuner Utility (only for 3rd FP1) Radio Utility API (for 3rd FP2 and 5th ed).
@@ -140,6 +140,16 @@ these domains have dependencies and these are outlined below:
     \o Y
     \o N
 \row
+    \o  Sensors
+    \o  The QtSensors s60_sensor_api plugin for S60 3.1 depends on the \l {http://www.forum.nokia.com/info/sw.nokia.com/id/4284ae69-d37a-4319-bdf0-d4acdab39700/Sensor_plugin_S60_3rd_ed.html}{Sensor API Plug-in}
+    \o  Y
+    \o  N
+\row
+    \o
+    \o  The QtSensors symbian plugin for S60 3.2 depends on the backported \l {http://www.forum.nokia.com/info/sw.nokia.com/id/8059e8ae-8c22-4684-be6b-d40d443d7efc/Sensor_API_Plug_in_S60_3rd_FP2.html}{Sensor API Plug-in}
+    \o  Y
+    \o  N
+\row
     \o  Service Framework
     \o  On all platforms, QtServiceFramework depends on QtSql. QtSql also needs the SQLite 3 driver (enabled by default) at runtime.
     \o  N
diff --git a/doc/src/preview.qdoc b/doc/src/preview.qdoc
index a8ba76947a..44da9c01b4 100644
--- a/doc/src/preview.qdoc
+++ b/doc/src/preview.qdoc
@@ -49,7 +49,7 @@
 \target {Management of Versit Documents}
 \section1 Management of Versit Documents
 
-\l{Versit API (technology preview)}{Versit API Documentation}
+\l{Versit API}{Versit API Documentation}
 
 An overview is available for the \l{versit.html}{Versit API}
 
diff --git a/doc/src/qtmobility-known-issues.qdoc b/doc/src/qtmobility-known-issues.qdoc
index ccd6c1bd78..d52dd678a4 100644
--- a/doc/src/qtmobility-known-issues.qdoc
+++ b/doc/src/qtmobility-known-issues.qdoc
@@ -141,9 +141,9 @@ Support is present for the following System Info API classes
 
 \section2 Non-API specific issues
 \list
-    \o Qt Mobility does not compile if Qt using a namespace
-    \o Not all example applications will display(fit) well on small screens
-    \o On S60, it is currently not possible to use Qt convenience header includes:
+    \o Qt Mobility does not compile if Qt using a namespace.
+    \o Not all example applications will display(fit) well on small screens.
+    \o S60: it is currently not possible to use Qt convenience header includes:
     \code
         #include <QSystemInfo> //does not work on Symbian
         //use
@@ -155,39 +155,39 @@ Support is present for the following System Info API classes
 \list
     \o S60: Async contact operations not supported
     \o S60: Extending contact fields at runtime is not supported on most Symbian platforms because would compromise compatibility with the S60 platform Phonebook application.
-\endlist
-
-\section2 Location API
-\list
-    \o Maemo: backends are not yet fully implemented.
+    \o S60 3.1: the Symbian contacts plugins are not loaded on a device.
 \endlist
 
 \section2 Messaging API
 \list
     \o Messaging filtering and Sorting functions are not fully optimized.
-    \o Maemo: Messaging backends are not fully implemented.
-    \o S60: Exporting IMAP or POP3 Message Updates from client to server is not supported
+    \o Fremantle: \c {QMessageService::compose} not supported for SMS type messages.
+    \o Fremantle: queryMessages service action is synchronous for SMS type messages.
+    \o Fremantle: \c {QMessageService::show} not supported for SMS type messages.
+    \o Fremantle: \c {QMessageManager::messageAdded} signal is not reported for messages in inbox when inbox is open in modest.
+    \o Fremantle: \c {QMessageManager::updateMessage} is not supported.
+    \o Fremantle: \c {QMessageManager::addMessage} is not supported for SMS type messages.
+    \o Fremantle: \c {QMessageManager::addMessage} can not be used to set priority and status of email messages.
+    \o Fremantle and Windows: \c {QMessageServiceAction::send}: Only queues a message for sending, message may or may not be sent depending on connection status and is at the platform's disgression.
+    \o Fremantle, S60 and Windows: \c {QMessageManager::addMessage} can not be used to set size of messages.
+    \o Fremantle and Windows: \c {QMessageManager::addMessage} can not be used to set the date of messages.
+    \o S60: Exporting POP3 Message Updates from client to server is not supported.
     \o S60: Only one level of folders is supported <=> Symbian/S60 applications do not use nested folders
-    \o S60: Complex filter cases are not supported where nested filters are used (for example: \c {QMessageFilter::byParentAccountId(const QMessageAccountFilter ,...)}
     \o S60: ReceptionTimeStamp is not supported in filtering <=> Symbian reports only one date for SMS & MMS which means that \c {QMessage::date()} field is used, not \c {receivedDate()})
-    \o S60: Message size reporting should be improved
     \o S60: Local services messages, for example bluetooth, are listed/read in Inbox
     \o Windows: \c {QMessageServiceAction::queryMessages} does not incrementally emit matching message identifiers or progress information.
-    \o Windows: \c {QMessageStore::instance} shows a blocking modal dialog if MAPI is not installed.
-    \o Windows mobile: \c {QMessageServiceAction::exportUpdates} : Full account synchronization currently unavailable due to lack of synchronous
+    \o Windows: \c {QMessageServiceAction::exportUpdates}: Performs no operation as changes are automatically synchronized with external servers when a connection is available.
     control of update progress.
-    \o Windows mobile: \c {QMessageSerivceAction::retrieve} : Only retrieves content for messages bodies at present. Attachment retrieval
+    \o Windows desktop: \c {QMessageStore::instance} shows a blocking modal dialog if MAPI is not installed.
+    \o Windows mobile: \c {QMessageSerivceAction::retrieve}: Only retrieves content for messages bodies at present. Attachment retrieval
     overridden by mapi/mail client settings.
-    \o Windows mobile: \c {QMessageServiceAction::cancelOperation} : Async nature of native calls used to implement service actions means that
-    cancelOperation will only operate on  \c ::retieveBody at present.
-    \o Windows Mobile: \c {QMessageServiceAction::send}: Provides no way of determining actual transmission failure.
+    \o Windows mobile: \c {QMessageServiceAction::cancelOperation}: Async nature of native calls used to implement service actions means that cancelOperation will only operate on the ::retrieveBody service action.
 \endlist
 
 \section2 Multimedia API
 \list
-    \o S60: S60 specific play list not supported
-    \o S60: Device specific play list management not supported.
-    \o S60: Audio capture does not support currently any special features like format, encoding etc...
+    \o \bold {Multimedia API is in beta state.}
+    \o S60: Audio capture does not support currently any special features like format, encoding etc.
     \o S60: seeking is not working properly
     \o S60: video size does not remain constant in repeated plays
     \o S60: full screen video not working OK
@@ -195,14 +195,10 @@ Support is present for the following System Info API classes
     \o Windows desktop: wmp multimedia plugin does not display video with Windows Media Player 10 or 12
 \endlist
 
-\section2 Publish and Subscribe API
-\list
-    \o Maemo: only supports subscribing but not publishing.
-\endlist
-
 \section2 Sensors API
 \list
-    \o \bold {Sensors API is in technology preview state.}
+    \o S60: The S60 sensor backends are under development and may not be complete.
+    \o S60 3.1: src/s60installs/s60installs.pro: the s60_sensor_api plugin for 3.1 devices is not added to the sis file when generating the sis file for multiple SDKs.
 \endlist
 
 \section2 System Info API
@@ -211,9 +207,4 @@ Support is present for the following System Info API classes
     \o S60: Phone is still charging but power state shows 100% and "wall power".
     \o S60: number of bars for network reporting signal strength is hardcoded.
 \endlist
-
-\section2 Versit API
-\list
-    \o \bold {Versit support for Contacts API is in technology preview state, see \c {src/versit/README}.}
-\endlist
 */
diff --git a/doc/src/sensors.qdoc b/doc/src/sensors.qdoc
index fa1f61e834..8184ee9d19 100644
--- a/doc/src/sensors.qdoc
+++ b/doc/src/sensors.qdoc
@@ -45,6 +45,9 @@
 \brief The Sensors API provides access to sensors.
 \ingroup mobility
 
+\warning This API should be considered in a beta state. It is
+under development and subject to change.
+
 The Sensors API provides access to sensors.
 
 This covers both high-level sensors such as screen orientation (portrait, landscape)
diff --git a/doc/src/versit.qdoc b/doc/src/versit.qdoc
index 4ae289648a..557b154e9c 100644
--- a/doc/src/versit.qdoc
+++ b/doc/src/versit.qdoc
@@ -42,13 +42,10 @@
 /*!
 
 \page versit.html
-\title Versit API (technology preview)
+\title Versit API
 \brief An API to manage Versit documents.
 \ingroup mobility
 
-\warning This API should be considered in a technology preview state. It is
-under development and subject to change.
-
 \tableofcontents
 
 \section1 Namespace
author	Alex <qt-info@nokia.com>	2010-04-28 14:48:19 +1000
committer	Alex <qt-info@nokia.com>	2010-04-28 14:48:19 +1000
commit	5611f3e48dd574e6f174e78b6963ee5989e22c07 (patch)
tree	a5b295d86b8cd629fc7a9058595c4c4fe099f5f4 /doc/src
parent	ba7e1de2d53af114332f3ddfa95226f9ef2315bb (diff)
parent	a45560afb2bc0dcdaa3af441c0d7161c5da082ab (diff)