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