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>

1 files changed, 60 insertions, 59 deletions

diff --git a/doc/src/debugger/creator-debugger-setup.qdoc b/doc/src/debugger/creator-debugger-setup.qdoc
index c64b2d7923..f851833ba1 100644
--- a/doc/src/debugger/creator-debugger-setup.qdoc
+++ b/doc/src/debugger/creator-debugger-setup.qdoc
@@ -170,67 +170,68 @@
 
     \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
-                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.
+    \section2 GDB
 
-        \row
-            \li Debugging tools for Windows
-            \li 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.
-
-                \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
-                the Microsoft Visual C++ Compiler, the build process checks for
-                the required files in
-                \c{"%ProgramFiles%\Debugging Tools for Windows"}.
-
-                It is highly recommended that you add the Symbol Server provided
-                by Microsoft to the symbol search path of the debugger. The
-                Symbol Server provides you with debugging informaton for the
-                operating system libraries for debugging Windows applications.
-                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
-                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
-                library.
-
-                If you use a qmake based project in \QC,  you can set a flag in
-                your \l{glossary-run-config}{run configuration}, in
-                \uicontrol Projects mode. In the run configuration, select
-                \uicontrol{Use debug version of frameworks}.
-
-                For more detailed information about debugging on \macos,
-                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
+    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 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.
+
+    \note Visual Studio does not include the Debugging tools needed,
+    and therefore, you must install them separately.
+
+    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"}.
+
+    It is highly recommended that you add the Symbol Server provided
+    by Microsoft to the symbol search path of the debugger. The
+    Symbol Server provides you with debugging informaton for the
+    operating system libraries for debugging Windows applications.
+    For more information, see
+    \l{Setting CDB Paths on Windows}.
+
+    \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
+    library.
+
+    If you use a qmake based project in \QC,  you can set a flag in
+    your \l{glossary-run-config}{run configuration}, in
+    \uicontrol Projects mode. In the run configuration, select
+    \uicontrol{Use debug version of frameworks}.
+
+    For more detailed information about debugging on \macos,
+    see: \l{http://developer.apple.com/library/mac/#technotes/tn2124/_index.html#//apple_ref/doc/uid/DTS10003391}
+    {Mac OS X Debugging Magic}.
+
+    \section2 LLDB
+
+    We recommend using the LLDB version that is delivered with the latest Xcode.
 
     \section1 Mapping Source Paths