Document the state of support in Symbian.

The content was compiled primarily by asking the members of the S60
team.

Reviewed-by: David Boddie
(cherry picked from commit 0a9318983b92eb1994aceacee6328e55710a42ad)

2 files changed, 127 insertions, 1 deletions

diff --git a/doc/src/platforms/supported-platforms.qdoc b/doc/src/platforms/supported-platforms.qdoc
index 560ddfe..2b4792f 100644
--- a/doc/src/platforms/supported-platforms.qdoc
+++ b/doc/src/platforms/supported-platforms.qdoc
@@ -89,7 +89,7 @@
                                      \o gcc (\l{http://www.codesourcery.com/}{Codesourcery version)}
     \row    \o Windows CE 5.0 (ARMv4i, x86, MIPS)
                                      \o MSVC 2005 WinCE 5.0 Standard (x86, pocket, smart, mipsii)
-    \row    \o Symbian (S60 3.1, 3.2 and 5.0)
+    \row    \o \l {Qt for Symbian} {Symbian (S60 3.1, 3.2 and 5.0)}
                                      \o RVCT, GCCE, WINSCW
     \endtable
 
diff --git a/doc/src/platforms/symbian-support.qdoc b/doc/src/platforms/symbian-support.qdoc
new file mode 100644
index 0000000..f0109a9
--- /dev/null
+++ b/doc/src/platforms/symbian-support.qdoc
@@ -0,0 +1,126 @@
+/****************************************************************************
+**
+** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
+** All rights reserved.
+** Contact: Nokia Corporation (qt-info@nokia.com)
+**
+** This file is part of the documentation of the Qt Toolkit.
+**
+** $QT_BEGIN_LICENSE:LGPL$
+** No Commercial Usage
+** This file contains pre-release code and may not be distributed.
+** You may use this file in accordance with the terms and conditions
+** contained in the Technology Preview License Agreement accompanying
+** this package.
+**
+** GNU Lesser General Public License Usage
+** Alternatively, this file may be used under the terms of the GNU Lesser
+** General Public License version 2.1 as published by the Free Software
+** Foundation and appearing in the file LICENSE.LGPL included in the
+** packaging of this file.  Please review the following information to
+** ensure the GNU Lesser General Public License version 2.1 requirements
+** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
+**
+** In addition, as a special exception, Nokia gives you certain additional
+** rights.  These rights are described in the Nokia Qt LGPL Exception
+** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
+**
+** If you have questions regarding the use of this file, please contact
+** Nokia at qt-info@nokia.com.
+**
+**
+**
+**
+**
+**
+**
+**
+** $QT_END_LICENSE$
+**
+****************************************************************************/
+
+/*!
+    \page symbian-support.html
+    \title Qt for Symbian
+    \ingroup platform-specific
+    \brief Information about the state of support for the Symbian platform.
+
+    Qt for Symbian is not yet fully on a par with other platforms with respect
+    to stability and feature support. This page documents the current shortcomings
+    of the Symbian port.
+
+    \section1 Source Compatibility
+
+    Qt for Symbian provides the same level of source compatibility guarantee as
+    given for other platforms.  That is, a program which compiles against a
+    given version of Qt for Symbian will also compile against all future versions.
+
+    \section1 Binary Compatibility
+
+    As with every supported platform, we will strive to maintain
+    application behavior and binary compatibility throughout the lifetime of
+    the Qt 4.x series. However, due to the fact that Symbian support is
+    newly added in 4.6.0, it is possible that minor corrections to the
+    behavior and to the ABI in 4.6.1 will be required in order to ensure
+    compatibility going forward.
+
+
+    \section1 Supported Devices
+
+    Qt should work on all phones which run one of the following versions of S60:
+
+    \table
+    \header \o S60 version
+    \row \o 3.1
+    \row \o 3.2
+    \row \o 5.0
+    \endtable
+
+    Qt has received Tier 1 testing on the following phone models:
+
+    \table
+    \header \o Phone
+    \row    \o Nokia E71
+    \row    \o Nokia E72
+    \row    \o Nokia 5800
+    \endtable
+
+    \section1 Supported Functionality
+
+    The following technologies and classes are not supported:
+
+    \table
+    \header \o Technology
+            \o Note
+    \row    \o QtConcurrent
+            \o
+    \row    \o QtDBus
+            \o Will never be supported.
+    \row    \o QtOpenGL
+            \o Support for OpenGL ES may arrive in a future release.
+    \row    \o Printing support
+            \o
+    \row    \o Backend for QtMultimedia
+            \o Although the module itself is supported, no backend for Symbian
+               is available. However, there is a backend available for Phonon.
+    \row    \o Qt3Support
+            \o Will never be supported.
+    \row    \o QtSql: SQLite as driver
+            \o The only driver supported is SQLite.
+    \row    \o Developer Tools
+            \o Developer tools such as Designer, Assistant and Creator do not
+               run on Symbian OS.
+    \endtable
+
+
+    \section1 Known Issues
+
+    Known issues can be found by visiting the
+    \l{http://qt.gitorious.org/qt/pages/Qt460KnownIssues}{wiki page} with an
+    up-to-date list of known known issues, or by
+    \l{http://bugreports.qt.nokia.com/browse/QTBUG/component/19171}{browsing} the
+    S60 component in Qt's public task tracker, located at
+    \l{http://bugreports.qt.nokia.com/}{http://bugreports.qt.nokia.com/}.
+
+*/
+