diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index 3d63f80553..b20d9c32f3 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -9870,6 +9870,49 @@
+
+ Debugging with the GNU Project Debugger (GDB) on the Target
+
+
+ The previous section addressed using GDB remotely for debugging
+ purposes.
+ This section describes what you need to do in order to support
+ using GDB to debug on the target hardware.
+
+
+
+ To support this kind of debugging, you need do the following:
+
+
+ Ensure that GDB is on the target.
+ You can do this by adding "gdb" to
+ IMAGE_INSTALL:
+
+ IMAGE_INSTALL_append = " gdb"
+
+ Alternatively, you can add "tools-debug" to
+ IMAGE_FEATURES:
+
+ IMAGE_FEATURES = tools-debug
+
+
+
+ Ensure that debug symbols are present.
+ You can make sure these symbols are present by installing
+ -dbg:
+
+ IMAGE_INSTALL_append = " packagename-dbg"
+
+ Alternatively, you can do the following to include all the
+ debug symbols:
+
+ IMAGE_FEATURES = dbg-pkgs
+
+
+
+
+
+
Debugging Parallel Make Races