diff options
Diffstat (limited to 'gdb/doc/gdb.texinfo')
| -rw-r--r-- | gdb/doc/gdb.texinfo | 23 |
1 files changed, 22 insertions, 1 deletions
diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index a16e4d0..1bac2b8 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -15999,6 +15999,23 @@ Displays state of confirmation requests. @end table +@cindex command tracing +If you need to debug user-defined commands or sourced files you may find it +useful to enable @dfn{command tracing}. In this mode each command will be +printed as it is executed, prefixed with one or more @samp{+} symbols, the +quantity denoting the call depth of each command. + +@table @code +@kindex set trace-commands +@cindex command scripts, debugging +@item set trace-commands on +Enable command tracing. +@item set trace-commands off +Disable command tracing. +@item show trace-commands +Display the current state of command tracing. +@end table + @node Debugging Output @section Optional messages about internal happenings @cindex optional debugging messages @@ -16347,7 +16364,7 @@ command: @table @code @kindex source @cindex execute commands from a file -@item source @var{filename} +@item source [@code{-v}] @var{filename} Execute the command file @var{filename}. @end table @@ -16360,6 +16377,10 @@ execution of the command file and control is returned to the console. @value{GDBN} searches for @var{filename} in the current directory and then on the search path (specified with the @samp{directory} command). +If @code{-v}, for verbose mode, is given then @value{GDBN} displays +each command as it is executed. The option must be given before +@var{filename}, and is interpreted as part of the filename anywhere else. + Commands that would ask for confirmation if used interactively proceed without asking when used in a command file. Many @value{GDBN} commands that normally print messages to say what they are doing omit the messages |