Doc: Describe the "Use SSH port forwarding for debugging" option

... in Preferences > Devices for a Remote Linux Device.

Add links between developing for remote Linux and debugging
remotely with GDB.

Task-number: QTCREATORBUG-30604
Change-Id: I149447ce5e30409452c203fecc41417822a3d8b2
Reviewed-by: hjk <hjk@qt.io>

dist/changelog/changes-14.0.0.md

@@ -291,7 +291,8 @@ Platforms
 
 ### Remote Linux
 
-* Added the option to use SSH port forwarding for debugging
+* Added the `Use SSH port forwarding for debugging` option in `Preferences` >
+  `Devices` for a `Remote Linux Device`
 * Improved the performance of the generic deployment method
 * Fixed that the file size check that is performed before parsing C++ files
   could freeze Qt Creator until finished for remote projects

doc/qtcreator/src/debugger/creator-only/creator-debugger.qdoc

@@ -589,8 +589,24 @@
     in GDB, see \l{https://sourceware.org/gdb/onlinedocs/gdb/Connecting.html}
     {Debugging with GDB: Connecting to a Remote Target}.
 
-    \sa {Debug}{How To: Debug}, {GDB}, {Debugging},
+    \section1 Use SSH port forwarding
-    {Debuggers}, {Debugger}, {Kits}
+
+    To enable debugging on remote targets that cannot expose GDB server ports,
+    map the remote ports to local ports using SSH tunneling. \QC automatically
+    detects the local and remote ports.
+
+    To turn on SSH port forwarding:
+
+    \list 1
+        \li Go to \preferences > \uicontrol Devices.
+            \image qtcreator-preferences-devices-remote-linux.webp {Remote Linux device preferences}
+        \li In \uicontrol Device, select \uicontrol {Remote Linux Device}.
+        \li Select \uicontrol {Use SSH port forwarding for debugging}.
+        \li Select \uicontrol OK.
+    \endlist
+
+    \sa {Debug}{How To: Debug}, {Remote Linux}{How To: Develop for remote Linux},
+    {GDB}, {Debugging}, {Debuggers}, {Debugger}, {Kits}
 */
 
 /*!

doc/qtcreator/src/linux-mobile/creator-projects-how-to-run-generic-linux.qdoc

@@ -35,5 +35,6 @@
     it is compatible with the GDB on the host.
 
     \sa {Remote Linux}{How To: Develop for remote Linux},
-    {Run on many platforms}, {Compilers}, {Embedded Platforms}, {Kits}
+    {Debug remotely with GDB}, {Run on many platforms}, {Compilers},
+    {Embedded Platforms}, {Kits}
 */

doc/qtcreator/src/linux-mobile/linuxdev.qdoc

@@ -138,6 +138,6 @@
     \include qtcreator-add-linux-device.qdocinc {add linux device} {Remote Linux Device}
 
     \sa {Remote Linux}{How To: Develop for remote Linux},
-    {Developing for Remote Linux Devices},
+    {Debug remotely with GDB}, {Developing for Remote Linux Devices},
     {Remote Linux Deploy Configuration}
 */