1Qt 5.6.1 is a bug-fix release. It maintains both forward and backward
2compatibility (source and binary) with Qt 5.6.0.
3
4For more details, refer to the online documentation included in this
5distribution. The documentation is also available online:
6
7  https://doc.qt.io/qt-5/
8
9The Qt version 5.6 series is binary compatible with the 5.5.x series.
10Applications compiled for 5.5 will continue to run with 5.6.
11
12Some of the changes listed in this file include issue tracking numbers
13corresponding to tasks in the Qt Bug Tracker:
14
15  https://bugreports.qt.io/
16
17Each of these identifiers can be entered in the bug tracker to obtain more
18information about a particular change.
19
20****************************************************************************
21*                   Important Behavior Changes                             *
22****************************************************************************
23
24 - Support for DirectFB is disabled by default, due to lack of
25   development in upstream. To enable the platform plugin, pass the
26   -directfb option to configure.
27 - [QTBUG-44964] The new X event compression feature that was added in 5.6.0
28   no longer applies to motion events from drawing tablets.
29
30configure & build system
31------------------------
32
33 - The configure -D/-I/-L/-l/-R options do not affect the build of Qt's
34   host tools any more when cross-building. While this usually improves
35   the chances of a build succeeding, it may also require adjustments.
36
37qmake
38-----
39
40 - [Unix] Paths passed to configure -R are not automatically used by 3rd
41   party projects any more. Use QMAKE_RPATHDIR if your project explicitly
42   depends on external libraries. Note that this is not needed for Qt or
43   its transitive dependencies.
44 - Expansions of ${QMAKE_FILE_IN_BASE} and ${QMAKE_FILE_OUT_BASE} in extra
45   compilers are now automatically quoted.
46
47****************************************************************************
48*                          Library                                         *
49****************************************************************************
50
51QtCore
52------
53
54 - QObject:
55   * [QTBUG-52542] If the compiler supports variadic templates, functors
56     connected to signals will no longer be copied each time the signal is
57     emitted.
58
59 - QRect:
60   * Fixed integer overflow in center(). This fixes the result for some
61     corner-cases such as a 1x1 rectangle at (INT_MIN, INT_MIN), for which the
62     previous implementation could return anything (due to invoking undefined
63     behavior), but commonly returned (0, 0).
64
65 - QStringRef:
66   * Fixed relational operators against (const char*) to return the correct
67     result.
68
69QtGui
70-----
71
72 - [QTBUG-50199] QWheelEvent::phase() now returns zero rather than
73   Qt::ScrollUpdate when the wheel event comes from an actual non-emulated
74   mouse wheel, and the QT_ENABLE_MOUSE_WHEEL_TRACKING environment variable
75   is set.
76
77- Image:
78   * [QTBUG-50745] Fixed possible crash in QImage::pixel() for mono or indexed
79     images.
80
81QtWidgets
82---------
83
84 - Dialogs:
85   * [QTBUG-51148] Fixed font dialog support for fonts with a non-existent
86     family name and/or pixel size.
87
88 - QHeaderView:
89   * [QTBUG-50171] Fixed a repainting issue when items had been reordered.
90
91 - QListWidget:
92   * [QTBUG-15741] Fixed a bug that caused the default drop action to be
93     ignored when using icon mode.
94
95
96****************************************************************************
97*                      Platform-specific Changes                           *
98****************************************************************************
99
100Android
101-------
102
103 - The navigation bar is now hidden only on Android API level 19 and above.
104
105OS X
106----
107 - [QTBUG-50262] QStandardPaths now returns the correct display name for the
108   download folder.
109 - [QTBUG-7000] QMacPrintEngine now really sets the printer resolution.
110 - [QTBUG-48138] QPinchGesture on OS X now behaves like on other platforms:
111   totalScaleFactor is the magnitude of the pinch and scaleFactor is the delta
112   for the current event.
113
114Windows
115-------
116
117 - Text:
118   * [QTBUG-18711] Fixed disabling hints for application fonts.
119     For example, when automatic scaling by device pixel ratio is in effect.
120   * [QTBUG-47141] Made it possible to disable antialiasing for text when
121     drawing into images.
122
123X11/XCB
124-------
125
126 - [QTBUG-49071] Fixed failure to deliver focusIn events on hide/show.
127
128****************************************************************************
129*                                Tools                                     *
130****************************************************************************
131
132configure & build system
133------------------------
134
135 - [QTBUG-11545][Windows] Added missing -pch/-no-pch options to configure.exe.
136 - [QTBUG-37952][Apple] configure -separate-debug-info is now supported.
137 - [QTBUG-47313][QTBUG-47639] Fixed builds with "debug" and/or "release" in
138   the build path's name.
139 - [QTBUG-51621][Unix] Fixed transitive dependencies on non-Qt libraries.
140 - [QTBUG-51644][QTBUG-53017] Fixed cross-builds which use a host compiler
141   which is significantly different from the target compiler.
142 - [QTBUG-52578][QNX] Unified some defaults between the Unix and Windows
143   configures.
144 - [Unix] configure -R now supports paths relative to -libdir.
145 - [Android@Windows] Added missing -android-ndk-host option to configure.exe.
146 - [MinGW] Fixed -release -force-debug-info builds actually being neither.
147 - [WinCE] Fixed (Open)SSL detection.
148 - Fixed builds with static libc.
149
150qmake
151-----
152
153 - [QTBUG-34182] Fixed UTF-8 BOM breaking dependency calculation.
154 - [QTBUG-38802][WinRT] Capabilities needed by Qt are now automatically
155   added to the manifest.
156 - [QTBUG-50924][WEC7][VS] Fixed deployment of Qt.
157 - [QTBUG-51775][Unix@Windows] Fixed installation of target.targets when
158   cross-building.
159 - [QTBUG-51782] Fixed simultaneous use of the separate_debug_info and
160   no_plugin_name_prefix CONFIG flags.
161 - [QTBUG-52008] qmake-generated Visual Studio projects now automatically
162   invoke windeployqt by default.
163 - [QTBUG-52998] Restored use of -P option when invoking lex.
164 - The expansions ${QMAKE_FILE_IN_EXT}, ${QMAKE_FILE_IN_NAME}, and
165   ${QMAKE_FILE_OUT_PATH} are now understood in extra compilers.
166