dist/changes-5.0.0

   1 Some of the changes listed in this file include issue tracking numbers
   2 corresponding to tasks in the Qt Bug Tracker:
   3
   4   http://bugreports.qt-project.org/
   5
   6 Each of these identifiers can be entered in the bug tracker to obtain more
   7 information about a particular change.
   8
   9
  10 ****************************************************************************
  11 *                       Source incompatible changes                        *
  12 ****************************************************************************
  13
  14
  15 - QSslCertificate::subjectInfo() and QSslCertificate::issuerInfo() now
  16   return a QStringList instead of a QString
  17
  18 - QSslCertificate::isValid() has been deprecated. Originally it only checked
  19   the certificate dates, but later checking for blacklisting was added. Now
  20   there's a more specific QSslCertificate::isBlacklisted() method.
  21
  22 - Unite clipping support has been removed from QPainter. The alternative is
  23   to unite QRegion's and using the result on QPainter.
  24
  25 - QLibrary::resolve() now returns a function pointer instead of a void
  26   pointer.
  27
  28 - QSslCertificate::alternateSubjectNames() is deprecated (but can be enabled
  29   via QT_DISABLE_DEPRECATED_BEFORE), use
  30   QSslCertificate::subjectAlternativeNames() instead.
  31
  32 - QLibraryInfo::buildKey() has been removed. Likewise, the QT_BUILD_KEY
  33   preprocessor #define has also been removed. The build-key is obsolete
  34   and is no longer necessary.
  35
  36 - QCoreApplication::translate() will no longer return the source text when
  37   the translation is empty. Use lrelease -removeidentical for optimization.
  38
  39 - QString and QByteArray constructors that take a size argument will now treat
  40   negative sizes to indicate nul-terminated strings (a nul-terminated array of
  41   QChar, in the case of QString). In Qt 4, negative sizes were ignored and
  42   result in empty QString and QByteArray, respectively. The size argument to
  43   those constructors now has a default value of -1, thus replacing the separate
  44   constructors that did the same.
  45
  46 - Qt::escape() is deprecated (but can be enabled via
  47   QT_DISABLE_DEPRECATED_BEFORE), use QString::toHtmlEscaped() instead.
  48
  49 - QBool is gone. QString::contains, QByteArray::contains, and QList::contains
  50   used to return an internal QBool class so that the Qt3 code
  51   "if (a.contains() == 2)" wouldn't compile anymore. Such code cannot exist
  52   in Qt4, so these methods return a bool now. If your code used the undocumented
  53   QBool, simply replace it with bool.
  54
  55 - qIsDetached<> has been removed without replacement.
  56
  57 - QMetaType:
  58   * QMetaType::construct() has been renamed to QMetaType::create().
  59   * QMetaType::unregisterType() has been removed.
  60
  61 - QMetaMethod::signature() has been renamed to QMetaMethod::methodSignature(),
  62   and the return type has been changed to QByteArray. This was done to be able
  63   to generate the signature string on demand, rather than always storing it in
  64   the meta-data.
  65
  66 - QTestLib:
  67   * The plain-text, xml and lightxml test output formats have been changed to
  68     show a test result for every row of test data in data-driven tests.  In
  69     Qt4, only fails and skips were shown for individual data rows and passes
  70     were not shown for individual data rows, preventing accurate calculation
  71     of test run rates and pass rates.
  72   * The QTRY_VERIFY and QTRY_COMPARE macros have been moved into QTestLib.
  73     These macros formerly lived in tests/shared/util.h but are now provided
  74     by including the <QtTest/QtTest> header. In addition,
  75     QTRY_VERIFY_WITH_TIMEOUT and QTRY_COMPARE_WITH_TIMEOUT are provided,
  76     allowing for specifying custom timeout values.
  77   * The QTEST_NOOP_MAIN macro has been removed from the API.  If a test is
  78     known at compile-time to be inapplicable for a particular build it should
  79     be omitted via .pro file logic, or the test should call QSKIP in the
  80     initTestCase() method to skip the entire test and report a meaningful
  81     explanation in the test log.
  82   * The DEPENDS_ON macro has been removed from the API.  This macro did nothing
  83     and misled some users to believe that they could make test functions depend
  84     on each other or impose an execution order on test functions.
  85   * The QTest::qt_snprintf function has been removed from the API.  This was an
  86     internal testlib function that was exposed in the public API due to its use
  87     in a public macro.  Any calls to this function should be replaced by a call
  88     to qsnprintf(), which comes from the <QtCore/QByteArray> header.
  89   * The QTest::pixmapsAreEqual() function has been removed from the API.
  90     Comparison of QPixmap objects should be done using QCOMPARE, which provides
  91     more informative output in the event of a failure.
  92   * The QSKIP macro no longer has the "mode" parameter, which caused problems
  93     for calculating test metrics, as the SkipAll mode hid information about
  94     what test data was skipped.  Calling QSKIP in a test function now behaves
  95     like SkipSingle -- skipping a non-data-driven test function or skipping
  96     only the current data row of a data-driven test function.  Every skipped
  97     data row is now reported in the test log.
  98
  99 - The QSsl::TlsV1 enum value was renamed to QSsl::TlsV1_0 .
 100
 101 - QAccessible:
 102   * Internal QAccessible::State enum value HasInvokeExtension removed
 103 - QAccessibleInterface:
 104   * The "child" integer parameters have been removed. This moves the api
 105     to be closer to IAccessible2.
 106     This means several functions lose their integer parameter:
 107     text(Text t, int child) -> text(Text t), rect(int child) -> rect()
 108     setText(Text t, int child, const QString &text) -> setText(Text t, const QString &text)
 109     role(int child) -> role(), state(int child) -> state()
 110   * parent() and child() was added in order to do hierarchical navigation.
 111   * relations() was added as a replacement to relationTo()
 112   * As a consequence of the above two points, navigate() was removed.
 113   * Accessible-Action related functions have been removed. QAccessibleInterface
 114     subclasses are expected to implement the QAccessibleActionInterface instead.
 115     These functions have been removed:
 116     QAccessibleInterface::userActionCount, QAccessibleInterface::actionText,
 117     QAccessibleInterface::doAction
 118 - QAccessibleEvent also loses the child parameter.
 119     QAccessibleEvent(Type type, int child) -> QAccessibleEvent(Type type)
 120     QAccessibleEvent::child() removed.
 121 - QAccessibleActionInterface:
 122   * Refactored to be based on action names. All functions have been changed from using
 123     int parameters to strings.
 124
 125 - QSound has been moved from QtGui to QtMultimedia
 126
 127 - QTabletEvent::QTabletEvent does not take a hiResGlobalPos argument anymore,
 128   as all coordinates are floating point based now.
 129
 130 - QTouchEvent:
 131
 132   * The DeviceType enum and deviceType() have been deprecated due to
 133     the introduction of QTouchDevice.
 134
 135   * The signature of the constructor has changed. It now takes a
 136     QTouchDevice pointer instead of just a DeviceType value.
 137
 138   * TouchPointState no longer includes TouchPointStateMask and
 139     TouchPointPrimary. QTouchEvent::TouchPoint::isPrimary() has
 140     been removed.
 141
 142   * QWidget *widget() has been removed and is replaced by QObject
 143     *target() in order to avoid QWidget dependencies.
 144
 145   * QEvent::TouchCancel has been introduced. On systems where it makes
 146     sense this event type can be used to differentiate between a
 147     regular TouchEnd and abrupt touch sequence cancellations caused by
 148     the compositor, for example when a system gesture gets recognized.
 149
 150 - QMetaType
 151
 152   * Q_DECLARE_METATYPE(Foo*) now requires that Foo is fully defined. In
 153     cases where a forward declared type should be used as a metatype,
 154     Q_DECLARE_OPAQUE_POINTER(Foo*) can be used to allow that.
 155
 156 - QItemEditorFactory
 157
 158   * The signature of the createEditor and valuePropertyName methods
 159     have been changed to take arguments of type int instead of QVariant::Type.
 160
 161 - QWindowSystemInterface:
 162
 163   * The signature of all handleTouchEvent() variants have changed,
 164     taking a QTouchDevice* instead of just a DeviceType value.
 165     Platform or generic plug-ins have to create and register at least
 166     one QTouchDevice before sending the first touch event.
 167
 168   * The event type parameter is removed from handleTouchEvent().
 169
 170 - The previously exported function qt_translateRawTouchEvent() has been removed.
 171   Use QWindowSystemInterface::handleTouchEvent() instead.
 172
 173 - QAbstractEventDispatcher
 174
 175   * The signature for the pure-virtual registerTimer() has changed. Subclasses
 176   of QAbstractEventDispatcher will need to be updated to reimplement the new
 177   pure-virtual 'virtual void registerTimer(int timerId, int interval,
 178   Qt::TimerType timerType, QObject *object) = 0;'
 179
 180   * QAbstractEventDispatcher::TimerInfo is no longer a QPair<int, int>. It is
 181   now a struct with 3 members: struct TimerInfo { int timerId; int interval;
 182   Qt::TimerType timerType; }; Reimplementations of
 183   QAbstractEventDispatcher::registeredTimers() will need to be updated to pass
 184   3 arguments to the TimerInfo constructor (instead of 2).
 185
 186 - QUuid
 187
 188   * Removed implicit conversion operator QUuid::operator QString(), instead
 189   QUuid::toString() function should be used.
 190
 191 - The QHttp, QHttpHeader, QHttpResponseHeader and QHttpRequestHeader classes have
 192   been removed, QNetworkAccessManager should be used instead.
 193
 194 - The QFtp class is no longer exported, QNetworkAccessManager should be used
 195   instead.
 196
 197 - QProcess
 198
 199   * On Windows, QProcess::ForwardedChannels will not forward the output of GUI
 200     applications anymore, if they do not create a console.
 201
 202 - QAbstractSocket's connectToHost() and disconnectFromHost() are now virtual and
 203   connectToHostImplementation() and disconnectFromHostImplementation() don't exist.
 204
 205 - QTcpServer::incomingConnection() now takes a qintptr instead of an int.
 206
 207 - QNetworkConfiguration::bearerName() removed, and bearerTypeName() should be used.
 208
 209 - QDir::convertSeparators() (deprecated since Qt 4.2) has been removed. Use
 210   QDir::toNativeSeparators() instead.
 211
 212 - QIconEngineV2 was merged into QIconEngine
 213   You might need to adjust your code if it used a QIconEngine.
 214
 215 - qmake
 216   * Projects which explicitly set an empty TARGET are considered broken now.
 217   * The makespec and .qmake.cache do not see build pass specific variables any more.
 218   * load()/include() with a target namespace and infile()/$$fromfile() now start with
 219     an entirely pristine context.
 220   * Configure's -sysroot and -hostprefix are now handled slightly differently.
 221     The QT_INSTALL_... properties are now automatically prefixed with the sysroot;
 222     the raw values are available as QT_RAW_INSTALL_... and the sysroot as QT_SYSROOT.
 223     The new QT_HOST_... properties can be used to refer to the Qt host tools.
 224   * Several functions and built-in variables were modified to return normalized paths.
 225
 226 - QTextCodecPlugin has been removed since it is no longer used. All text codecs
 227   are now built into QtCore.
 228
 229 - QDir::NoDotAndDotDot is QDir::NoDot|QDir::NoDotDot therefore there is no need
 230   to use or check both.
 231
 232 - QFSFileEngine, QAbstractFileEngine, QAbstractFileEngineIterator and
 233   QAbstractFileEngineHandler were removed from public API and are no longer
 234   exported. They may temporarily live as private implementation details, but
 235   they may be altogether dropped or otherwise changed at will in the future.
 236
 237 - QLocale
 238   * toShort(), toUShort(), toInt(), toUInt(), toLongLong() and toULongLong() no
 239     longer take a parameter for base, they will only perform localised base 10
 240     conversions. For converting other bases use the QString methods instead.
 241
 242 - QSystemLocale has been removed from the public API.
 243
 244 - QSqlQueryModel::indexInQuery() is now virtual. See note below under QSql.
 245
 246 - qMacVersion() has been removed. Use QSysInfo::macVersion() or
 247   QSysInfo::MacintoshVersion instead.
 248
 249 ****************************************************************************
 250 *                           General                                        *
 251 ****************************************************************************
 252
 253 General Improvements
 254 --------------------
 255
 256 - The directory structure of the qtbase unit-tests has been reworked to
 257   more closely match the directory structure of the code under test.
 258   Integration tests have been moved to tests/auto/integrationtests.
 259
 260 Third party components
 261 ----------------------
 262
 263 -
 264
 265
 266 ****************************************************************************
 267 *                          Library                                         *
 268 ****************************************************************************
 269
 270 QtCore
 271 ------
 272 * drop a bogus QChar::NoCategory enum value; the proper QChar::Other_NotAssigned
 273   value is returned for an unassigned codepoints now.
 274
 275 * layoutAboutToBeChanged is no longer emitted by QAbstractItemModel::beginMoveRows.
 276   layoutChanged is no longer emitted by QAbstractItemModel::endMoveRows. Proxy models
 277   should now also connect to (and disconnect from) the rowsAboutToBeMoved and
 278   rowsMoved signals.
 279
 280 * The default value of the property QSortFilterProxyModel::dynamicSortFilter was
 281   changed from false to true.
 282
 283 * The signature of the virtual QAbstractItemView::dataChanged method has changed to
 284   include the roles which have changed. The signature is consistent with the dataChanged
 285   signal in the model.
 286
 287 * QFileSystemWatcher is now able to return failure in case of errors whilst
 288   altering the watchlist in both the singular and QStringList overloads of
 289   addPath and removePath.
 290
 291 * QString::mid, QString::midRef and QByteArray::mid, if the position passed
 292   is equal to the length (that is, right after the last character/byte),
 293   now return an empty QString, QStringRef or QByteArray respectively.
 294   in Qt 4 they returned a null QString or a null QStringRef.
 295
 296 * QString methods toLongLong(), toULongLong(), toLong(), toULong(), toInt(),
 297   toUInt(), toShort(), toUShort(), toDouble(), and toFloat() no longer use the
 298   default or system locale, they will always use the C locale. This is to
 299   guarantee consistent default conversion of strings. For locale-aware conversions
 300   use the equivalent QLocale methods.
 301
 302 * QDate, QTime, and QDateTime have undergone important behavioural changes:
 303   * QDate only implements the Gregorian calendar, the switch to the Julian
 304     calendar before 1582 has been removed. This means all QDate methods will
 305     return different results for dates prior to 15 October 1582, and there is
 306     no longer a gap between 4 October 1582 and 15 October 1582.
 307   * QDate::setYMD() is deprecated, use QDate::setDate() instead
 308   * Most methods now apply strict validity checks and will return appropriate
 309     and consistent values when invalid.  For example, QDate::year() will return
 310     0 and QDate::shortMonthName() will return QString().
 311   * Adding days to a null QDate or seconds to a null QTime will no longer return
 312     a valid QDate/QTime.
 313   * QDate stores the Julian Day as a qint64 extending date support across a
 314     more interesting range, see the class documentation for details.
 315     * Conversion to YMD form dates is only accurate between to 4800 BCE to
 316       1.4 million CE
 317     * The QDate::addDays() and QDateTime::addDays() methods now take a qint64
 318     * The QDate::daysTo() and QDateTime::daysTo() methods now return a qint64
 319
 320 * QTextCodec::codecForCStrings() and QTextCodec::setCodecForCStrings() have both
 321   been removed. This was removed due to issues with breaking other code from
 322   libraries, creating uncertainty/bugs in using QString easily, and (to a lesser
 323   extent) performance issues.
 324
 325 * QTextCodec::codecForTr() and QTextCodec::setCodecForTr() have been removed,
 326   QCoreApplication::Encoding value CodecForTr is now obsolete, use
 327   DefaultCodec instead. For reasoning, see the codecForCStrings() removal above.
 328
 329 * QIntValidator and QDoubleValidator no longer fall back to using the C locale if
 330   the requested locale fails to validate the input.
 331
 332 * A new set of classes for doing pattern matching with Perl-compatible regular
 333   expressions has been added: QRegularExpression, QRegularExpressionMatch and
 334   QRegularExpressionMatchIterator. They aim to replace QRegExp with a more
 335   powerful and flexible regular expression engine.
 336
 337 QtGui
 338 -----
 339 * Accessibility has been refactored. The hierachy of accessible objects is implemented via
 340   proper parent/child functions instead of using navigate which has been deprecated for this purpose.
 341   Table and cell interfaces have been added to qaccessible2.h
 342
 343 * Touch events and points have been extended to hold additional
 344   information like capability flags, point-specific flags, velocity,
 345   and raw positions.
 346
 347 QtWidgets
 348 ---------
 349 * QInputContext removed as well as related getters and setters on QWidget and QApplication.
 350   Input contexts are now platform specific.
 351
 352 * QInputDialog::getInteger() has been obsoleted. Use QInputDialog::getInt() instead.
 353
 354 * In Qt 4, many QStyleOption subclasses were introduced in order to keep
 355   binary compatibility -- QStyleOption was designed to be extended this way,
 356   in fact it embeds a version number. In Qt 5 the various QStyleOption*V{2,3,4}
 357   classes have been removed, and their members merged into the respective
 358   base classes. Those classes were left as typedefs to keep existing code
 359   working. Still, some minor adjustements could be necessary, especially in code
 360   that uses QStyleOption directly and does not initialize all the members using
 361   the proper Qt API: due to the version bump, QStyle will try to use the additional
 362   QStyleOption members, which are left default-initialized.
 363
 364 QtNetwork
 365 ---------
 366 * QHostAddress::isLoopback() API added. Returns true if the address is
 367   one of the IP loopback addresses.
 368
 369 * QSslCertificate::serialNumber() now always returns the serial number in
 370   hexadecimal format.
 371
 372 * The openssl network backend now reads the ssl configuration file allowing
 373   the use of openssl engines.
 374
 375
 376 QtOpenGL
 377 --------
 378
 379 QtScript
 380 --------
 381
 382
 383 QTestLib
 384 --------
 385 * [QTBUG-20615] Autotests can now log test output to multiple destinations
 386   and log formats simultaneously.
 387
 388 QtSql
 389 -----
 390 QSqlTableModel/QSqlRelationalTableModel
 391
 392 * The dataChanged() signal is now emitted for changes made to an inserted
 393 record that has not yet been committed. Previously, dataChanged() was
 394 suppressed in this case for OnRowChange and OnFieldChange. This was probably
 395 an attempt to avoid trouble if setData() was called while handling
 396 primeInsert(). By emitting dataChanged(), we ensure that all views are aware
 397 of the change.
 398
 399 * While handling primeInsert() signal, the record must be manipulated using
 400 the provided reference. Do not attempt to manipulate the records using the
 401 model methods setData() or setRecord().
 402
 403 * removeRows() no longer emits extra beforeDelete signal for out of range row.
 404
 405 * removeRows() now requires the whole range of targetted rows to be valid
 406 before doing anything. Previously, it would remove what it could and
 407 ignore the rest of the range.
 408
 409 * setRecord() and insertRecord()
 410   -Only use fields where generated flag is set to true. This is
 411   is consistent with the meaning of the flag.
 412   -Require all fields to map correctly. Previously fields that didn't
 413   map were simply ignored.
 414   -For OnManualSubmit, insertRecord() no longer leaves behind an empty
 415   row if setRecord() fails.
 416
 417 * QSqlQueryModel::indexInQuery() is now virtual. See
 418 QSqlTableModel::indexInQuery() as example of how to implement in a
 419 subclass.
 420
 421 * QSqlTableModel::selectRow(): This is a new method that refreshes a single
 422 row in the model from the database.
 423
 424 * QSqlTableModel edit strategies OnFieldChange/OnRowChange QTBUG-2875
 425 Previously, after changes were submitted in these edit strategies, select()
 426 was called which removed and inserted all rows. This ruined navigation
 427 in QTableView. Now, with these edit strategies, there is no implicit select()
 428 done after committing. This includes deleted rows which remain in
 429 the model as blank rows until the application calls select(). Instead,
 430 selectRow() is called to refresh only the affected row.
 431
 432 ****************************************************************************
 433 *                          Database Drivers                                *
 434 ****************************************************************************
 435
 436
 437 ****************************************************************************
 438 *                      Platform Specific Changes                           *
 439 ****************************************************************************
 440
 441 Qt for Linux/X11
 442 ----------------
 443
 444
 445 Qt for Windows
 446 --------------
 447 * Accessibility framework uses IAccessible2
 448
 449
 450 Qt for Mac OS X
 451 ---------------
 452
 453
 454 Qt for Embedded Linux
 455 ---------------------
 456
 457
 458 Qt for Windows CE
 459 -----------------
 460
 461
 462 ****************************************************************************
 463 *                      Compiler Specific Changes                           *
 464 ****************************************************************************
 465
 466
 467 ****************************************************************************
 468 *                          Tools                                           *
 469 ****************************************************************************
 470
 471 - Build System
 472
 473   * Remove qttest_p4.prf file. From now on we should explicitly enable the
 474     things from it which we want. Autotest .pro files should stop using
 475     'load(qttest_p4)' and start using 'CONFIG+=testcase' instead.
 476
 477 - Assistant
 478
 479 - Designer
 480   * [QTBUG-8926] [QTBUG-20440] Properties of type QStringList now have
 481     translation attributes which apply to all items.
 482     They are by default translatable.
 483
 484 - Linguist
 485
 486 - rcc
 487
 488
 489 - moc
 490
 491 * [QTBUG-20785] The moc now has a -b<file> option to #include an additional
 492   file at the beginning of the generated file.
 493
 494
 495 - uic
 496
 497
 498 - uic3
 499
 500
 501 - qmake
 502
 503 * QMAKE_MOC_OPTIONS variable is now available for passing additional parameters
 504   to the moc.
 505
 506
 507 - configure
 508
 509
 510 - qtconfig
 511
 512
 513 ****************************************************************************
 514 *                          Plugins                                         *
 515 ****************************************************************************
 516 - The text codecs that were previously plugins are now built into QtCore.
 517
 518 ****************************************************************************
 519 *                   Important Behavior Changes                             *
 520 ****************************************************************************
 521
 522 - QPointer
 523
 524    * QPointer itself is now deprecated, and the implementation of QPointer
 525      has been changed to use QWeakPointer. The old guard mechanism has been
 526      removed. This causes two slight changes in behavior when using
 527      QPointer:
 528
 529      * When using QPointer on a QWidget (or a subclass of QWidget), previously
 530      the QPointer would be cleared by the QWidget destructor. Now, the QPointer
 531      is cleared by the QObject destructor (since this is when QWeakPointers are
 532      cleared). Any QPointers tracking a widget will NOT be cleared before the
 533      QWidget destructor destroys the children for the widget being tracked.
 534
 535      * When constructing a QSharedPointer to take ownership of an object after a
 536      QPointer is already tracking the object. Previously, the shared pointer
 537      construction would not be affected by the QPointer, but now that QPointer
 538      is implemented using QWeakPoiner, constructing the QSharedPointer will
 539      cause an abort().
 540
 541
 542 - QVariant
 543
 544   * Definition of QVariant::UserType changed. Currently it is the same as
 545     QMetaType::User, which means that it points to the first registered custom
 546     type, instead of a nonexistent type.
 547
 548 - QMetaType
 549
 550   * Interpretation of QMetaType::Void was changed. Before, in some cases
 551     it was returned as an invalid type id, but sometimes it was used as a valid
 552     type (C++ "void"). In Qt5, new QMetaType::UnknownType was introduced to
 553     distinguish between these two. QMetaType::UnknownType is an invalid type id
 554     signaling that a type is unknown to QMetaType, and QMetaType::Void
 555     is a valid type id of C++ void type. The difference will be visible for
 556     example in call to QMetaType::typeName(), this function will return null for
 557     QMetaType::UnknownType and a pointer to "void" string for
 558     QMetaType::Void.
 559     Please, notice that QMetaType::UnknownType has value 0, which previously was
 560     reserved for QMetaType::Void.
 561
 562
 563 - QMessageBox
 564
 565      * The static function QMessageBox::question has changed the default argument
 566      for buttons. Before the default was to have an Ok button. That is changed
 567      to having a yes and a no button.