From d0ef38f307d564f29d2ee7db91bf5b5cef85372c Mon Sep 17 00:00:00 2001 From: Juergen Borleis Date: Mon, 20 Jun 2016 13:05:56 +0200 Subject: Explain the debugging support in more details This also adds the hint, that the 'debug-root' feature will fade-out soon. Signed-off-by: Juergen Borleis --- doc/user_manual.inc | 22 ++++++++++++++-------- 1 file changed, 14 insertions(+), 8 deletions(-) diff --git a/doc/user_manual.inc b/doc/user_manual.inc index 626ad857f..befc57857 100644 --- a/doc/user_manual.inc +++ b/doc/user_manual.inc @@ -414,16 +414,22 @@ project. ``|ptxdistPlatformDir|/root`` Target’s root filesystem image. This directory can be mounted as - an NFS root for example. - - Target’s root filesystem image. The difference to ``root/`` is, - all programs and libraries in this directory still have their - debug information present. This directory is intended to be used - as system root for a debugger. To be used by the debugger, you - should setup your debugger with - ``set solib-absolute-prefix /root-debug`` + an NFS root for example. Refer :ref:`nfsroot` for further details how to + make use of it. In case of a debug session, this directory can be used + by a modern GDB for its sysroot as well by using + ``set sysroot /|ptxdistPlatformDir|/root``. ``|ptxdistPlatformDir|/root-debug`` + Target’s root filesystem image intended to be used as system filesystem root + for a debugger. The difference to ``|ptxdistPlatformDir|/root/`` is, all + programs and libraries in this directory still have their debug information + present. To be used by the debugger, we should setup our debugger with + ``set sysroot /|ptxdistPlatformDir|/root-debug``. + Please note: this feature will fade-out soon. It is replaced by a long + time supported feature used by modern GDBs: using sub-directories named + ``.debug`` present in the ``|ptxdistPlatformDir|/root`` directory + instead. + ``|ptxdistPlatformDir|/state`` Building every package is divided onto stages. And stages of one package can depend on stages of other packages. In order to handle -- cgit v1.2.3