dist/changes-4.6.0

   1 Qt 4.6 introduces many new features and improvements as well as bugfixes
   2 over the 4.5.x series. For more details, refer to the online documentation
   3 included in this distribution. The documentation is also available online:
   4
   5   http://qt.nokia.com/doc/4.6
   6
   7 The Qt version 4.6 series is binary compatible with the 4.5.x series.
   8 Applications compiled for 4.5 will continue to run with 4.6.
   9
  10 Some of the changes listed in this file include issue tracking numbers
  11 corresponding to tasks in the Task Tracker:
  12
  13   http://qt.nokia.com/developer/task-tracker
  14
  15 Each of these identifiers can be entered in the task tracker to obtain more
  16 information about a particular change.
  17
  18 ****************************************************************************
  19 *                           General                                        *
  20 ****************************************************************************
  21
  22  - QtDBus
  23    * The minimum required version of the D-Bus reference library is
  24      now 0.93.
  25
  26
  27 ****************************************************************************
  28 *                          Library                                         *
  29 ****************************************************************************
  30
  31     * [245219] Added QXmlQuery::setFocus(const QString &focus);
  32
  33  - QVariant
  34     * Many optimisations
  35     * Added QVariant::toFloat() and QVariant::toReal()
  36     * Added QVariant(float) constructor
  37
  38 ****************************************************************************
  39 *                      Platform Specific Changes                           *
  40 ****************************************************************************
  41
  42  - Significant external contribution from Milan Burda for planned removal
  43    of (non-unicode) Windows 9x/ME support.
  44
  45  - QRegion is no longer a GDI object by default. This means it is no
  46    longer subject to gui-thread only nor does it potentially impact
  47    the 10.000 GDI object limit per process. By explicitly calling
  48    .handle() a GDI object will be created and memory managed by
  49    QRegion. The native handle is for reading out only. Any GDI calls
  50    made on the HRGN handle will not affect the QRegion.
  51
  52 ****************************************************************************
  53 * Important Behavior Changes *
  54 ****************************************************************************
  55
  56  - The experimental Direct3D paint engine has been removed. The reason for
  57    this is that Nokia focuses on OpenGL for desktop hardware accelerated
  58    rendering.
  59
  60  - The default engine used to draw onto OpenGL buffers has changed in
  61    Qt 4.6. The QPaintEngine::OpenGL2 engine is now used as the default
  62    engine. This *may* cause compatibility problems for applications
  63    that use a mix of QPainter and native OpenGL calls to draw into a GL
  64    buffer. Use the QGL::setPreferredPaintEngine() function to enforce
  65    usage of the old GL paint engine.
  66
  67  - When mixing OpenGL and QPainter calls you need to surround your
  68    custom OpenGL calls with QPainter::beginNativePainting() and
  69    QPainter::endNativePainting().
  70    This is to ensure that the paint engine flushes any pending drawing and sets
  71    up the GL modelview/projection matrices properly before you can issue custom
  72    OpenGL calls, and to let the paint engine synchronize to the painter state
  73    before resuming regular QPainter based drawing.
  74
  75  - Graphics View has undergone heavy optimization work, and as a result of
  76    this work, the following behavior changes were introduced.
  77
  78    a) QStyleOptionGraphicsItem::exposedRect now contains the item's bounding
  79       rectangle, and QStyleOptionGraphicsItem::matrix is uninitialized by
  80       default. You can enable an exact exposed rectangle and a correct matrix
  81       by enabling the flag QGraphicsItem::ItemUsesExtendedStyleOptions.
  82
  83    b) QStyleOptionGraphicsItem::levelOfDetails is obsoleted and its value is
  84       always initialized to 1. Instead you can call
  85       QStyleOptionGraphicsItem::levelOfDetailFromTransform(const QTransform &)
  86       to determine the level of detail.
  87
  88    c) QGraphicsView no longer calls QGraphicsView::drawItems(), and in turn
  89       QGraphicsScene::drawItems(), by default. You can get the old behavior
  90       back by enabling QGraphicsView::IndirectPainting.
  91
  92    d) QGraphicsItem no longer calls itemChange() for position and
  93       transformation changes. If you want to receive notifications for changes
  94       to the item's position and transformation, you can set the flag
  95       QGraphicsItem::ItemSendsGeometryChanges (which is enabled by default by
  96       QGraphicsWidget and QGraphicsProxyWidget).
  97
  98  - QDesktopWidget on X11 no longer emits the resized(int) signal when screens
  99    are added or removed. This was not done on other platforms. Use the
 100    screenCountChanged signal instead
 101
 102  - QUrl's parser is more strict when for hostnames in URLs. QUrl now
 103    enforces STD 3 rules:
 104
 105     * each individual hostname section (between dots) must be at most
 106       63 ASCII characters in length;
 107
 108     * only letters, digits, and the hyphen character are allowed in the
 109       ASCII range; letters outside the ASCII range follow the normal
 110       IDN rules
 111
 112    That means QUrl no longer accepts some URLs that were invalid
 113    before, but weren't interpreted as such.
 114
 115  - The Unix configure-time check for STL is stricter now in Qt
 116    4.6.0. This means some legacy STL implementations may fail to pass
 117    the test and, therefore, Qt will automatically disable STL support.
 118
 119    This is a binary-compatible change: existing code will continue to
 120    work without being recompiled. However, it affects the source code,
 121    since some STL-compatibility API will not be enabled.
 122
 123    Platforms affected by this change:
 124      * solaris-cc-* with the default (Cstd) C++ STL library
 125        recommendation: use -library=stlport4
 126        See Sun Studio's documentation for the effects of this option
 127
 128  - QVariant has now a new implicit constructor that takes a float. This
 129    means that code that assigned a float to a variant would create a
 130    variant with userType QMetaType::Float, instead of QVariant::Double.
 131
 132  - QDataStream will now read and write all floating point numbers with the
 133    same precision, regardless of whether it's streamed into or out from a
 134    float or double. This is to maintain compatibility across platforms with
 135    a different default precision for qreal. The default is 64-bit precision
 136    for all floating point numbers, and this can be changed using the new
 137    function setFloatingPointPrecision(). Set Qt_4_5 as the version of the
 138    QDataStream to get the behavior of previous versions.
 139