Merge branch '0.9.1-beta' of git@scm.dev.nokia.troll.no:creator/mainline into 0.9.1-beta

doc/qtcreator.qdoc

@@ -33,8 +33,8 @@
         \o \bold{Qt Designer Integration}: User interface forms can be designed
            within Qt Creator. Simply double-click on a \c{.ui} file within the
            \gui{Project Explorer} to launch the integration.
-        \o \bold{Navigation tools}: Powerful navigation tools let the user
+        \o \bold{Locator}: A powerful navigation tool that lets the user locate
-           navigate around files and classes with minimal keystrokes.
+           files and classes using minimal keystrokes.
         \o \bold{Support for qmake's .pro file format}: The project's \c{.pro}
            file is used as a project description file.
         \o \bold{Debugging Interface to GDB}: Applications can be debugged
@@ -50,7 +50,7 @@
        \o \l{Creating a Project in Qt Creator}
        \o \l{Build Settings}
        \o \l{Writing a Simple Program with Qt Creator}
-       \o \l{Navigating Quickly Around Your Code}
+       \o \l{Navigating Quickly Around Your Code with Locator}
        \o \l{Debugging with Qt Creator}
        \o \l{Tips and Tricks}
        \o \l{Glossary}
@@ -114,7 +114,7 @@
 
     The task pane in Qt Creator can display one of four different panes:
     \gui{Build Issues}, \gui{Search Results}, \gui{Application Output}, and
-    \gui{Compile}. These panes are available in all modes.
+    \gui{Compile Output}. These panes are available in all modes.
 
     \section2 Build Issues
 
@@ -142,8 +142,8 @@
 
     \section2 Compile
 
-    The \gui{Compile} pane provides all the output from the compiler. In other
+    The \gui{Compile Output} pane provides all the output from the compiler. In
-    words, it is a more verbose version of information displayed in the
+    other words, it is a more verbose version of information displayed in the
     \gui{Build Issues}
 
     \image qtcreator-compile-pane.png
@@ -168,17 +168,19 @@
     Qt Creator is fully integrated with Qt Designer to help you design user
     interface forms just like you would with the standalone version. The Qt
     Designer integration also includes project management and code completion.
+    For more information on Qt Designer, you can refer to
+    \l{The Designer Manual}.
 
     \image qtcreator-formedit.png
 
 
     \section1 Keyboard Navigation
    
-    Even though Qt Creator can be used with a mouse, it also caters to the
+    Qt Creator caters not only to developers who are used to using the mouse,
-    needs of developers who are more comfortable with the keyboard. A wide
+    but also to developers who are more comfortable with the keyboard. A wide
-    range of \l{keyboard-shortcuts}{keyboard} and \l{Quick Navigation}
+    range of \l{keyboard-shortcuts}{keyboard} and
-    {navigation} shortcuts are available to help speed up the process of
+    \l{Navigating Quickly Around Your Code with Locator}{navigation} shortcuts
-    developing your application.
+    are available to help speed up the process of developing your application.
 */
 
 /*!
@@ -191,19 +193,19 @@
 
     \table
         \row
-            \i \bold{Warning:} Qt Creator currently supports qmake only.
+            \i \note Qt Creator currently supports \c qmake only. \c Makefile
-               Makefile and CMake support is not yet available.
+               and \c CMake support is currently unavailable.
     \endtable
 
-    To modify the build settings of your project, switch to the
+    To modify the build settings of your project, switch to the \gui{Projects}
-    \gui{Build & Run} mode using the mouse or by pressing \key{Ctrl+4}.
+    mode using the mouse or with \key{Ctrl+4}.
 
     \image qtcreator-buildsettings.png
 
     Action items to create, clone, or delete build configurations can be found
-    on the right of the dialog. You can have as many build configurations
+    on the right of the dialog. You can have as many build configurations as
-    as you need. By default Qt Creator creates a \bold{debug} and
+    needed. By default Qt Creator creates a \bold{debug} and \bold{release}
-    \bold{release} build configuration. Both these configurations use the
+    build configuration. Both these configurations use the
     \l{glossary-default-qt}{Default Qt Version}.
 
     In the tree on the left, a list of build configurations and their settings
@@ -319,7 +321,7 @@
 
         Lastly, specify the name of the class you would like to create. The
         \e{Header file}, \e{Source file} and \e{Form file} fields will update
-        themselves according to your choice of class name.
+        automatically according to your choice of class name.
 
         You also have to select the base class for your class, either a
         QWidget, QDialog or QMainWindow,  from the drop down box. Click
@@ -522,88 +524,116 @@
     \page creator-navigation.html
     \nextpage creator-debugging.html
 
-    \title Navigating Quickly Around Your Code
+    \title Navigating Quickly Around Your Code with Locator
 
     With Qt Creator, navigating to different locations in your project or on
-    your disk, such as files, classes and methods, is trivial using the input
+    your disk, e.g., files, classes, methods, etc., is trivial using
-    field at the bottom left of the application window.
+    \gui Locator -- a smart line edit at the bottom left of Qt Creator's
+    window.
 
-    ### SCREENSHOT
+    \image qtcreator-locator.png
 
-    To open for example the file \c{main.cpp} of your project, click into the
+    Suppose you would like to open your project's \c{main.cpp} file, click on
-    input field (or use \key{Ctrl+K} to get there), type the file name, and
+    \gui Locator or use \key{Ctrl+K}, type in the file name and then press
-    finally press the \key{Return} key. The file will open in the editor.
+    \key Return. The file will be opened in the editor. You can also type
-    You can also type only a part of a file name, and use the wildcard
+    part of a file name and use wildcard characters \c{*} and \c{?} to match
-    characters \c{*} and \c{?} which match \c{any number of any characters} and
+    \e{any} number of \e{any} characters. A list of all files matching your
-    \c{any single character}, respectively - you will get a list of all matching
+    criteria will be displayed. 
-    files to choose from.
+
+    \gui Locator not only allows you to navigate files on disk but also other
+    "locations", which are organized with \bold{Filters}. Currently there are
+    filters for:
 
-    As mentioned above, files are not the only type of locations you can
-    jump to. The different types of locations are organized in what we
-    call \c{filters}. There are filters for jumping to
     \list
-        \o files mentioned in your \c{.pro} files, such as source and header,
+        \o  files anywhere on your hard disk (browsing through the file system),
-           resource and \c{.ui} files,
+        \o  files from a subdirectory structure defined by you,
-        \o a specific line in your current text document,
+        \o  files mentioned in your \c{.pro} files, such as source, header,
+            resource, and \c{.ui} files,
+        \o  any open document,
         \o  class and method definitions in your project or anywhere referenced
             from your project,
-        \o help topics, including the Qt API reference documentation,
+        \o  help topics, including Qt's documentation, and,
-        \o files anywhere on your hard disk (by browsing through the file system),
+        \o  a specific line in the document displayed on your editor,
-        \o any open document,
-        \o files from a subdirectory structure you define.
     \endlist
-    Some of these filters are not used by default if you just start typing in the
+
-    input field, but require you to type a "prefix" in front, that is
+
-    assigned to that filter. The prefix is usually a single character,
+    Some of these filters require you to activate them by typing an assigned
-    followed by a space. As an example, to jump to the definition of the class
+    \e prefix. This prefix is usually a single character followed by
-    \c{QDataStream} type \key{Ctrl+K}, \key{:}, \key{Space}, and the class name.
+    \key{Space}. For example, to jump to the definition of the class
-    You find a full list of filters and their prefixes below.
+    \l{http://doc.trolltech.com/qdatastream.html}{QDataStream}, type:
+    \key{Ctrl+K} to activate \gui Locator. Then type colon (\key{:}) followed
+    by \key{Space} and the class name.
+
+
+    Below is a full list of \l{http://doc.trolltech.com/qdatastream.html}
+    {QDataStream} related output:
 
     \image qtcreator-navigate-popup.png
 
-    You can add filters that provide quick navigation to files in a
+
-    subdirectory structure that you define. This way you have quick access to
+    Filters can be added to provide quick navigation around files in a
-    files that are not directly mentioned in your project, but still relate to it.
+    subdirectory structure defined by you. This way, you can acccess files you
-    Click on the little magnifier glass in the input field and choose
+    need, that are not directly mentioned in your project. Click on 
-    \gui{Configure...} from the menu that appears. This opens the preferences
+    \image qtcreator-locator-magnify.png
-    dialog for navigation filters. Click the \gui{Add} button to create a new
+     and choose \gui{Configure...} from the menu displayed.
-    filter.  Give it a name, choose directories, set (a comma separated list of)
+
-    file patterns, and give it a prefix string. After closing the preferences
+    \image qtcreator-locator-customize.png
-    dialog the directories you specified are searched for files that match the
+
-    file patterns, and the information is cached. From now on you can jump to
+    This then displays the \gui Preferences dialog (\gui Options on Mac Os X)
-    these files by just typing part of the file name into the navigation input
+    for navigation filters. Click \gui Add to create a new filter. In the
-    field. You can force an update of the cached information about the files via
+    \gui{Filter Configuration} dialog below, give your filter a name, select
-    the \gui{Refresh} menu item in the magnifier menu.
+    your preferred directories, set file patterns with a comma separated list,
+    and specify a prefix string.
 
     \image qtcreator-navigate-customfilter.png
 
+    After closing this dialog, \gui Locator will search the directories you
+    selected for files matching your file patterns, and the information will be
+    cached. Click \gui Refresh from the menu above to update the cached
+    information.
+
+
     The following table lists the filters currently available:
 
     \table
         \header
             \o  Function
             \o  Key Combination
+            \o  Screenshot
         \row
-            \o Go to a Line in the Current Document
+            \o  Go to a line in the current document
-            \o Ctrl + K, l, Space, and the line number
+            \o  Ctrl+K, l, Space, and the line number
+            \o  \image qtcreator-locator-line.png
         \row
-            \o Go to a Function Definitions
+            \o  Go to a symbol definition
-            \o Ctrl + K, :, Space, and the function name
+            \o  Ctrl+K, :, Space, and the function name
         \row
-            \o Go to a Help Topic
+            \o  Go to a help topic
-            \o Ctrl + K, ?, Space, and the topic
+            \o  Ctrl+K, ?, Space, and the topic
+            \o  \image qtcreator-locator-help.png
         \row
-            \o Go to an Already Opened Document
+            \o  Go to an opened document
-            \o Ctrl + K, o, Space, and the document name.
+            \o  Ctrl+K, o, Space, and the document name.
         \row
-            \o Go to a File in the File System (browsing the file system)
+            \o  Go to a file in the file system (browse the file system)
-            \o Ctrl + K, f, Space, and the file name.
+            \o  Ctrl+K, f, Space, and the file name.
         \row
-            \o Go to a File in any Loaded Project
+            \o  Go to a file in any project currently loaded
-            \o Ctrl + K, a, Space, and the function name.
+            \o  Ctrl+K, a, Space, and the function name.
+            \o  \image qtcreator-locator-files.png
         \row
-            \o Go to a File in the Current Project
+            \o  Go to a file in the current project
-            \o Ctrl + K, p, Space, and the function name.
+            \o  Ctrl+K, p, Space, and the function name.
+
+        \row
+            \o  Go to a class definition
+            \o  Ctrl+K, c, Space, and the class name.
+            \o  \image qtcreator-locator-classes.png
+
+        \row
+            \o  Go to a method definition
+            \o  Ctrl+K, m, Space, and the class name.
+            \o  \image qtcreator-locator-methods.png
     \endtable
 */
 
@@ -734,11 +764,9 @@
     To finish debugging, Press \key{Shift+F5}. A line of code can be executed
     as a whole with \key F10; to execute a function or a sub-function, use
     \key F11. Alternatively, you can continue running the program with \key F5.
-
+    It is possible to continue executing your program until the current
-    ###REWORD    
+    function completes or jump to an arbitrary position in the current
-    There is also the possibility to continue execution until the current
+    function.
-    function finishes, or, for advanced use, to jump to an arbitrary 
-    possition in the current function.
 
 
     \section2 Stack
@@ -828,30 +856,25 @@
     \section2 Modules
 
     By default, the \gui Modules view is hidden as it is only useful with the
-    experimental delayed debug information loading feature. You can turn this
+    experimental delayed loaing of debug information feature. You can turn
-    feature on by selecting \gui{Fast Debugger Start} 
+    this feature on by selecting \gui{Fast Debugger Start} 
 
 
+    With this feature, debug information from the Qt library itself is not
+    loaded when the application starts up, thereby reducing the startup times
+    for some applications. You can then use the \gui Modules view to manually
+    load this information, if required.
+
+    \note In this scenario, some breakpoints may not be set by the debugger.
 
-    The \gui Modules view is hidden by default and only useful in
-    connection with the experimental feature of delayed debug 
-    information loading. This feature is accessible by selecting
-    \gui{Debug} and \gui{Fast Debugger Start}. When using the
-    feature, debug information coming from the Qt library itself
-    are not loaded on application startup, thereby reducing the
-    startup times for some applications.  The \gui{Modules View}
-    can then be used to load this information manually if needed.
-    Note that the debugger may fail to set some breakpoints in
-    this scenarios.
         
     \section2 Disassembler View and Registers View
 
-    Both the \gui{Disassembler View} and \gui{Registers View} are hidden
+    By default, both the \gui Disassembler and \gui Registers view are hidden.
-    by default. The former shows the disassembled code of the current
+    The \gui Disassembler view displays disassembled code for the current
-    function, the latter the current state of the CPU registers.
+    function; the \gui Registers view displays the current state of the CPU's
-    Both views are mainly useful in connection with the low-level
+    registers. Both views are useful for low-level commands such as
-    \gui{Step single instruction} and \gui{Step over single instruction}
+    \gui{Step Single Instruction} and \gui{Step Over Single Instruction}.
-    commands.
 
 
     \section1 A Walkthrough for the Debugger Frontend
@@ -1032,84 +1055,67 @@
         \header
             \o Function
             \o Key Combination
+
         \row
-            \o Activate Build & Run Mode
+            \o Activate \gui Welcome mode
-            \o Ctrl + 4
+            \o Ctrl + 1
         \row
-            \o Activate Debug Mode
+            \o Activate \gui Edit mode
-            \o Ctrl + 3
-        \row
-            \o Activate Edit Mode
             \o Ctrl + 2
         \row
-            \o Activate Help Mode
+            \o Activate \gui Debug mode
+            \o Ctrl + 3
+        \row
+            \o Activate \gui Projects mode
+            \o Ctrl + 4
+        \row
+            \o Activate \gui Help mode
             \o Ctrl + 5
         \row
-            \o Activate Output Mode
+            \o Activate \gui Output mode
             \o Ctrl + 6
-        \row
-            \o Activate Welcome Mode
-            \o Ctrl + 1
         \row
             \o Find
             \o Ctrl + F
         \row
-            \o Find Next
+            \o Find next
             \o F3
         \row
-            \o Go back to Code Editor (\gui Edit mode: The first press gives
+            \o Go back to the code editor (\gui Edit mode: The first press
-               the editor focus, without closing secondary windows; the second
+               gives the editor focus, without closing secondary windows; the
-               press closes all secondary windows. \gui Debug mode or \gui Help
+               second press closes all secondary windows. \gui Debug mode or
-               mode: Switch to \gui Edit mode.)
+               \gui Help mode: Switch to \gui Edit mode.)
             \o Esc
         \row
-            \o Go to a Line
+            \o Go to a line
             \o Ctrl + L
         \row
-            \o Start Debugging
+            \o Start debugging
             \o F5
         \row
-            \o Stop Debugging
+            \o Stop debugging
             \o Shift + F5
         \row
-            \o Toggle Application Output
+            \o Toggle code declaration and definition
-            \o Alt + 3
-        \row
-            \o Toggle Code Declaration and Definition
             \o F2
         \row
-            \o Toggle Header File and Source File
+            \o Toggle header file and source file
             \o F4
         \row
             \o Toggle Side Bar
             \o Alt + 0
         \row
-            \o Toggle Task List
+            \o Toggle \gui{Build Issues} pane
             \o Alt + 1
         \row
-            \o Toggle Search Results
+            \o Toggle \gui{Search Results} pane
             \o Alt + 2
         \row
-            \o Toggle Compile Output
+            \o Toggle \gui{Application Output} pane
+            \o Alt + 3
+        \row
+            \o Toggle \gui{Compile Output} pane
             \o Alt + 4
-        \row
-            \o Select Welcome Mode
-            \o Ctrl + 1
-        \row
-            \o Select Edit Mode
-            \o Ctrl + 2
-        \row
-            \o Select Debug Mode
-            \o Ctrl + 3
-        \row
-            \o Select Build & Run Mode
-            \o Ctrl + 4
-        \row
-            \o Select Help Mode
-            \o Ctrl + 5
-        \row
-            \o Select Output Mode
-            \o Ctrl + 6
     \endtable
 */
 
@@ -1126,38 +1132,38 @@
     \list
         \o  The central editor sometimes loses it "changed" status marker.
 
-      \o There is a kernel bug essentially making debugging unreliable
+        \o  There is a kernel bug essentially making debugging unreliable on
-         on 2.6.24 kernels for i386 (which is, unfortunately, the default
+            2.6.24 kernels for i386 (which is, unfortunately, the default on
-         on Ubuntu 8.04).
+            Ubuntu 8.04). See
-         See \l{https://bugs.launchpad.net/ubuntu/+source/gdb/+bug/230315/}
+            \l{https://bugs.launchpad.net/ubuntu/+source/gdb/+bug/230315/} for
-         for details.
+            details. The only solution to this problem is to boot another
-         The only solution for this problem is to boot another kernel.
+            kernel.
         
-      \o gdb sometimes takes very long to load debugging symbol,
+        \o  Gdb may take long to load debugging symbols, especially from large
-         especially from big libraries like \c libQtWebKit. Starting debugging
+            libraries like \c libQtWebKit. Starting the debugging module can
-         can take up to several minutes without visible progress.
+            take up to several minutes without visible progress.
 
-      \o Paths or file names containing spaces or special characters like colons,
+        \o  Paths or file names containing spaces or special characters, e.g.,
-         dollar signs, hash marks etc. may create difficulties.
+            colons, dollar signs, hash marks etc. may cause difficulties. This
-         Some of the tools Qt Creator uses in the background to do the "real
+            is because some of the tools Qt Creator uses in the background have
-         work" have restrictions on the characters that are allowed in file
+            restrictions on the characters allowed in file and directory names.
-         and directory names. To be on the safe side, it is strongly
+            To be on the safe side, we recomment creating projects and project
-         recommended to create projects and project items only with names
+            items with names consisting of plain characters, numbers,
-         consisting of plain characters, numbers, underscores, and hyphens.
+            underscores, and hyphens.
 
-      \o \c .pro files are reformatted if files are added/removed.
+        \o  \c{.pro} files are reformatted if files have been added or removed.
             Whitespace is not preserved.
 
-      \o No IDE support for adding files to include (\c .pri) files.
+        \o  There is no IDE support for adding files to include (\c .pri) files.
 
-      \o No IDE support for adding/removing sub-projects.
+        \o  There is no IDE support for adding/removing sub-projects. Project
-         Project hierarchies (SUBDIRS template) have to be created by hand.
+            hierarchies (SUBDIRS template) have to be created manually.
 
-      \o The file system sidebar does not update automatically.
+        \o  The file system sidebar does not update automatically. As a
-         As a workaround you can switch to another directory and then back.
+            workaround, switch to another directory and then back.
 
-      \o The resource system of the embedded version of Qt Designer
+        \o  The resource system of the embedded version of Qt Designer does not
-         does not interact with the project management.
+            interact with the project manager.
 
         \o Loading KDE4 designer plugins breaks the style, due to a bug in KDE.
     \endlist

src/plugins/projectexplorer/compileoutputwindow.h

@@ -52,7 +52,7 @@ public:
     CompileOutputWindow(BuildManager *bm);
     QWidget *outputWidget(QWidget *);
     QList<QWidget*> toolBarWidgets(void) const { return QList<QWidget *>(); }
-    QString name() const { return tr("Compile"); }
+    QString name() const { return tr("Compile Output"); }
     int priorityInStatusBar() const;
     void clearContents();
     void visibilityChanged(bool visible);

src/plugins/projectexplorer/environmenteditmodel.cpp

@@ -311,7 +311,7 @@ QModelIndex EnvironmentModel::addVariable(const EnvironmentItem &item)
             rowInResult = findInResultInsertPosition(item.name);
         int rowInChanges = findInChangesInsertPosition(item.name);
 
-        qDebug()<<"addVariable "<<item.name<<existsInBaseEnvironment<<rowInResult<<rowInChanges;
+        //qDebug() << "addVariable " << item.name << existsInBaseEnvironment << rowInResult << rowInChanges;
 
         if (existsInBaseEnvironment) {
             m_items.insert(rowInChanges, item);

src/plugins/qt4projectmanager/qt4nodes.cpp

@@ -700,7 +700,6 @@ void Qt4ProFileNode::update()
 
 void Qt4ProFileNode::fileChanged(const QString &filePath)
 {
-    qDebug()<<"+++++"<<filePath;
     CppTools::CppModelManagerInterface *modelManager =
         ExtensionSystem::PluginManager::instance()->getObject<CppTools::CppModelManagerInterface>();
 

src/plugins/qt4projectmanager/qt4project.cpp

@@ -621,7 +621,22 @@ void Qt4Project::addDefaultBuild()
         // Restoring configuration
         // Do we already have a gdbmacrobuildstep?
         // If not add it and disable linking of debugging helper
-        // TODO
+
+        // Check for old link debugging helper setting in each buildConfiguration
+        // We add a gdbmacrosbuildstep if at least one has it
+        // TODO remove migration code from pre beta
+        foreach(const QString &bc, buildConfigurations()) {
+            QVariant v = value(bc, "addQDumper");
+            if (v.isValid() && v.toBool()) {
+                GdbMacrosBuildStep *gdbmacrostep = new GdbMacrosBuildStep(this);
+                insertBuildStep(0, gdbmacrostep);
+                break;
+            }
+        }
+
+        foreach(const QString &bc, buildConfigurations()) {
+            setValue(bc, "addQDumper", QVariant());
+        }
     }
 }