aboutsummaryrefslogtreecommitdiffstats
path: root/docs/part-1/debug-overview.md
diff options
context:
space:
mode:
authorScott Rifenbark <srifenbark@gmail.com>2019-05-27 17:38:19 -0700
committerScott Rifenbark <srifenbark@gmail.com>2019-05-27 17:38:19 -0700
commit9e4e4f3244fb607aa5d0bfec364c983727448740 (patch)
treed13fbfd0a2931a004cc35ba092af2136e00af829 /docs/part-1/debug-overview.md
parent32283fd8d10b539ec3cd700716dd82d8acc7fdd6 (diff)
XDS debug overview: Minor edits "flounder"
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com> Change-Id: I7b5bfe2ea15dfe36708f6093cf5f9462579eeef0
Diffstat (limited to 'docs/part-1/debug-overview.md')
-rwxr-xr-xdocs/part-1/debug-overview.md40
1 files changed, 27 insertions, 13 deletions
diff --git a/docs/part-1/debug-overview.md b/docs/part-1/debug-overview.md
index 22dc82d..25cb30d 100755
--- a/docs/part-1/debug-overview.md
+++ b/docs/part-1/debug-overview.md
@@ -1,22 +1,36 @@
-# Debug your first AGL application
+# Overview
-Debug is based on gdb and you need to use `xds-gdb` as a wrapper on gdb to
+Debugging your AGL application is based on the GNU Project Debugger
+([GDB](https://www.gnu.org/software/gdb/)).
+In order to use GDB, you must use `xds-gdb` as a wrapper on GDB to
cross-debug your application.
+For information on `xds-gdb`, see the
+"[Client Part](./client-part.html)" topic.
-This tool allows you to debug an application built with XDS without the need to install gdb or any cross tools.
+Using `xds-gdb` allows you to debug an application built with
+XDS without the need to install GDB or any cross-tools.
-Two debugging models are supported:
+XDS supports two debugging models:
-1. native debugging
-1. XDS remote debugging requiring an XDS agent/server setup and that allows you to cross debug your application.
+* Native debugging
-By default XDS debug model is used and you need to define `XDS_NATIVE_GDB`
-variable to use native gdb debug mode instead.
+* XDS remote debugging
----
+The default debugging model is XDS remote.
+To use this model, you must have previously set up the XDS
+agent and server so that you can cross-debug your application.
+See the
+"[Server Part](./server-part.html)" and
+"[Client Part](./client-part.html)" topics for more
+information on getting set up.
-Links to subchapters :
+If you want to use the native debugging model, you must define the
+`XDS_NATIVE_GDB` environment variable.
+See the
+"[Configuration](./debug-configuration.html)" topic for information
+on XDS configuration variables.
-- [Configuration](./debug-configuration.html)
-- [xds-gdb from command line](./debug-cmd-line.html)
-- [xds-gdb within an IDE](./debug-ide.html)
+The remainder of this topic describes
+[configurations](./debug-configuration), using the XDS
+[command line](./debug-cmd-line) to debug, and using an
+[IDE](./debug-ide) to debug.