doc/src/getting-started/known-issues.qdoc
changeset 7 f7bc934e204c
equal deleted inserted replaced
3:41300fa6a67c 7:f7bc934e204c
       
     1 /****************************************************************************
       
     2 **
       
     3 ** Copyright (C) 2010 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     An up-to-date list of known issues with Qt %VERSION% can be found via the
       
    49     \l{http://bugreports.qt.nokia.com/}{Qt Bug Tracker}.
       
    50 
       
    51     For a list list of known bugs in Qt %VERSION%, see the \l{Task Tracker}
       
    52     on the Qt website.
       
    53 
       
    54     An overview of known issues may also be found at:
       
    55     \l{http://qt.gitorious.org/qt/pages/QtKnownIssues}
       
    56     {Known Issues Wiki}.
       
    57 
       
    58     \section1 Installation Issues
       
    59 
       
    60     \section2 Installing the Source Package on Unix systems
       
    61 
       
    62     \list
       
    63 
       
    64     \o  If you download a Zip source package, you will need to convert
       
    65         Windows-style line endings (CR/LF) to Unix-style line-endings (LF) when
       
    66         you uncompress the package.  To do this, give the "-a" option when you
       
    67         run the "unzip' command.
       
    68 
       
    69     \o  If you fail to supply the "-a" option when unzipping the package, you
       
    70         will see the following error message when you attempt to execute the
       
    71         configure command:
       
    72         "bash: ./configure: /bin/sh^M: bad interpreter: No such file or directory"
       
    73 
       
    74     \endlist
       
    75 
       
    76     \section2 Installing on Mac OS X 10.6 "Snow Leopard"
       
    77 
       
    78     \list
       
    79 
       
    80     \o Performing a new install of the Qt 4.6 beta on Snow Leopard
       
    81        triggers a bug in the installer that causes the install to fail.
       
    82        Updating an existing Qt installation works fine.
       
    83 
       
    84     \o There are two workarounds, either disable spotlight for the target
       
    85        drive during the install, or do a custom install where you deselect
       
    86        documentation and examples. Run the installer again as a full
       
    87        install to get the documentation and examples installed.
       
    88 
       
    89     \endlist
       
    90 
       
    91     \section1 Issues with Third Party Software
       
    92 
       
    93     \section2 X11
       
    94 
       
    95     \list
       
    96     \o  There is a bug in the 169.xx NVIDIA drivers on certain GeForce 8 series
       
    97         cards that is triggered by the OpenGL paint engine when using QPainter
       
    98         on a QGLWidget to draw paths and polygons. Some other painting
       
    99         operations that end up in the path fallback are affected as well. The
       
   100         bug causes the whole X server to repeatedly hang for several seconds at
       
   101         a time.
       
   102     \o  There is an issue with NVIDIA's 9xxx driver series on X11 that causes a
       
   103         crash in cases where there are several \l{QGLContext}s and the extended
       
   104         composition modes are used (the composition modes between and including
       
   105         QPainter::CompositionMode_Multiply and
       
   106         QPainter::CompositionMode_Exclusion). This affects the composition mode
       
   107         demo in Qt 4.5, for example. The crash does not occur in newer versions
       
   108         of the drivers.
       
   109     \endlist
       
   110 
       
   111     \section2 Windows
       
   112 
       
   113     \list
       
   114 
       
   115     \o  When using version 6.14.11.6921 of the NVIDIA drivers for the GeForce
       
   116         6600 GT under Windows XP, Qt applications which use drag and drop will
       
   117         display reduced size drag and drop icons when run alongside
       
   118         applications that use OpenGL. This problem can be worked around by
       
   119         reducing the level of graphics acceleration provided by the driver, or
       
   120         by disabling hardware acceleration completely.
       
   121 
       
   122     \o  With NVIDIA GeForce 7950 GT (driver version 6.14.11.7824), a fullscreen
       
   123         QGLWidget flickers when child widgets are shown/hidden. The workaround
       
   124         for this is to use \l{QWidget::}{setGeometry()} with a width/height 1
       
   125         pixel bigger than your geometry and call \l{QWidget::}{show()}.
       
   126 
       
   127     \o  A bug in the Firebird database can cause an application to crash when
       
   128         \c{fbembed.dll} is unloaded. The bug is fixed in version 2.5.
       
   129 
       
   130     \o  On Windows 7, resizing windows is slower than on Vista/Xp. This is because
       
   131         the gesture initialization process (required for native gesture support)
       
   132         currently calls winId() on widgets, which causes whole widget hierarchies
       
   133         to use native window handles. This slows down resizing.
       
   134 
       
   135     \o  Compile errors with Intel C++ Compiler.\br
       
   136         There seems to be a bug in the Intel compiler with respect to
       
   137         over-agressive inlining of code.
       
   138         The problem will manifest itself during the link phase of QtGui where
       
   139         it fails with the error that it cannot find QObjectData::~QObjectData().
       
   140         See \l{http://bugreports.qt.nokia.com/browse/QTBUG-5145} for updates on this
       
   141         bug.
       
   142         Also, due to some bugs in WebKit, the QtScript and QtWebKit modules
       
   143         will not compile.
       
   144         See \l{http://bugreports.qt.nokia.com/browse/QTBUG-6297} for a
       
   145         workaround for QtScript.
       
   146         
       
   147     \endlist
       
   148 
       
   149     \section2 Mac OS X
       
   150 
       
   151     \list
       
   152 
       
   153     \o  If a sheet is opened for a given window, clicking the title bar of that
       
   154         window will cause it to flash. This behavior has been reported to Apple
       
   155         (bug number 5827676).
       
   156 
       
   157     \endlist
       
   158 
       
   159     \section2 Symbian
       
   160 
       
   161     \list
       
   162     \o  Check known issues for Symbian at
       
   163     \l{http://qt.gitorious.org/qt/pages/QtKnownIssues} {Known Issues Wiki}.
       
   164     \endlist
       
   165 */