Doc: Add info about installing CDB Debugger Support on Windows

Move the information out of a table, because the table format does
not really work with so much text.

Change-Id: I8053c76ee0f43a1b35ed66fe0e2335106b1063dd
Reviewed-by: hjk <hjk@qt.io>
Reviewed-by: David Schulz <david.schulz@qt.io>
This commit is contained in:
Leena Miettinen
2018-02-01 15:51:04 +01:00
parent 2d6995ae25
commit 2bde6a5846

View File

@@ -170,35 +170,37 @@
\section1 Installing Native Debuggers
Check the table below for the supported versions and other important
information about installing native debuggers.
The following sections provide information about installing native
debuggers.
\table
\header
\li Native Debugger
\li Notes
\row
\li GDB
\li On Windows, use the Python-enabled GDB versions that is bundled
\section2 GDB
On Windows, use the Python-enabled GDB versions that is bundled
with the Qt package or comes with recent versions of MinGW. On
most Linux distributions the GDB builds shipped with the system
are sufficient. You can also build your own. Follow the
instructions in \l{http://wiki.qt.io/QtCreator_Build_Gdb}
{Building GDB}. Builds of GDB shipped with Xcode on \macos are no
longer supported.
most Linux distributions, the GDB builds shipped with the system
are sufficient.
\row
\li Debugging tools for Windows
\li To use the CDB debugger, you must install the
You can also build your own GDB, as instructed in
\l{http://wiki.qt.io/QtCreator_Build_Gdb}{Building GDB}.
Builds of GDB shipped with Xcode on \macos are no longer supported.
\section2 Debugging Tools for Windows
To use the CDB debugger, you must install the
\e{Debugging tools for Windows}. You can download them from
\l{https://developer.microsoft.com/windows/downloads/windows-10-sdk}
{Download and Install Debugging Tools for Windows} as part of the Windows SDK.
{Download and Install Debugging Tools for Windows} as part of the Windows
SDK.
\note Visual Studio does not include the Debugging tools needed,
and therefore, you must install them separately.
The pre-built \QSDK for Windows makes use of the library if it
is present on the system. When manually building \QC using
In addition, you must select \uicontrol {Qt Creator CDB Debugger Support}
(in \uicontrol Qt > \uicontrol Tools > \uicontrol {\QC}) when you install
Qt or the stand-alone \QC.
When manually building \QC using
the Microsoft Visual C++ Compiler, the build process checks for
the required files in
\c{"%ProgramFiles%\Debugging Tools for Windows"}.
@@ -210,9 +212,9 @@
For more information, see
\l{Setting CDB Paths on Windows}.
\row
\li Debugging tools for \macos
\li The Qt binary distribution contains both debug and release
\section2 Debugging Tools for \macos
The Qt binary distribution contains both debug and release
variants of the libraries. But you have to explicitly tell the
runtime linker that you want to use the debug libraries even if
your application is compiled as debug, as release is the default
@@ -227,10 +229,9 @@
see: \l{http://developer.apple.com/library/mac/#technotes/tn2124/_index.html#//apple_ref/doc/uid/DTS10003391}
{Mac OS X Debugging Magic}.
\row
\li LLDB
\li We recommend using the LLDB version that is delivered with Xcode 5.
\endtable
\section2 LLDB
We recommend using the LLDB version that is delivered with the latest Xcode.
\section1 Mapping Source Paths