← Back to branch summary

~oif-team/ubuntu/natty/qt4-x11/xi2.1

« back to all changes in this revision

Viewing changes to doc/src/getting-started/known-issues.qdoc

  • Committer: Bazaar Package Importer
  • Author(s): Alessandro Ghersi
  • Date: 2009-11-02 18:30:08 UTC
  • mfrom: (1.2.2 upstream)
  • mto: (15.2.5 experimental)
  • mto: This revision was merged to the branch mainline in revision 88.
  • Revision ID: james.westby@ubuntu.com-20091102183008-b6a4gcs128mvfb3m
Tags: upstream-4.6.0~beta1
Import upstream version 4.6.0~beta1

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/src/getting-started/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 4.6.0
 
45
    \ingroup platform-specific
 
46
    \brief A summary of known issues in Qt 4.6.0 at the time of release.
 
47
 
 
48
    This page documents known problems with the packaging and installation in
 
49
    Qt 4.6.0, 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 4.6.0, 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
*/