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