Release note  
============  

Qt 6.1 introduces many new features and improvements as well as bugfixes  
over the 6.0.x series. For more details, refer to the online  
documentation included in this distribution. The documentation is also  
available online:  
  
https://doc.qt.io/qt-6/index.html  
  
The Qt version 6.1 series is binary compatible with the 6.0.x series.  
Applications compiled for 6.0 will continue to run with 6.1.  
  
Some of the changes listed in this file include issue tracking numbers  
corresponding to tasks in the Qt Bug Tracker:  
  
https://bugreports.qt.io/  
  
Each of these identifiers can be entered in the bug tracker to obtain  
more information about a particular change.  
  
To make it easier to port to Qt 6, we have created a porting guide to  
summarize those changes and provide guidance to handle them. In the  
guide, you can find links to articles about changes that may affect your  
application and help you transition from Qt 5.15 to Qt 6:  
  
https://doc.qt.io/qt-6/portingguide.html  
  
Important Changes  
-----------------  
  
### qtbase  
* 85cd9b144b QVarLengthArray: fix aliasing error in insert(it, n, v)  
Fixed an aliasing bug affecting insertions of objects aliasing existing  
elements.  
  
* f63f4b3e62 Revert "Windows: Add synthesized fonts also when there is a  
style name"  
Fixed a regression where different font styles and/or weights would not  
be available.  
  
* 8db031cb0f Change QCollator's default locale to QLocale().collation()  
The default locale used by QCollator is now the collation locale of the  
default QLocale. This restores the ability (lost at 5.14) to control the  
locale used by QString::localeAwareCompare(), while retaining the use of  
a collation locale when the default is the system locale.  
  
* c4012ff5f0 Make QFutureWatcher::isFinished() consistent with the  
watched QFuture  
The QFutureWatcher::isFinished() method now indicates if the related  
QFuture is finished, instead of indicating if the finished() signal was  
delivered. This makes it consistent with the future that is being  
watched.  
  
* 3fa9c19481 QCryptographicHash: don't present the same data over and  
over again  
Fixed a bug where presenting more than 4GiB in a single addData() call  
would calculate the wrong result().  
  
* 36760514a9 QXpmHandler: fix re-entrancy bug in xpm_color_name  
Fixed a race condition when concurrently writing .xpm files.  
  
* e0c6f50849 QXpmHandler: actually limit characters-per-pixel to four  
Instead of writing a corrupt file, rejects to write XPM files with more  
than 64^4 colors (more than four characters per pixel) now.  
  
* 77672e6c16 Fix memory leak if eXIf has incorrect crc  
Fix for possible memory leak in libpng was backported.  
  
### qtsvg  
* 77483e3 Limit font size to avoid numerous overflows  
Avoid numerous overflows by limiting font size to 0xffff. This fixes  
oss-fuzz issue 31701.  
  
### qtdoc  
* 41c06b3f Move Qt Shader Tools, Qt Quick 3D, Qt Quick Timeline to GPL  
section  
Mark Qt Shader Tools, Qt Quick 3D, and Qt Quick Timeline in the module  
overview as available under Commercial/GPLv3 only.  
  
### qtvirtualkeyboard  
* 6c42bcb Fix processing of hard Qt::Key_Backspace and Qt::Key_Delete  
Fix processing of hard backspace and delete keys.  
  
  
Fixes  
-----  
  
### qtbase  
* QTBUG-94501 GStreamer::Gl dependency is not recorded correctly in a  
static build  
* QTBUG-94069 MacOS ComboBox Focus Ring is Too Tall  
* QTBUG-82835 Stale socket notifications can be emitted to new sockets  
* QTBUG-94175 QGraphicsProxyWidget: rendered Arabic text incomplete in  
large font sizes when OpenGL is used  
* QTBUG-65637 Window minimizing broken after building QT app with Mac OS  
High Sierra SDK  
* QTBUG-94246 Memory leak in qsql_oci plugin  
* QTBUG-91919 Qt will crash if changing screen resolution on Mac  
* QTBUG-94706 missing documentaiton details about QFile::copy()  
* QTBUG-94538 Change cursor theme is not applied immediately . The Qt5  
app needs to be restarted.  
* QTBUG-85529 Polytonic Greek characters cannot be composed both ways  
* QTBUG-83869 Correction to the documentation:  
https://doc.qt.io/qt-5/qtransform.html#basic-matrix-operations  
* QTBUG-85714 QOpenGLWidget with NativeWindow QDockWidget does not  
render when undocked  
* QTBUG-94839 QSystemTrayIcon::isSystemTrayAvailable() opens a new file  
descriptor on each call which isn't closed  
* QTBUG-91398 When QFont::NoFontMerging is set then if bold or italics  
is requested that is not provided by the font then it will end up not  
synthesizing this  
* QTBUG-92477 Memory leak in QFontDatabase  
* QTBUG-93890 Crash in webOS emulator with recent meta-qt6  
* QTBUG-78043 non-native QFileDialog displaying incorrect mapped network  
drive names  
* QTBUG-94973 Build fails when configuring twice with CMake and with  
both INSTALL_MKSPECSDIR and QT_QMAKE_TARGET_MKSPEC set  
* QTBUG-91125 QTextFormat::FullWidthSelection does not work with right-  
to-left text layout  
* QTBUG-90683 Some keyboard shortcuts will crash Qt when matching is  
attempted on macOS 10.15 or higher  
* QTBUG-65637 Window minimizing broken after building QT app with Mac OS  
High Sierra SDK  
* QTBUG-92561 Strange selection behavior of with ExtendedSelection +  
SelectRows  
* QTBUG-83619 Stylesheet: QAbstractItemView::indicator changes selected  
item text color  
* QTBUG-94981 QTreeView: expandToDepth() and expandAll() ends  
prematurely for asynchronous models  
* QTBUG-95013 pt_BR translations not loaded  
* QTBUG-95198 Building QtMultimedia qmake projects is broken on Windows  
* QTBUG-94788 QListView will be reset when setSelectionMode  is  
MultiSelection  
* QTBUG-94226 QListView - broken drag-n-drop items movement  
* QTBUG-94802 [Reg-5.15.4->5.15.5]Menu separator is not visible  
* QTBUG-38776 QDockWidget titlebar icons are not drawn with high DPI  
* QTBUG-94069 MacOS ComboBox Focus Ring is Too Tall  
* QTBUG-94824 In qlinedit, icon and text overlap  
* QTBUG-86846 the password box not refreshed under Chinese input method  
* QTBUG-94942 QML type registration emits "qt6quick_metatypes.json:  
illegal value"  
* QTBUG-94737 Crash in QThreadOnce test  
* QTBUG-95009 QNetworkDiskCache::cacheSize() returns a size twice as  
large as the real one.  
* QTBUG-95277 HTTP2: QNetworkReply::encrypted not emitted  
* QTBUG-94733 When the display is set to 150% and a QMdiSubWindow is  
maximized then the icons can be incorrectly displayed  
* QTBUG-95293 QCocoaAccessibilityElement incorrect selector for  
"enabled": should be isAccessibilityEnabled not  
accessibilityEnabledAttribute  
* QTBUG-95255 After setDefaultAction for a QToolButton and call  
setChecked, then checked status wrong  
* QTBUG-91048 QFutureWatcher::isFinished() stays false after  
waitForFinished()  
* QTBUG-95283 No TLS backend available in statically built project  
* QTBUG-91459 When using Speech Recognition on a multiple monitor setup  
telling it to click a button does not always work on the secondary  
monitor  
* QTBUG-77656 Crash when waking up with multiple displays in clamshell  
mode  
* QTBUG-95383 QFileSystemModel sort extremely inefficient with wildcards  
* QTBUG-95429 Expired certificates in tst_QSslCertificate  
* QTBUG-95619 [Mac] Memory leak in  
QNSWindow::applicationActivationChanged  
* QTBUG-95273 QFuture::then() documentation about threading is unclear  
* QTBUG-20894 QCompleter unexpectedly changes QLineEdit text  
* QTBUG-56595 QXcbConnection::getTimestamp() returns old timestamp  
* QTBUG-95631 Stylesheet issue when try to change background color with  
a editable combobox on hover  
* QTBUG-94215 [Reg 5.15.2->5.15.3/6] QString::lastIndexOf is broken  
* QTBUG-93360 Compile Qt with gcc 11  
* QTBUG-94973 Build fails when configuring twice with CMake and with  
both INSTALL_MKSPECSDIR and QT_QMAKE_TARGET_MKSPEC set  
* QTBUG-87429 tst_QRhi::renderToTextureArrayOfTexturedQuad fails on  
Android Emulator in CI  
* QTBUG-94463 QThreadPool creates one thread more than maxThreadCount  
* QTBUG-95050 [REG: 5.2->5.14] Locale used by  
QString::localeAwareCompare() no longer changeable  
* QTBUG-95199 Incorrect propagation of iOS bitcode and -fapplication-  
extension flags to user projects  
* QTBUG-91713 QtBase benchmarks fail for qtimezone, qdiriterator, and  
qfile  
* QTBUG-95303 Internal module pri files are missing public include  
header locations  
* QTBUG-80957 QFutureInterface: reportResults with an empty vector  
breaks results  
* QTBUG-95429 Expired certificates in tst_QSslCertificate  
* QTBUG-70137 Dockwidgets - Placing QDockWidget is almost impossible  
* QTBUG-71590 Qt is using "Non-SDK" interfaces, will be blocked by  
Android  
* QTBUG-95552 Reproducible crash from wheelEvent in QGraphicsScene  
containing a QWidget with a Q*BoxLayout  
  
### qtsvg  
* QTBUG-94878 QSvgRenderer crash  
* QTBUG-92184 QtSVG cannot understand minified SVGs if they contain arcs  
  
### qtdeclarative  
* QTBUG-92840 FolderListModel docs have gone missing  
* QTBUG-92563 Extra, incorrect HoverMove sent after MouseButtonRelease  
* QTBUG-95073 TextEdit inconsistency with some key events (modifiers)  
* QTBUG-75553 QML Canvas, reset line dash failed  
* QTBUG-89375 No C++ documentation for containmentMask  
* QTBUG-94622 svg Image is  Pixelated when windows is scaled  
* QTBUG-95132 Memory Leak when using QQuickPaintedItem with RHI  
* QTBUG-95417 Regression 5.15.4: gc() within generator functions crash  
* QTBUG-95591 QtQuick documentation references private class  
"QQuickColorGroup"  
* QTBUG-95811 KeyNavigation: all properties should be marked as attached  
* QTBUG-94798 crash in QQuickDesignerSupport with gcc at ubuntu  
* QTBUG-94971 QHoverEvent::scenePosition() is actually local position  
* QTBUG-94622 svg Image is  Pixelated when windows is scaled  
* QTBUG-94928 loop QQuickDesignerSupport with simple example  
* QTBUG-75862 FocusReason is broken in Controls 2  
* QTBUG-89380 Cannot use QtObject as containmentMask  
* QTBUG-94844 Rendering errors with ShaderEffect after hiding and  
reshowing a window  
  
### qtactiveqt  
* QTBUG-95407 activeqt/qutlook fails to configure  
  
### qttools  
* QTBUG-91082 [REG: 5.12->5.13] Assistant does not support custom  
filters anymore  
* QTBUG-95561 Typo in the "Introduction To QDoc" manual page.  
* QTBUG-87677 windeployqt locates a release version of icudtXX.dll for a  
debug binary  
* QTBUG-94056 Qt6.1.1 Assistant Manual has incorrect version: 6.1.0  
  
### qttranslations  
* QTBUG-94718 TS files generated by ts-${catalog}-${lang} should contain  
source text location information  
* QTBUG-95014 pt_BR translations load incorrect catalogs  
  
### qtdoc  
* QTBUG-92848 Update Documentation of Qt6: Deploying QML Applications -  
Ahead-of-Time Compilation  
  
### qtwayland  
* QTBUG-94602 Releasing wayland buffer from Qt compositor side  
  
### qt3d  
* QTBUG-93035 Adding a disable entity to the scene and enabling it later  
isn't properly picked up  
* QTBUG-95130 Qt3D ShaderProgram sources cannot compile on iOS (RHI)  
  
### qtquickcontrols2  
* QTBUG-92824 QtQuick.Controls Button.qml wrong parent used for  
transitionDuration (line 77)  
* QTBUG-93041 If Button is used as delegate of ListView then application  
fails  
* QTBUG-83630 Qt Quick Control 2 Tooltip can be way too big when you  
have newlines  
  
### qtdatavis3d  
* QTBUG-94441 Axis title labels do not respect the Abstract3DAxis's  
titleFixed property  
* QTBUG-80194 Q3DScatter Memory Leak  
* QTBUG-78767 baseGradient for Surface3DSeries is applied incorrectly  
when the trailing line(s) of the QSurfaceDataArray contain NaN only  
* QTBUG-94364 Rotate and zoom do not work on Android  
* QTBUG-95112 Surfacedata containing only nans at row 0 fails to render  
surface and crashes the next time surface is rendered  
* QTBUG-94331 Some examples do not work correctly on macOS  
  
### qtvirtualkeyboard  
* QTBUG-94017 Cursor position moves when un-converted Japanese is  
deleted  
* QTBUG-68412 tst_plugin::test_pinyinInputMethod crashes on arm  
* QTBUG-94715 Qt Virtualkeyboards support for Chinese language doesn't  
work properly  
* QTBUG-95664 VirtualKeyboardSettings: Readonly property is not marked  
as such  
* QTBUG-95893 Missing documentation for dictionary API  
* QTBUG-94017 Cursor position moves when un-converted Japanese is  
deleted  
  
### qtquicktimeline  
* QDS-3216 Flickering when using default value as implcit first keyframe  
  
### qtquick3d  
* QTBUG-95212 Error when empty scene is loaded  
  
### qtcoap  
* QTBUG-94763 [CoAP] When resource is observed the QT CoAP client sends  
an acknowledgement packet which is not empty.  
  
### qtopcua  
* QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake  
counterpart  
  
Known Issues  
------------  

* Check that your system meets Qt's requirements:  
https://doc.qt.io/qt-6/gettingstarted.html#platform-requirements  
* RTA reported issues from Qt 6.1  
https://qt-project.atlassian.net/issues/?filter=15397  
* Supported development platforms are listed here:  
https://bugreports.qt.io/browse/QTBUG-86432  
  
### Linux
* Minimum glibc version for prebuild binaries is still 2.28, see  
https://bugreports.qt.io/browse/QTBUG-88833.  
Workaround: compile Qt 6.1.2 by yourself or update glibc to 2.28 or newer  
  
### Windows
* Wrong rendering in Dialog with native Windows style  
https://bugreports.qt.io/browse/QTBUG-91755  
    
Credits for the  release goes to:  
---------------------------------  
  
Aavitsland Eirik  
Achtelik Mike  
Agocs Laszlo  
Blomfeldt Eskil Abrahamsen  
Bornemann Joerg  
Boudjelthia Assam  
Buddenhagen Oswald  
Croitor Alexandru  
Curtis Mitch  
D'Angelo Giuseppe  
Edelev Alexey  
Eftevaag Oliver  
Ehrlicher Christian  
Fella Nicolas  
Frantzis Alexandros  
Golubev Andrei  
Haixiang Tang  
Halmet Heikki  
Hartmann Thomas  
Heikkinen Jani  
Hermann Ulf  
Hilsheimer Volker  
Holland Dominik  
Jenssen Tim  
Jokiniva Jukka  
Jung Jaeyoon  
Karlsson Jonas  
Katz Jeremy  
Kittler Marius  
Kleint Friedemann  
Koh Sze Howe  
Koivikko Jarkko  
Korpipaa Tomi  
Kosmale Fabian  
Krus Mike  
Kurazyan Sona  
Kvinge Jonas  
Köhne Kai  
Lemire Paul  
Löhning Robert  
Mutz Marc  
Nishihara Yuya  
Nordheim Mårten  
Pocheptsov Timur  
Qi Liang  
Rocha André de la  
Rutledge Shawn  
Sera Luca Di  
Shao Tianlu  
Shaw Andy  
Shivashankar Venugopal  
Solovev Ivan  
Suzuki Tasuku  
Sæther Jan Arve  
Sørvig Morten Johan  
Tan Tyson  
Tkachenko Ivan  
Trotsenko Alex  
Varanka Sami  
Vertriest Nico  
Vestbø Tor Arne  
Volkov Alexander  
Welbourne Edward  
Wicking Paul  
Xinwei Li  
Zhang JiDe  
