Merge master into api_changes
[profile/ivi/qtbase.git] / 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_INSTALL_.../raw 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 * QEvent::AccessibilityPrepare, AccessibilityHelp and AccessibilityDescription removed:
338   * The enum values simply didn't make sense in the first place and should simply be dropped.
339
340 QtGui
341 -----
342 * Accessibility has been refactored. The hierachy of accessible objects is implemented via
343   proper parent/child functions instead of using navigate which has been deprecated for this purpose.
344   Table and cell interfaces have been added to qaccessible2.h
345
346 * Touch events and points have been extended to hold additional
347   information like capability flags, point-specific flags, velocity,
348   and raw positions.
349
350 QtWidgets
351 ---------
352 * QInputContext removed as well as related getters and setters on QWidget and QApplication.
353   Input contexts are now platform specific.
354
355 * QInputDialog::getInteger() has been obsoleted. Use QInputDialog::getInt() instead.
356
357 * In Qt 4, many QStyleOption subclasses were introduced in order to keep
358   binary compatibility -- QStyleOption was designed to be extended this way,
359   in fact it embeds a version number. In Qt 5 the various QStyleOption*V{2,3,4}
360   classes have been removed, and their members merged into the respective
361   base classes. Those classes were left as typedefs to keep existing code
362   working. Still, some minor adjustements could be necessary, especially in code
363   that uses QStyleOption directly and does not initialize all the members using
364   the proper Qt API: due to the version bump, QStyle will try to use the additional
365   QStyleOption members, which are left default-initialized.
366
367 * QHeaderView - The following functions have been obsoleted.
368
369   * void setMovable(bool movable) - use void setSectionsMovable(bool movable) instead.
370
371   * bool isMovable() const - use bool sectionsMovable() const instead.
372
373   * void setClickable(bool clickable) - use void setSectionsClickable(bool clickable) instead.
374
375   * bool isClickable() const - use bool sectionsClickable() instead.
376
377   * void setResizeMode(int logicalindex, ResizeMode mode) -
378     use setSectionResizeMode(logicalindex, mode) instead.
379
380   * ResizeMode resizeMode(int logicalindex) const -
381     use sectionResizeMode(int logicalindex) instead.
382
383 QtNetwork
384 ---------
385 * QHostAddress::isLoopback() API added. Returns true if the address is
386   one of the IP loopback addresses.
387
388 * QSslCertificate::serialNumber() now always returns the serial number in
389   hexadecimal format.
390
391 * The openssl network backend now reads the ssl configuration file allowing
392   the use of openssl engines.
393
394
395 QtOpenGL
396 --------
397
398 QtScript
399 --------
400
401
402 QTestLib
403 --------
404 * [QTBUG-20615] Autotests can now log test output to multiple destinations
405   and log formats simultaneously.
406
407 QtSql
408 -----
409 QSqlTableModel/QSqlRelationalTableModel
410
411 * The dataChanged() signal is now emitted for changes made to an inserted
412 record that has not yet been committed. Previously, dataChanged() was
413 suppressed in this case for OnRowChange and OnFieldChange. This was probably
414 an attempt to avoid trouble if setData() was called while handling
415 primeInsert(). By emitting dataChanged(), we ensure that all views are aware
416 of the change.
417
418 * While handling primeInsert() signal, the record must be manipulated using
419 the provided reference. Do not attempt to manipulate the records using the
420 model methods setData() or setRecord().
421
422 * removeRows() no longer emits extra beforeDelete signal for out of range row.
423
424 * removeRows() now requires the whole range of targetted rows to be valid
425 before doing anything. Previously, it would remove what it could and
426 ignore the rest of the range.
427
428 * removeRows(), for OnFieldChange and OnRowChange, allows only 1 row to be
429 removed and only if there are no other changed rows.
430
431 * setRecord() and insertRecord()
432   -Only use fields where generated flag is set to true. This is
433   is consistent with the meaning of the flag.
434   -Require all fields to map correctly. Previously fields that didn't
435   map were simply ignored.
436   -For OnManualSubmit, insertRecord() no longer leaves behind an empty
437   row if setRecord() fails.
438   -setRecord() now automatically submits for OnRowChange.
439
440 * QSqlQueryModel::indexInQuery() is now virtual. See
441 QSqlTableModel::indexInQuery() as example of how to implement in a
442 subclass.
443
444 * QSqlTableModel::selectRow(): This is a new method that refreshes a single
445 row in the model from the database.
446
447 * QSqlTableModel edit strategies OnFieldChange/OnRowChange QTBUG-2875
448 Previously, after changes were submitted in these edit strategies, select()
449 was called which removed and inserted all rows. This ruined navigation
450 in QTableView. Now, with these edit strategies, there is no implicit select()
451 done after committing. This includes deleted rows which remain in
452 the model as blank rows until the application calls select(). Instead,
453 selectRow() is called to refresh only the affected row.
454
455 * QSqlTableModel::isDirty(): New overloaded method to check whether model
456 has any changes to submit. QTBUG-3108
457
458 * QSqlTableModel::setData() and setRecord() no longer revert pending changes
459 that fail upon resubmitting for edit strategies OnFieldChange and OnRowChange.
460 Instead, pending (failed) changes cause new changes inappropriate to the
461 edit strategy to be refused. The application should resolve or revert pending
462 changes. insertRows() and insertRecord() also respect the edit strategy.
463
464 * QSqlTableModel::setData() and setRecord() in OnRowChange no longer have the
465 side effect of submitting the cached row when invoked on a different row.
466 ****************************************************************************
467 *                          Database Drivers                                *
468 ****************************************************************************
469
470
471 ****************************************************************************
472 *                      Platform Specific Changes                           *
473 ****************************************************************************
474
475 Qt for Linux/X11
476 ----------------
477
478
479 Qt for Windows
480 --------------
481 * Accessibility framework uses IAccessible2
482
483
484 Qt for Mac OS X
485 ---------------
486
487
488 Qt for Embedded Linux
489 ---------------------
490
491
492 Qt for Windows CE
493 -----------------
494
495
496 ****************************************************************************
497 *                      Compiler Specific Changes                           *
498 ****************************************************************************
499
500
501 ****************************************************************************
502 *                          Tools                                           *
503 ****************************************************************************
504
505 - Build System
506
507   * Remove qttest_p4.prf file. From now on we should explicitly enable the
508     things from it which we want. Autotest .pro files should stop using
509     'load(qttest_p4)' and start using 'CONFIG+=testcase' instead.
510
511 - Assistant
512
513 - Designer
514   * [QTBUG-8926] [QTBUG-20440] Properties of type QStringList now have
515     translation attributes which apply to all items.
516     They are by default translatable.
517
518 - Linguist
519
520 - rcc
521
522
523 - moc
524
525 * [QTBUG-20785] The moc now has a -b<file> option to #include an additional
526   file at the beginning of the generated file.
527
528
529 - uic
530
531
532 - uic3
533
534
535 - qmake
536
537 * QMAKE_MOC_OPTIONS variable is now available for passing additional parameters
538   to the moc.
539
540
541 - configure
542
543
544 - qtconfig
545
546
547 ****************************************************************************
548 *                          Plugins                                         *
549 ****************************************************************************
550 - The text codecs that were previously plugins are now built into QtCore.
551
552 ****************************************************************************
553 *                   Important Behavior Changes                             *
554 ****************************************************************************
555
556 - QPointer
557
558    * QPointer itself is now deprecated, and the implementation of QPointer
559      has been changed to use QWeakPointer. The old guard mechanism has been
560      removed. This causes two slight changes in behavior when using
561      QPointer:
562
563      * When using QPointer on a QWidget (or a subclass of QWidget), previously
564      the QPointer would be cleared by the QWidget destructor. Now, the QPointer
565      is cleared by the QObject destructor (since this is when QWeakPointers are
566      cleared). Any QPointers tracking a widget will NOT be cleared before the
567      QWidget destructor destroys the children for the widget being tracked.
568
569      * When constructing a QSharedPointer to take ownership of an object after a
570      QPointer is already tracking the object. Previously, the shared pointer
571      construction would not be affected by the QPointer, but now that QPointer
572      is implemented using QWeakPoiner, constructing the QSharedPointer will
573      cause an abort().
574
575
576 - QVariant
577
578   * Definition of QVariant::UserType changed. Currently it is the same as
579     QMetaType::User, which means that it points to the first registered custom
580     type, instead of a nonexistent type.
581
582 - QMetaType
583
584   * Interpretation of QMetaType::Void was changed. Before, in some cases
585     it was returned as an invalid type id, but sometimes it was used as a valid
586     type (C++ "void"). In Qt5, new QMetaType::UnknownType was introduced to
587     distinguish between these two. QMetaType::UnknownType is an invalid type id
588     signaling that a type is unknown to QMetaType, and QMetaType::Void
589     is a valid type id of C++ void type. The difference will be visible for
590     example in call to QMetaType::typeName(), this function will return null for
591     QMetaType::UnknownType and a pointer to "void" string for
592     QMetaType::Void.
593     Please, notice that QMetaType::UnknownType has value 0, which previously was
594     reserved for QMetaType::Void.
595
596
597 - QMessageBox
598
599      * The static function QMessageBox::question has changed the default argument
600      for buttons. Before the default was to have an Ok button. That is changed
601      to having a yes and a no button.