Docs: CG 9.6: clarify how to run LilyPond under gdb

diff --git a/Documentation/contributor/programming-work.itexi b/Documentation/contributor/programming-work.itexi
index 676cecac06b89163d1f9581d5af9c41090aaecf7..6d4a1cc9aa915e5926c64c1a6f45c3a846f84606 100644 (file)
--- a/Documentation/contributor/programming-work.itexi
+++ b/Documentation/contributor/programming-work.itexi
@@ -715,16 +715,27 @@ out/bin/lilypond
 @end example
 
 This is important as you will need to let gdb know where to find the
-image.  You can invoke gdb from the command line using
+image containing the symbol tables.  You can invoke gdb from the
+command line using
 
 @example
-$ gdb out/bin/lilypond
+gdb out/bin/lilypond
 @end example
+@noindent
+This loads the LilyPond symbol tables into gdb.  Then, to run
+LilyPond on @code{test.ly} under the debugger, enter
+
+@example
+run test.ly
+@end example
+@noindent
+at the gdb prompt.
 
-or you may use a graphical interface to gdb such as ddd
+As an alternative to running gdb at the command line you may try
+a graphical interface to gdb such as ddd
 
 @example
-$ ddd out/bin/lilypond
+ddd out/bin/lilypond
 @end example
 
 You can also use sets of standard gdb commands stored in a .gdbinit