Qt 4.5.2-tower

---------------

The Qt for S60 "Tower" release is the fifth pre-release from the Qt for

S60 porting project. "Tower" is based on the Qt 4.5 codebase (mostly Qt 4.5.2).

This list of changes lists S60 specific fixes only,

for general 4.5.x changes go to:

  http://qt.nokia.com/developer/changes/changes-4.5.0

  http://qt.nokia.com/developer/changes/changes-4.5.1

  http://qt.nokia.com/developer/changes/changes-4.5.2 (partially in Tower)

Some of the changes listed in this file include issue tracking numbers

corresponding to tasks in the Task Tracker:

  http://qt.nokia.com/developer/task-tracker

Each of these identifiers can be entered in the task tracker to obtain

more information about a particular change. Sometimes the task is internal

and cannot be viewed by the public, a lot of them are non-public for Qt for

S60 at the moment.

****************************************************************************

*                          New features                                    *

****************************************************************************

New modules

-----------

- Input methods

    * Added events to support opening and closing the virtual keyboard, called

      software input panel in Qt.

    * Added an option to QApplication to choose between single or double click

      input panel activation.

    * Added input method hints API to Qt. These can be used to instruct input methods

      to only allow certain characters or tailor their appearance.

    * Added Qt::ImAnchorPosition to support querying for selections through input

      methods.

    * Added QInputMethodEvent::Selection to support setting the selection through

      input methods.

- Phonon

    * The Phonon library is now part of Qt, but it comes without a backend.

      This means that applications can build and run against the Phonon

      library, but there is currently no S60 backend plugin providing actual

      multimedia playback. Possible alternatives such as Helix and MMF are

      being investigated.

- QtSql

    * Implemented QtSql module with sqlite3 backend. For now backend is

      provided only in binary format.

- QtWebkit

    * Experimental webkit build for S60. Can be enabled by passing -webkit

      to configure.

New classes

------------

- QScopedPointer

    * Smart pointer, which deletes pointer when destroyed.

Ported classes

--------------

- QColormap

    * Added basic implementation of QColormap for Symbian.

- QLocalSocket and QLocalServer

    * Added support for QLocalSocket and QLocalServer on Symbian.

- QSound

    * Implemented CMdaAudioPlayerUtility based Symbian backend for QSound.

Features

--------

- QApplication

    * Implemented QApplication::beep() for Symbian.

- QPixmap

    * Added supported for converting to/from CFbsBitmap

- QSslSocket

    * Added support for -openssl option i.e. runtime resolving of OpenSSL

      symbols.

- QWidget

    * Basic widgets are now navigatable and usable via keypad on SDK 3

      FP 1 and FP 2.

    * Widgets can now be made semi-transparent on systems that support it

      using Qt::WA_TranslucentBackground.

- Exception safety

    * Improving the exception safety of Qt, not yet complete.

    * Added support for translating between Symbian leaves and standard C++

      exceptions.

Optimizations

-------------

- qdrawhelper

    * Optimized drawing operations for RVCT builds, particulary for ARMV6.

- QFont

    * Use cached DPI for metrics.

- qwidget_s60.cpp

    * Avoid unnecessary calls to FocusChanged in Symbian.

- qwindowsurface_s60.cpp

    * Avoid updating raster buffer pointer on window hide

Documentation

-------------

- exceptionsafety.qdoc

    * A guide to exception safety in Qt.

- symbian-exceptionsafety.qdoc

    * A guide to integrating exception safety in Qt with Symbian.

****************************************************************************

*                          Code clean-up                                   *

****************************************************************************

- Cleanup qeventdispatcher_unix.cpp

    * 247268: All qeventdispatcher_unix.cpp changes were reverted since

    this file is not anymore used in Symbian OS branch.

- Cleanup QtNetwork workarounds implemented earlier due to Open C bugs.

    * 247287: Removed getaddrinfo workaround.

    * 247288: Removed waitForConnected workaround.

    * 247289: Removed qt_socket_accept workaround.

    * 247290: Removed qt_socket_connect workaround.

    * 247290: Removed E32IONREAD workaround.

    * 247293: Removed nativeHasPendingDatagrams workaround.

    * 247295: Removed QNativeSocketEnginePrivate::nativeRead EPIPE

      workaround.

- Other code clean-ups

    * 247278: Removed unnecessary includes from qbackingstore.cpp.

    * Fixed Q_OS_SYMBIAN ifdef usage in qfiledialog_p.h.

    * 247272: Removed qtestnetworkservers.h dependency, used

      network-settings.h.

    * Revert "Work around compiler bug on Nokia Metrowerks compiler."

    * Remove UI highlights being inverted colors based on highlight text 

      colors.

****************************************************************************

*                          Build issues                                    *

****************************************************************************

- Macros

    * QT_NO_DEBUG now properly defined in release mode.

- QTest

    * Fixed testlib export macros for RVCT builds.

- Namespaces

    * Now builds when -qtnamespace option is defined.

****************************************************************************

*                          Changes to existing classes                     *

****************************************************************************

- QApplication

    * 252798: Fixed layout when orientation changed via

      AknAppUi::SetOrientationL.

    * Generating MouseEvents has gone through several changes.

    * qt_init() has been changed: auto flush is always enabled for

      window server sessions on 3.1 SDK for both UDEB and UREL.

    * Added support for '-graphics-system' command line option

- QCoeFepInputContext (non-public)

    * Fixes FEP crash when changing the focused Qt widget to NULL.

    * Fixed a bug where the virtual keyboard could not be opened if there

      was only one input widget.

    * Fixed a crash in FEP when exiting application.

- QDebug

    * Fixed debug printing (incl. qWarning, qFatal) for strings longer

      than 256 characters.

    * introduce a breakpoint to get the emulator to stop in the debugger 

      when qFatal is called

- QDesktopServices

    * Fixed forwardslash/backslash usage as an path separator.

    * Switched QDesktopServices mail-to URL handling to RSendAs in Symbian,

      due to the fact that CSendUi requires extensive capabilities to work

      correctly. Currently e-mail sending with qdesktopservices::openUrl

      works in Symbian only if e-mail account already exists.

- QDesktopWidget

    * 253930: Implement proper resize behavior and emit necessary signals.

- QEventDispatcherSymbian (non-public)

    * Lowered the timeout for reprioritizing the process to 100ms.

    * Fixed ASSERT panic in Symbian event dispatcher.

    * 246600: Fix problem in eventdispatcher destructor / AO canceling.

    * Fixed active scheduler removal when calling QThread::terminate.

    * Fix to Open C bug: select sometimes returns -1 and errno is

      ECONNREFUSED.

    * Fix a crash when using QEventLoop::ExcludeSocketNotifiers flag.

    * Changed to round robin scheduling for Qt's active objects. Other

      active objects will still be scheduled like before.

    * Fixed crash if events are posted before QApplication construction

- QFontDataBase

    * Now, also fonts from the user's /resources/fonts directories are

      available.

- QFontEngine

    * Fix the vertical advance of glyph metrics.

- QFontMetrics

    * Fixed the boundingRect calculation for text.

- QGraphicsView

    * Added support for virtual keyboard to the the viewport.

- QGraphicsTextItem

    * Added support for virtual keyboard.

- QHostInfo

    * Added support for host lookups with multiple ipv4 addresses.

- QInputContext

    * Added QInputContext::s60FilterEvent().

- QIoDevice

    * Fixed compilation error when QIODEVICE_DEBUG is defined.

- QKeyMapper (non-public)

    * Fixed a broken keymapping where Enter key would be mapped to Tab.

- QLocale

    * Removed workaround for missing tzname symbol, fixes QLocal timeZone

      implementation for Symbian.

- QLocalSocket

    * Connecting to QLocalServer is always done in blocking mode.

- QMenuBar

    * Native menus are handled properly even when application has multiple

      QMainWindows.

    * Fixed a bug causing both native and qt menu to be created.

    * Fix for disappearing options menu after coming back from dialog.

- QNativeSocketEnginePrivate (non-public)

    * Socket connect and listen failure is indicated in exception set.

      (Workaround to Open C bug)

- QNetworkInterface

    * Fixed R-handle leak in Symbian version of qnetworkinterface_unix.cpp.

    * Introduced a new qnetworkinterface_symbian.cpp, because there wasn't

      really anything common to UNIX equivalent.

- QPixmap

    * Added fromSymbianCFbsBitmap() and toSymbianCFbsBitmap().

- QPlainTextEdit

    * Added support for virtual keyboard.

- QPluginLoader

    * QPluginLoader will look for plugin stubs from the same folder on other

      drives if it can't find them from the indicated drive.

- QS60Style

    * Added subElementRect implementation for SE_ItemViewItemCheckIndicator.

    * Added support for E90 layouts.

    * Added support for QScrollArea, QTextEditor, QGroupBox, QTreeView, 

      QToolBar and QDial styling.

    * Better support for theme and layout changes.

    * Better support for themed palettes and themed text colors.

    * Better support for multiselection in item views.

    * Better theming for QTable and QPanel.

    * Better support of highlight graphics and texts for QLists, QTreeViews, 

      QCalendarWidgets and QComboBoxes.

    * Support polishing fonts. Fonts are no longer changed within the drawing 

      code.

    * Draw spinbox arrowbuttons side-by-side, instead one on top of the other.

    * Harmonize widget drawing so that widgets are of similar height.

    * Support check states for QLists and QPushButtons.

    * Support flat QPushButtons.

    * Support busy indicator.

    * Support QScrollBar pressed state.

    * Support QPushButton disabled theme graphics.

    * Separate theme background for QDialogs.

    * Clarify QToolButton pressed state.

    * Removed linedrawing of panels and groupboxes.

    * Fix palette-polution for a style that is activated from an application 

      after S60Style has been in use.

    * Fix for frame masks with color depth other than EGrey2.

    * Fix for squeezed QTabBars.

    * Fix memory leak when color skinning graphics.

    * Show focus/Editfocus visualization for KeyPad navigation on

      SDK 3 FP 1 and FP 2.

    * Fix for overwriting user specified palettes.

- QSelectThread (non-public)

    * We force monitoring sockets exception status as well, and not

      just read/write.

    * Notification related to the particular socket signaled via exception

      fd_set will be mapped to the appropriate read/write notification.

- QTemporaryFile

    * Fixed temporary file rename in Symbian OS.

- QTest

    * Disable keypad navigation for autotests by default

- QTextEdit

    * Added support for virtual keyboard.

- QThread

    * Fixed thread termination in Symbian OS.

- QUdpSocket

    * Updated BindFlag documentation to reflect behaviour on Symbian OS.

    * Wrote hack for QUdpSocket::writeDatagram return value in Symbian OS.

- QWidget

    * Added API for setting softkeys.

    * Fixed background painting. Background can now be overwritten from

      setting the respective palette role.

    * Add support for Qt::WA_TranslucentBackground.

- Many classes

    * Improved exception safety.

****************************************************************************

*                          Examples and demos                              *

****************************************************************************

- Anomaly browser 

    * Added to demonstrate QtWebkit usage.

- Deform, Pathstroke, and Wiggly

    * Removed Symbian specific animation timer fixes since more generic

      fix was made to event dispatcher.

- DesktopServices

    * Implemented content filters for desktopservices example.

    * Added error handling to qdesktopservices example when openUrl fails.

- Drilldown

    * Added to demonstrate QtSql usage in Symbian OS.

- Fluidlauncher

    * Removed ugly workaround to make emulator deployment work correctly,

      since the issue has been fixed in qmake.

    * Included drilldown to demonstrate QtSql usage.

    * Updated screenshots to S60 style.

    * Added softkeys example.

    * Added Anomaly browser to fluidlauncher.

- Ftp

    * Enabled default IAP setting for FTP example.

    * IAP dialog will show after FTP UI is on screen.

    * If active IAP exist that one will be used.

- SecureSocketClient

    * Fixed build issue caused by lack of cursor.

- Softkeys

    * New example showing how to use softkeys API in QWidget.

****************************************************************************

*                          Tools                                           *

****************************************************************************

- configure

    * -cetest is no longer a supported switch for configure.

    * -stl option is enabled by default for Symbian OS

    * -openssl option is enabled by default for Symbian OS.

    * -fpu option enables vfpu type selection for ARM targets.

- qmake

    * Support for generating Symbian "test" targets: CONFIG += symbian_test.

    * Support for Symbian Build System, version 2 (aka Raptor) via

      symbian-sbsv2 mkspec.

    * PAGED keyword is added to all MMP files by default, except in S60 3.1

      builds.

    * Read-only flag is no longer preserved when deploying files into

      emulator environment.

    * Changed the timestamp to ISO format in all files generated

      by qmake for symbian-* mkspecs.

    * Qt's VERSION variable will now generate VERSION keyword in mmp files.

    * Made Open C include paths handling bit more robust.

    * Support both Symbian Foundation header structure in /epoc32/include,

      as well as old Symbian/S60 structure

- Release package creation

    * Removed the obsolete script to create release package.

- Createpackage script

    * Now creates packages with .sis suffix.

- Patch_capabilities script

    * Will now patch also vendor id in binaries and the UID in the pkg file.   

****************************************************************************

*                          Documentation                                   *

****************************************************************************

- qmake-manual

    * 250370: Added documentation for ICON keyword.

****************************************************************************

*                          Plugins                                         *

****************************************************************************

- S60 version specific plugins

    * Isolated S60 version dependent functionality to S60 version specific

      plugins (qts60plugin_x_y.dll) to make it possible for single build to

      run on any supported device, even if with reduced functionality on

      some.

****************************************************************************

*                   Important Behavior Changes                             *

****************************************************************************

- Qt libs

    * Qt libs are now built with "All -Tcb" capabilities always. It is now

      always necessary to run patch_capabilities.pl script if self-signing

      of Qt libs is desired.

    * QtCore and QtSql made UNPAGED when installed via SIS file as a 

      workaround for an obscure crash when they are paged.

    * qt_libs.pro updated to reflect Open C dependencies, as Qt requires

      1.5.0 and newer release.

    * Qt libs are now build with the "STDCPP" mmp flag. On platforms from 

      TB9.2, Qt code will throw std::bad_alloc exceptions on allocation

      failure.