Skip to content
Snippets Groups Projects
qtcreator.qdoc 268 KiB
Newer Older
con's avatar
con committed
    \table
        \header
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Action
            \o Keyboard shortcut
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Open file or project
            \o Ctrl+O
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o New file or project
            \o Ctrl+N
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Open in external editor
            \o Alt+V, Alt+I
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Cut
            \o Ctrl+X
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Copy
            \o Ctrl+C
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Paste
            \o Ctrl+V
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Redo
            \o Ctrl+Y
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Save
            \o Ctrl+S
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Save all
            \o Ctrl+A
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Close window
            \o Ctrl+W
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Close all
            \o Ctrl+Shift+W
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Go back
            \o Alt+Left
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Go forward
            \o Alt+Right
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Go to line
            \o Ctrl+L
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Next open document in history
            \o Ctrl+Shift+Tab
        \row
            \o Goto other split
            \o Ctrl+E, O
        \row
            \o Previous open document in history
            \o Ctrl+Tab
        \row
            \o Activate \gui Locator
            \o Ctrl+K
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Switch to \gui Welcome mode
            \o Ctrl+1
        \row
            \o Switch to \gui Edit mode
            \o Ctrl+2
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Ctrl+3
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Ctrl+4
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Ctrl+5
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Ctrl+6
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Alt+1 (Cmd+1 on Mac OS X)
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Alt+2 (Cmd+2 on Mac OS X)
con's avatar
con committed
        \row
            \o Toggle \gui{Application Output} pane
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Alt+3 (Cmd+3 on Mac OS X)
con's avatar
con committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Alt+4 (Cmd+4 on Mac OS X)
        \row
            \o Activate \gui Bookmarks pane
            \o Alt+M
        \row
            \o Activate \gui{File System} pane
            \o Alt+Y
        \row
            \o Activate \gui{Open Documents} pane
            \o Alt+O
        \row
            \o Activate \gui Projects pane
            \o Alt+X
        \row
            \o Full screen
            \o Ctrl+Shift+F11
        \row
            \o Toggle the sidebar
            \o Alt+0 (Cmd+0 on Mac OS X)
        \row
            \o Undo
            \o Ctrl+Z
        \row
            \o Move to \gui Edit mode

               In \gui Edit mode:
               \list
                \o The first press moves focus to the editor
                \o The second press closes secondary windows
               \endlist
            \o Esc
con's avatar
con committed
    \endtable
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

    \section2 Editing Keyboard Shortcuts
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

    \table
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \header
            \o Action
            \o Keyboard shortcut
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Auto-indent selection
            \o Ctrl+I
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Collapse
            \o Ctrl+<
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Expand
            \o Ctrl+>
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Trigger a completion in this scope
            \o Ctrl+Space
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Copy line down
            \o Ctrl+Alt+Down
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Copy line up
            \o Ctrl+Alt+Up
        \row
            \o Cut line
            \o Shift+Del
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Decrease font size
            \o Ctrl+- (Ctrl+Roll mouse wheel down)
        \row
            \o Increase font size
            \o Ctrl++ (Ctrl+Roll mouse wheel up)
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Alt+V, Alt+V
        \row
            \o Split
            \o Ctrl+E, 2
        \row
            \o Split side by side
            \o Ctrl+E, 3
        \row
            \o Remove all splits
            \o Ctrl+E, 1
        \row
            \o Remove current split
            \o Ctrl+E, 0
        \row
            \o Select all
            \o Ctrl+A
        \row
            \o Go to block end
            \o Ctrl+]
        \row
            \o Go to block start
            \o Ctrl+[
        \row
            \o Go to block end with selection
            \o Ctrl+}
        \row
            \o Go to block start with selection
            \o Ctrl+{
        \row
            \o Move current line down
            \o Ctrl+Shift+Down
        \row
            \o Move current line up
            \o Ctrl+Shift+Up
        \row
            \o Trigger a quick fix in this scope
            \o Alt+Return
        \row
            \o Rewrap paragraph
            \o Ctrl+E, R
        \row
            \o Select the current block
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
               The second press extends the selection to the parent block
            \o Ctrl+U
        \row
            \o Enable text wrapping
            \o Ctrl+E, Ctrl+W
        \row
            \o Toggle comment for selection
            \o Ctrl+/
        \row
            \o Visualize whitespace
            \o Ctrl+E, Ctrl+V
        \row
            \o Delete
            \o Del
        \row
            \o Adjust size
            \o Ctrl+J
        \row
            \o Lay out in a grid
            \o Ctrl+G
        \row
            \o Lay out horizontally
            \o Ctrl+H
        \row
            \o Lay out vertically
            \o Ctrl+L
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Preview
            \o Ctrl+Alt+R
        \row
            \o Edit signals and slots
            \o F4
        \row
            \o Edit widgets
            \o F3
        \row
            \o Toggle bookmark
            \o Ctrl+M
        \row
            \o Go to next bookmark
            \o Ctrl+.
        \row
            \o Go to previous bookmark
            \o Ctrl+,
        \row
            \o Fetch snippet
            \o Alt+C, Alt+F
        \row
            \o Paste snippet
            \o Alt+C, Alt+P
        \row
            \o Find usages
            \o Ctrl+Shift+U
        \row
            \o Follow symbol under cursor
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
               Works with namespaces, classes, methods, variables, include
               statements and macros
            \o F2
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Rename symbol under cursor
            \o Ctrl+Shift+R
        \row
            \o Switch between method declaration and definition
            \o Shift+F2
        \row
            \o Switch between header and source file
            \o F4
    \endtable

    \section2 Debugging Keyboard Shortcuts
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \table
        \header
            \o Action
            \o Keyboard shortcut
        \row
            \o Start debugging
            \o F5
        \row
            \o Stop or interrupt debugger
            \o Shift+F5
        \row
            \o Reset debugger
            \o Ctrl+Shift+F5
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Step over
            \o F10
        \row
            \o Step into
            \o F11
        \row
            \o Step out
            \o Shift+F11
        \row
            \o Toggle breakpoint
            \o F9
    \endtable


    \section2 Project Keyboard Shortcuts
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \table
        \header
            \o Action
            \o Keyboard shortcut
        \row
            \o Build project
            \o Ctrl+B
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
            \o Build all
            \o Ctrl+Shift+B
        \row
            \o New project
            \o Ctrl+Shift+N
        \row
            \o Run
            \o Ctrl+R
    \endtable
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

    \section2 Help Keyboard Shortcuts

    \table
        \header
            \o Action
            \o Keyboard shortcut
        \row
            \o View context-sensitive help
            \o F1
        \row
            \o Activate contents in \gui Help mode
            \o Ctrl+T
        \row
            \o Add bookmark in \gui Help mode
            \o Ctrl+M
        \row
            \o Activate index in \gui Help mode
            \o Ctrl+I
        \row
            \o Reset font size in \gui Help mode
            \o Ctrl+0
        \row
            \o Activate search in \gui Help mode
            \o Ctrl+S
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \endtable

Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

    \section2 Version Control Keyboard Shortcuts

    \table
        \header
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \header
            \o CVS
            \o Git
            \o Perforce
            \o Subversion
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Add
            \o Alt+C, Alt+A
            \o Alt+G, Alt+A
            \o
            \o Alt+S, Alt+A
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Commit
            \o Alt+C, Alt+C
            \o Alt+G, Alt+C
            \o
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Diff
            \o Alt+C, Alt+D
            \o Alt+G, Alt+D
            \o
            \o Alt+S, Alt+D
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Diff project
            \o
            \o Alt+G, Alt+Shift+D
            \o Alt+P, Alt+D
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Blame
            \o
            \o Alt+G, Alt+B
            \o
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Log
            \o
            \o Alt+G, Alt+L
            \o Alt+P, Alt+F
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Log project
            \o
            \o Alt+G, Alt+K
            \o
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Status
            \o
            \o Alt+G, Alt+S
            \o
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Undo changes
            \o
            \o Alt+G, Alt+U
            \o
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Diff project
            \o
            \o Alt+G, Alt+Shift+D
            \o Alt+P, Alt+D
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Edit
            \o
            \o
            \o Alt+P, Alt+E
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Opened
            \o
            \o
            \o Alt+P, Alt+O
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Revert
            \o
            \o
            \o Alt+P, Alt+R
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
        \row
            \o Submit
            \o
            \o
            \o Alt+P, Alt+S
            \o
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \endtable
con's avatar
con committed
*/

con's avatar
con committed
/*!
    \contentspage index.html
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \previouspage creator-known-issues.html
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \nextpage creator-acknowledgements.html
                Qt&nbsp;in&nbsp;PATH
            \o  This is the Qt
                version for the \c qmake command found in your \c PATH
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
                environment variable.
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
                This is likely to be the system's Qt version.
Leena Miettinen's avatar
Leena Miettinen committed
            \o  The version of Qt configured in the \gui{Projects} mode, \gui {Build
                Settings}, \gui {Qt Version} field. This is the Qt version that
                is actually used by a particular project.
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
                Shadow&nbsp;build
                \endraw
                \target glossary-shadow-build
            \o  Shadow building means building a project in a separate
                directory, the \e{build directory}. The build directory is
                different from the source directory. One of the benefits of
                shadow building is that it keeps your source directory clean.
                Shadow building is the best practice if you need many build
                configurations for a single set of source.
    \endtable

*/


/*!
    \contentspage index.html
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \previouspage creator-keyboard-shortcuts.html
con's avatar
con committed
    \page creator-known-issues.html
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \nextpage creator-glossary.html
con's avatar
con committed

    \title Known Issues

    This section lists known issues in Qt Creator version 2.0.0.
    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
    the \c{qtcreator\dist} folder or the \l{http://bugreports.qt.nokia.com}{Qt Bug Tracker}.

        \o Qt Creator uses SQLite for storing some of its settings. SQLite is
           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.

    \endlist

    \section1 Editing

    \list

        \o Code completion does not support typedefs for nested classes.

con's avatar
con committed

    \list
        \o Paths or file names containing spaces or special characters, e.g.,
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
           colons, dollar signs, hash marks etc. may cause problems. This
           is because some of the tools Qt Creator uses in the background have
           restrictions on the characters allowed in file and directory names.
Thorbjørn Lindeijer's avatar
Thorbjørn Lindeijer committed
           To be on the safe side, we recommend creating projects and project
           items with names consisting of plain characters, numbers,
           underscores, and hyphens.
con's avatar
con committed

        \o There is no IDE support for adding/removing sub-projects. Project
           hierarchies (SUBDIRS template) have to be created manually.
con's avatar
con committed

        \o Creating new \c CMake projects with Qt Creator is not supported.

        \o Building and packaging sub-projects is not supported for Maemo devices.

        \o You must create projects for Maemo targets on the same partition where
        you installed Nokia Qt SDK, Qt Creator, and MADDE.

con's avatar
con committed

        \o When debugging executables created by the GNU Compiler version 4.5.0
           (all platforms), some data types will not be displayed in the
           \gui{Locals and Watchers} view due to missing debug information.
        \o On Windows, debugging a MinGW-built console application (with \gui{Run in terminal}
           checked) using gdb does not work due to a bug in gdb related to attaching to
           stopped processes (see \l{http://bugreports.qt.nokia.com/browse/QTCREATORBUG-1020}).
        \o Gdb on Windows may not work if the 'Embassy \reg Security Center' software
           by 'Wave \reg Systems' is installed and active (causing crashes in \c{vxvault.dll)}).
        \o Gdb may take long to load debugging symbols, especially from large
           libraries like \c libQtWebKit. Starting the debugging module can
           take up to several minutes without visible progress.
        \o Setting breakpoints in code that is compiled into the binary more
           than once does not work.

        \o Setting breakpoints in files that do not have unique absolute
           paths may fail. For example, remounting parts of a file system
           using the --bind mount option.
con's avatar
con committed
    \endlist
Oswald Buddenhagen's avatar
Oswald Buddenhagen committed

con's avatar
con committed
*/

Oswald Buddenhagen's avatar
Oswald Buddenhagen committed
    \previouspage creator-glossary.html
    \page creator-acknowledgements.html

    \title Acknowledgements

    \section1 Third-party Components

    Qt Creator contains the following third-party components:

    \list
    \o  \bold{Open Source front-end for C++ (license MIT)}, enhanced for use in
        Qt Creator.\br
        Roberto Raggi <roberto.raggi@gmail.com>\br
        QtCreator/src/shared/cplusplus\br\br

    \o  \bold{Botan, a C++ crypto library. Version 1.8.8}\br
        \list
        \o  Copyright (C) 1999-2004 The Botan Project. All rights reserved.
        \o  Copyright (C) 1999-2009 Jack Lloyd
        \o  2001 Peter J Jones
        \o  2004-2007 Justin Karneges
        \o  2005 Matthew Gregan
        \o  2005-2006 Matt Johnston
        \o  2006 Luca Piccarreta
        \o  2007 Yves Jerschow
        \o  2007-2008 FlexSecure GmbH
        \o  2007-2008 Technische Universitat Darmstadt
        \o  2007-2008 Falko Strenzke
        \o  2007-2008 Martin Doering
        \o  2007 Manuel Hartl
        \o  2007 Christoph Ludwig
        \o  2007 Patrick Sona
        \endlist
        All rights reserved.\br\br

        Redistribution and use in source and binary forms, with or without
        modification, are permitted provided that the following conditions are
        met:\br\br

        1. Redistributions of source code must retain the above copyright
        notice, this list of conditions, and the following disclaimer.\br\br

        2. Redistributions in binary form must reproduce the above copyright
        notice, this list of conditions, and the following disclaimer in the
        documentation and/or other materials provided with the distribution.\br
        \br

        THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) "AS IS" AND ANY EXPRESS OR
        IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
        WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE,
        ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) OR CONTRIBUTOR(S) BE
        LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
        CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
        SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
        BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
        WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
        OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN
        IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.\br\br
        The source code of Botan C++ crypto library can be found
        here:
        \list
        \o QtCreator/src/libs/3rdparty
        \o \l{http://qt.gitorious.org/qt-creator/qt-creator/trees/master/src/libs/3rdparty}
        \endlist
        \br\br

    \o  \bold{NetSieben SSH Library is a Secure Shell client library for C++.
         Version 1.3.2}\br
        \list
        \o \bold{Commercial License:} For organizations who do not want to
            release the source code for their applications as open source/
            free software; in other words they do not want to comply with the
            GNU General Public License (GPL) or Q Public License.
        \o \bold{Non Commercial / Open Source License:} NetSieben believes in
            contributing back to the open source community, thus it has released
            the SSH Library under Q Public License as it is defined by Trolltech
            AS of Norway. The Open Source License allows the user to use software
            under an open source / free software license, and distribute it
            freely. The software can be used at no charge with the condition
            that if the user uses the SSH Library in an application they wish to
            redistribute, then the complete source code for your application must
            be available and freely redistributable under reasonable conditions.
            For more information on the used QPL License see:
            QtCreator/src/libs/3rdparty/net7ssh/LICENSE.QPL
        \endlist\br\br
        The source code of NetSieben Secure Shell C++ Library can be found
        here:
        \list
        \o QtCreator/src/libs/3rdparty
        \o \l{http://qt.gitorious.org/qt-creator/qt-creator/trees/master/src/libs/3rdparty}