1 /****************************************************************************
3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies).
4 ** All rights reserved.
5 ** Contact: Nokia Corporation (qt-info@nokia.com)
7 ** This file is part of the documentation of the Qt Toolkit.
9 ** $QT_BEGIN_LICENSE:LGPL$
10 ** No Commercial Usage
11 ** This file contains pre-release code and may not be distributed.
12 ** You may use this file in accordance with the terms and conditions
13 ** contained in the Technology Preview License Agreement accompanying
16 ** GNU Lesser General Public License Usage
17 ** Alternatively, this file may be used under the terms of the GNU Lesser
18 ** General Public License version 2.1 as published by the Free Software
19 ** Foundation and appearing in the file LICENSE.LGPL included in the
20 ** packaging of this file. Please review the following information to
21 ** ensure the GNU Lesser General Public License version 2.1 requirements
22 ** will be met: http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
24 ** In addition, as a special exception, Nokia gives you certain additional
25 ** rights. These rights are described in the Nokia Qt LGPL Exception
26 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
28 ** If you have questions regarding the use of this file, please contact
29 ** Nokia at qt-info@nokia.com.
40 ****************************************************************************/
43 \page known-issues.html
44 \title Known Issues in %VERSION%
45 \ingroup platform-notes
46 \brief A summary of known issues in Qt %VERSION% at the time of release.
48 An up-to-date list of known issues with Qt %VERSION% can be found via the
49 \l{Task Tracker} on the Qt website which provides additional information
50 about known issues and tasks related to Qt.
52 \section1 General Issues
54 When running Qt applications on Windows or with \c{-graphicssystem raster},
55 any process that triggers a QWidget::update() from within a destructor
56 might result in a crash.
59 \section1 Issues with Third Party Software
61 \section2 X11 Hardware Support
64 \o There is a bug in the 169.xx NVIDIA drivers on certain GeForce 8 series
65 cards that is triggered by the OpenGL paint engine when using QPainter
66 on a QGLWidget to draw paths and polygons. Some other painting
67 operations that end up in the path fallback are affected as well. The
68 bug causes the whole X server to repeatedly hang for several seconds at
70 \o There is an issue with NVIDIA's 9xxx driver series on X11 that causes a
71 crash in cases where there are several \l{QGLContext}s and the extended
72 composition modes are used (the composition modes between and including
73 QPainter::CompositionMode_Multiply and
74 QPainter::CompositionMode_Exclusion). This affects the composition mode
75 demo in Qt 4.5, for example. The crash does not occur in newer versions
79 \section2 Windows Hardware Support
82 \o When using version 6.14.11.6921 of the NVIDIA drivers for the GeForce
83 6600 GT under Windows XP, Qt applications which use drag and drop will
84 display reduced size drag and drop icons when run alongside
85 applications that use OpenGL. This problem can be worked around by
86 reducing the level of graphics acceleration provided by the driver, or
87 by disabling hardware acceleration completely.
90 \section2 Windows Software Issues
94 \o When building Qt 4.5.0 with Windows 7, the build fails with an error
95 message regarding failing to embed manifest. This a known issue with
96 Windows 7, explained in the Windows 7 SDK Beta
97 \l{http://download.microsoft.com/download/8/8/0/8808A472-6450-4723-9C87-977069714B27/ReleaseNotes.Htm}
98 {release notes}. A workaround for this issue is to patch the
99 \bold{embed_manifest_exe.prf} file with the following:
102 diff --git a/mkspecs/features/win32/embed_manifest_exe.prf b/mkspecs/features/win32/embed_manifest_exe.prf
103 index e1747f1..05f116e 100644
104 --- a/mkspecs/features/win32/embed_manifest_exe.prf
105 +++ b/mkspecs/features/win32/embed_manifest_exe.prf
106 @@ -8,4 +8,9 @@ if(win32-msvc2005|win32-msvc2008):!equals(TEMPLATE_PREFIX, "vc"):equals(TEMPLATE
107 QMAKE_POST_LINK = $$quote(mt.exe -nologo -manifest \"$$replace(OBJECTS_DIR,/,\\)\\$${NOPATH_TARGET}.intermediate.ma
108 nifest\" -outputresource:$(DESTDIR_TARGET);1$$escape_expand(\n\t))
109 QMAKE_POST_LINK += $$QMAKE_PREV_POST_LINK
110 QMAKE_CLEAN += \"$$replace(OBJECTS_DIR,/,\\)\\$${NOPATH_TARGET}.intermediate.manifest\"
112 + system("echo.>$$replace(OUT_PWD,/,\\)\\$$replace(OBJECTS_DIR,/,\\)\\Windows7WorkAround.rc")
113 + RC_FILE = $$replace(OUT_PWD,/,\\)\\$$replace(OBJECTS_DIR,/,\\)\\Windows7WorkAround.rc
119 \o Under certain circumstances Visual Studio Integration v1.4.0 will not
120 be able to install the integration for Visual Studio 2005 on Windows
121 Vista. An error message states that .NET Framework v2.0 Service Pack 1
122 is not installed. This is due to a problem with the built-in
123 installation of this on Windows Vista. This issue can be fixed by
124 installing .NET Framework version 3.5.
126 \o With NVIDIA GeForce 7950 GT (driver version 6.14.11.7824), a fullscreen
127 QGLWidget flickers when child widgets are shown/hidden. The workaround
128 for this is to use \l{QWidget::}{setGeometry()} with a width/height 1
129 pixel bigger than your geometry and call \l{QWidget::}{show()}.
131 \o A bug in the Firebird database can cause an application to crash when
132 \c{fbembed.dll} is unloaded. The bug is fixed in version 2.5.
136 \section2 Mac OS X Software Support
139 \o If a sheet is opened for a given window, clicking the title bar of that
140 window will cause it to flash. This behavior has been reported to Apple
141 (bug number 5827676).