doc/src/known-issues.qdoc

   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-notes
  46     \brief A summary of known issues in Qt %VERSION% at the time of release.
  47
  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.
  51
  52     \section1 General Issues
  53
  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.
  57
  58
  59     \section1 Issues with Third Party Software
  60
  61     \section2 X11 Hardware Support
  62
  63     \list
  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
  69         a time.
  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
  76         of the drivers.
  77     \endlist
  78
  79     \section2 Windows Hardware Support
  80
  81     \list
  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.
  88     \endlist
  89
  90     \section2 Windows Software Issues
  91
  92     \list
  93
  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:
 100
 101         \code
 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\"
 111         +    isEmpty(RC_FILE) {
 112         +        system("echo.>$$replace(OUT_PWD,/,\\)\\$$replace(OBJECTS_DIR,/,\\)\\Windows7WorkAround.rc")
 113         +        RC_FILE = $$replace(OUT_PWD,/,\\)\\$$replace(OBJECTS_DIR,/,\\)\\Windows7WorkAround.rc
 114         +       }
 115         +
 116          }
 117         \endcode
 118
 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.
 125
 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()}.
 130
 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.
 133
 134     \endlist
 135
 136     \section2 Mac OS X Software Support
 137
 138     \list
 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).
 142     \endlist
 143 */