diff --git a/documentation/dev-manual/dev-manual-common-tasks.xml b/documentation/dev-manual/dev-manual-common-tasks.xml
index b20d9c32f3..4cdd805cec 100644
--- a/documentation/dev-manual/dev-manual-common-tasks.xml
+++ b/documentation/dev-manual/dev-manual-common-tasks.xml
@@ -9875,7 +9875,10 @@
The previous section addressed using GDB remotely for debugging
- purposes.
+ purposes, which is the most usual case due to the inherent
+ hardware limitations on many embedded devices.
+ However, debugging in the target hardware itself is also possible
+ with the most powerful devices.
This section describes what you need to do in order to support
using GDB to debug on the target hardware.
@@ -9910,6 +9913,22 @@
+
+ To improve the debug information accuracy, you can reduce the
+ level of optimization used by the compiler.
+ For example, when adding the following line to your
+ local.conf file, you will reduce
+ optimization from
+ FULL_OPTIMIZATION
+ of "-O2" to
+ DEBUG_OPTIMIZATION
+ of "-O -fno-omit-frame-pointer":
+
+ DEBUG_BUILD = "1"
+
+ Consider that this will reduce the application's performance
+ and is recommended only for debugging purposes.
+