Connecting Symbian Devices doc topic needs update for Qt 4.7.4 and Belle

The "Connecting Symbian Devices" documentation topic is updated for Symbian^3 but doesn't cover Symbian Anna or Symbian Belle so it is rather outdated.

Since it is the initial page developers see who have installed Qt SDK and want to head up for Symbian application development with Qt it is important that the page is kept up to date. It must be updated for Qt 4.7.4 release for Belle and earlier devices. (Now experimental release available but must be updated for final release.)

The documentation page is available from doc tree as follows: Qt SDK 1.1 -> Getting started -> Connecting Symbian Devices needs information that in Belle Qt is in ROM. Now it simply asks to install Qt ("..., you must install the software that Qt applications require, typically Qt, Qt Mobility, QtWebkit, and Open C"). The page doesn't go beyond Symbian^3. Symbian Belle is not Symbian^3 but many users may not really read it that way (who knows is Symbian^3 also covering Symbian Anna or Belle?). So the page should explicitly cover also Symbian Belle (and Symbian Anna).

Following updates should be done:

On Initial requirements for running and debugging apps:

• Current statement "Connect the device to the development PC with an USB cable in PC Suite Mode. If you have not previously used the device with Ovi Suite or PC Suite, all the necessary drivers are installed automatically. This takes approximately one minute."
  -> change so that PC Suite or Ovi Suite is mentioned as it is a requirement, this makes later sentences more understandable:
  "Ensure you have PC Suite or Ovi Suite installed. Connect the device to the development PC with an USB cable in PC Suite Mode. If you have not previously used the device with Ovi Suite or PC Suite, all the necessary drivers are installed automatically. This takes approximately one minute."

• But since CODE isn't automatically deployed the "all the necessary drivers are installed automatically" is confusing.
  Or is it still a plan that CODE somehow eventually gets automatically deployed in final Qt 4.7.4 support for Symbian in Qt SDK?

• Statement: "To run Qt applications on Symbian devices, you must install the software that Qt applications require, typically Qt, Qt Mobility, QtWebkit, and Open C." should be changed to "On Symbian^3 and later devices some version of Qt is pre-installed (see Symbian platform notes for more details). On earlier devices you must install the modules that Qt applications require, typically Qt, Qt Mobility, QtWebkit, and Open C. This is explained in Installing Required Applications on Devices section below.". (Btw: there's odd link from the WebKit word to general examples page.)

• Statement: "If you develop on Linux or Mac OS, you must use the Remote Compiler interface to a compilation service at Nokia Developer." should be changed "If you develop on Linux or Mac OS, you must use the Remote Compiler interface available in Qt SDK to make a compilation with network based service at Nokia Developer.". (This should be cross-linked to "Remote Compiler Manual" available in the Qt SDK. If cross-linking is not possible it should be referred to in text.)

• Statement: "To debug applications on Symbian devices by using the Qt Creator Debug mode, you must install the CODA on-device debugging agent on the device. For more information, see Using On-device Debugging Agents."
  However, I wasn't even able to launch app (Run instead of Debug) without CODA so it's not just debug that you need this installed. If this is really the case then IMO CODA should be listed as a requirement for any development for Symbian.

On the "Installing Required Applications on Devices" section:

• The given command names and paths are only valid in Windows installation. In Mac (and I guess in Linux) this is not the case. It should be mentioned briefly that in these the SIS files are available under Qt SDK installation directory within "Symbian" directory.

• It should be warned that when installing Qt to their device developer may replace the pre-installed Qt provided by the device. We should tell that generally developing for Symbian^3 devices onward developers shouldn't update Qt in their devices as these devices have Qt preinstalled. Only in a special case when developer wants to upgrade or downgrade the device provided Qt it is recommended to install the Qt SDK provided Qt SIS files to such devices. Note: Since in Symbian Belle the Qt is in ROM downgrading is not effectively possible. It is possible to install an lower version Qt SIS file to C:\ drive in Symbian Belle but due to DLL loading rules a later version available in ROM is effectively in use.

• "Separate installation packages are provided for Symbian^3 and Symbian^1 devices. To check the Symbian platform version of your device, see Device Specifications.". Nokia Developer site uses terminology "S60 5th Ed" for "Symbian^1" (which appears to be used in Qt SDK and Qt doc). It should be clarified where that these refer to the same release.

• This section should be added information for Symbian Anna and Symbian Belle separately.
  Regarding Belle it should document that Qt is installed as part of device firmware and shouldn't be replaced for normal application development targeting Symbian Belle device. Only in the case if Qt 4.8 or later is used as a development target then Qt 4.8 SIS files can be installed to Belle. Belle's Qt isn't overwritten in such case but Qt from firmware is eclipsed by the installed Qt in the C: drive. For Symbian Anna similarly it should mention that Qt 4.7.3 based Qt bundle is pre-installed and if SIS files are installed the pre-installed Qt is overwritten.

• For Symbian^3 the current section should be refined so that it tells that Symbian^3 devices have Qt 4.6 pre-installed.

(Side note: Qt SDK should be changed so that we provide the SIS files also for Qt 4.6 so that downgrading back to Symbian^3 device version is possible if developers want to test with it. Qt SDK should provide synchronized SIS files with download.qt.nokia.com and all officially released version should be provided. Also Qt SDK SIS files should be changed so that NR flag is removed from them so that it would be possible to uninstall such packages. This is e.g. needed so that one could remove installed Qt 4.8 SIS package from Symbian Belle and roll back to situation that Qt is loaded from ROM.)

On the "Installing Debugging Agents":

• It only refers to download CODA from the server but does not mention it is available as part of the Qt SDK Symbian tool set.

On the "Adding Symbian Platform SDKs" section:

"Qt SDK contains all the tools you need for developing Qt applications for Symbian devices. To use Symbian APIs directly in your applications, you can install additional Symbian Platform SDKs:"

Since Qt SDK also contains the native compilation target for Symbian OS releases (Symbian Belle). This section should rather document that instead of suggest that additional tools are needed. It is last resort where developers actually need Symbian Platform SDKs.