creator-issues.qdoc 5.68 KB
Newer Older
1 2
/****************************************************************************
**
3
** Copyright (c) 2014 Digia Plc and/or its subsidiary(-ies).
hjk's avatar
hjk committed
4
** Contact: http://www.qt-project.org/legal
5
**
hjk's avatar
hjk committed
6
** This file is part of Qt Creator
7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25
**
**
** GNU Free Documentation License
**
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of this
** file.
**
**
****************************************************************************/

// **********************************************************************
// NOTE: the sections are not ordered by their logical order to avoid
// reshuffling the file each time the index order changes (i.e., often).
// Run the fixnavi.pl script to adjust the links to the index order.
// **********************************************************************

/*!
26
    \contentspage {Qt Creator Manual}
27 28
    \previouspage creator-tips.html
    \page creator-known-issues.html
29
    \nextpage creator-glossary.html
30 31 32 33 34 35 36 37

    \title Known Issues

    This section lists known issues in \QC version \qtcversion. The development
    team is aware of them, and therefore, you do not need to report them as
    bugs.

    For a list of fixed issues and added features, see the changelog file in
38
    the \c{qtcreator\dist} folder or the \l{http://bugreports.qt-project.org}
39 40 41 42 43 44
    {Qt Bug Tracker}.

    \section1 General Issues

    \list

45
        \li  If you change the Input Languages in Windows, \QC might not
46 47 48
            respond for 30 seconds. This is a known issue in the Advanced Text
            Service of Microsoft Windows.

49
        \li  \QC uses SQLite for storing some of its settings. SQLite is
50 51 52 53 54 55 56
            known to have problems with certain NFS servers (most notably the
            nfs-user-server 2.2beta), since they can lock up the application
            when it tries to lock the database. If your home directory is on an
            NFS share and you encounter this issue, one option would be to
            switch to the nfs-kernel-server, or create a symlink so that the
            settings are stored locally.

57
        \li  Qt 4.7.4 is known to contain a bug exposed by g++ 4.6 which triggers
58
            a crash in \QC. For more information, see
59
            \l{http://bugreports.qt-project.org/browse/QTBUG-21265}{QTBUG-21265}
60

61
        \li  The Okteta KDE custom widget plugin might be installed as part of
62 63 64 65 66
            some Linux distributions. It can cause Qt Designer to crash. For
            more information, see:

            \list

67
                \li  \l{http://bugs.launchpad.net/ubuntu/+source/kdeutils/+bug/662005}
68 69
                    {Ubuntu bug 662005}

70
                \li  \l{http://bugreports.qt-project.org/browse/QTBUG-12025}
71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
                    {QTBUG-12025}

           \endlist

            To resolve the issue, enter the following command to remove the
            package:
            \code
            sudo apt-get remove okteta
            \endcode
            Or delete the following file:
            \c /usr/lib/kde4/plugins/designer/oktetadesignerplugin.so.

    \endlist

    \section1 Editing Issues

    \list

89
        \li Code completion does not support typedefs for nested classes.
90 91 92 93 94 95 96

    \endlist

    \section1 Projects Issues

    \list

97
        \li  Paths or file names containing spaces or special characters
98 99 100 101 102 103 104
            (such as colons, dollar signs, and hash marks) may cause problems.
            This is because some of the tools \QC uses in the background have
            restrictions on the characters allowed in file and directory names.
            To be on the safe side, we recommend creating projects and project
            items with names consisting of plain characters, numbers,
            underscores, and hyphens.

105
        \li  Creating new CMake projects with \QC is not supported.
106

107
        \li  If error messages displayed in the \gui {Compile Output} pane contain
108 109 110 111 112 113 114 115 116 117
            paths where slashes are missing (for example, C:QtSDK),
            check your PATH variable. For more information, see
            \l{Troubleshooting MinGW Compilation Errors}.

    \endlist

    \section1 Debugging Issues

    \list

118
        \li  When debugging executables created by the GNU Compiler version 4.5.0
119 120 121
            (all platforms), some data types will not be displayed in the
            \gui{Locals and Expressions} view due to missing debug information.

122
        \li  GDB on Windows may not work if the 'Embassy \reg Security Center'
123 124 125
            software by 'Wave \reg Systems' is installed and active (causing
            crashes in \c{vxvault.dll)}).

126
        \li  GDB may take long to load debugging symbols, especially from large
127 128
            libraries.

129
        \li  Setting breakpoints in code that is compiled into the binary more
130 131
            than once does not work.

132
        \li  Setting breakpoints in files that do not have unique absolute
133 134 135
            paths may fail. For example, remounting parts of a file system
            using the --bind mount option.

136
        \li  A regression in GCC 4.5.0 causes return value optimization to
Leena Miettinen's avatar
Leena Miettinen committed
137 138 139
            produce inaccurate debug info that GCC applies also to
            non-optimized builds. For more information, see
            \l{http://gcc.gnu.org/bugzilla/show_bug.cgi?id=44731}
140
            {GCC Bugzilla - Bug 44731}.
Leena Miettinen's avatar
Leena Miettinen committed
141

142 143 144 145 146 147
    \endlist

    \section1 Qt Quick Designer Issues

    \list

148
        \li  \QMLD uses a QML emulation layer (QML Puppet) to render and preview
149
            images and to collect data. Executing C++ code might cause the QML
150
            emulation layer to crash. If it crashes, an error message is displayed and
151 152 153 154
            you can continue editing the QML file in the code editor.

    \endlist
*/