|
1 /**************************************************************************** |
|
2 ** |
|
3 ** Copyright (C) 2009 Nokia Corporation and/or its subsidiary(-ies). |
|
4 ** All rights reserved. |
|
5 ** Contact: Nokia Corporation (qt-info@nokia.com) |
|
6 ** |
|
7 ** This file is part of the documentation of the Qt Toolkit. |
|
8 ** |
|
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 |
|
14 ** this package. |
|
15 ** |
|
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. |
|
23 ** |
|
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. |
|
27 ** |
|
28 ** If you have questions regarding the use of this file, please contact |
|
29 ** Nokia at qt-info@nokia.com. |
|
30 ** |
|
31 ** |
|
32 ** |
|
33 ** |
|
34 ** |
|
35 ** |
|
36 ** |
|
37 ** |
|
38 ** $QT_END_LICENSE$ |
|
39 ** |
|
40 ****************************************************************************/ |
|
41 |
|
42 /*! |
|
43 \page known-issues.html |
|
44 \title Known Issues in %VERSION% |
|
45 \ingroup platform-specific |
|
46 \brief A summary of known issues in Qt %VERSION% at the time of release. |
|
47 |
|
48 This page documents known problems with the packaging and installation in |
|
49 Qt %VERSION%, as well as issues with third party software that we have |
|
50 not been able to work around. For a list of such issues in previous Qt |
|
51 versions refer to this page in the respective documentation. |
|
52 |
|
53 For a list list of known bugs in Qt %VERSION%, see the \l{Task Tracker} |
|
54 on the Qt website. |
|
55 |
|
56 An overview of known issues may also be found at: |
|
57 \l{http://qt.gitorious.org/qt/pages/Qt460BetaKnownIssues} |
|
58 {Known Issues Wiki}. |
|
59 |
|
60 \section1 Installation Issues |
|
61 |
|
62 \section2 Building the Source Package on Windows 7 |
|
63 |
|
64 \list |
|
65 \o When building Qt 4.5.0 with Windows 7, the build fails with an error |
|
66 message regarding failing to embed manifest. This a known issue with |
|
67 Windows 7, explained in the Windows 7 SDK Beta |
|
68 \l{http://download.microsoft.com/download/8/8/0/8808A472-6450-4723-9C87-977069714B27/ReleaseNotes.Htm} |
|
69 {release notes}. A workaround for this issue is to patch the |
|
70 \bold{embed_manifest_exe.prf} file with the following: |
|
71 |
|
72 \code |
|
73 diff --git a/mkspecs/features/win32/embed_manifest_exe.prf b/mkspecs/features/win32/embed_manifest_exe.prf |
|
74 index e1747f1..05f116e 100644 |
|
75 --- a/mkspecs/features/win32/embed_manifest_exe.prf |
|
76 +++ b/mkspecs/features/win32/embed_manifest_exe.prf |
|
77 @@ -8,4 +8,9 @@ if(win32-msvc2005|win32-msvc2008):!equals(TEMPLATE_PREFIX, "vc"):equals(TEMPLATE |
|
78 QMAKE_POST_LINK = $$quote(mt.exe -nologo -manifest \"$$replace(OBJECTS_DIR,/,\\)\\$${NOPATH_TARGET}.intermediate.ma |
|
79 nifest\" -outputresource:$(DESTDIR_TARGET);1$$escape_expand(\n\t)) |
|
80 QMAKE_POST_LINK += $$QMAKE_PREV_POST_LINK |
|
81 QMAKE_CLEAN += \"$$replace(OBJECTS_DIR,/,\\)\\$${NOPATH_TARGET}.intermediate.manifest\" |
|
82 + isEmpty(RC_FILE) { |
|
83 + system("echo.>$$replace(OUT_PWD,/,\\)\\$$replace(OBJECTS_DIR,/,\\)\\Windows7WorkAround.rc") |
|
84 + RC_FILE = $$replace(OUT_PWD,/,\\)\\$$replace(OBJECTS_DIR,/,\\)\\Windows7WorkAround.rc |
|
85 + } |
|
86 + |
|
87 } |
|
88 \endcode |
|
89 |
|
90 \section2 Installing the Source Package on Unix systems |
|
91 |
|
92 \o If you download a Zip source package, you will need to convert |
|
93 Windows-style line endings (CR/LF) to Unix-style line-endings (LF) when |
|
94 you uncompress the package. To do this, give the "-a" option when you |
|
95 run the "unzip' command. |
|
96 |
|
97 If you fail to supply the "-a" option when unzipping the package, you |
|
98 will see the following error message when you attempt to execute the |
|
99 configure command: |
|
100 "bash: ./configure: /bin/sh^M: bad interpreter: No such file or directory" |
|
101 \endlist |
|
102 |
|
103 \section2 Installing on Mac OS X 10.6 "Snow Leopard" |
|
104 \list |
|
105 \o Performing a new install of the Qt 4.6 beta on Snow Leopard |
|
106 triggers a bug in the installer that causes the install to fail. |
|
107 Updating an existing Qt installation works fine. |
|
108 |
|
109 There are two workarounds, either disable spotlight for the target |
|
110 drive during the install, or do a custom install where you deselect |
|
111 documentation and examples. Run the installer again as a full |
|
112 install to get the documentation and examples installed. |
|
113 \endlist |
|
114 |
|
115 \section1 Issues with Third Party Software |
|
116 |
|
117 \section2 X11 |
|
118 |
|
119 \list |
|
120 \o There is a bug in the 169.xx NVIDIA drivers on certain GeForce 8 series |
|
121 cards that is triggered by the OpenGL paint engine when using QPainter |
|
122 on a QGLWidget to draw paths and polygons. Some other painting |
|
123 operations that end up in the path fallback are affected as well. The |
|
124 bug causes the whole X server to repeatedly hang for several seconds at |
|
125 a time. |
|
126 \o There is an issue with NVIDIA's 9xxx driver series on X11 that causes a |
|
127 crash in cases where there are several \l{QGLContext}s and the extended |
|
128 composition modes are used (the composition modes between and including |
|
129 QPainter::CompositionMode_Multiply and |
|
130 QPainter::CompositionMode_Exclusion). This affects the composition mode |
|
131 demo in Qt 4.5, for example. The crash does not occur in newer versions |
|
132 of the drivers. |
|
133 \endlist |
|
134 |
|
135 \section2 Windows |
|
136 |
|
137 \list |
|
138 \o When using version 6.14.11.6921 of the NVIDIA drivers for the GeForce |
|
139 6600 GT under Windows XP, Qt applications which use drag and drop will |
|
140 display reduced size drag and drop icons when run alongside |
|
141 applications that use OpenGL. This problem can be worked around by |
|
142 reducing the level of graphics acceleration provided by the driver, or |
|
143 by disabling hardware acceleration completely. |
|
144 |
|
145 \o With NVIDIA GeForce 7950 GT (driver version 6.14.11.7824), a fullscreen |
|
146 QGLWidget flickers when child widgets are shown/hidden. The workaround |
|
147 for this is to use \l{QWidget::}{setGeometry()} with a width/height 1 |
|
148 pixel bigger than your geometry and call \l{QWidget::}{show()}. |
|
149 |
|
150 \o A bug in the Firebird database can cause an application to crash when |
|
151 \c{fbembed.dll} is unloaded. The bug is fixed in version 2.5. |
|
152 |
|
153 \endlist |
|
154 |
|
155 \section2 Mac OS X |
|
156 |
|
157 \list |
|
158 \o If a sheet is opened for a given window, clicking the title bar of that |
|
159 window will cause it to flash. This behavior has been reported to Apple |
|
160 (bug number 5827676). |
|
161 \endlist |
|
162 */ |