From bf4985257d385ea28016121adcbfeb1a0e618d59 Mon Sep 17 00:00:00 2001 From: Philippe Waroquiers Date: Sat, 28 Sep 2019 19:30:08 +0200 Subject: Document define-prefix command and the use of . in command names. gdb/ChangeLog 2019-11-30 Philippe Waroquiers * NEWS: Mention define-prefix. Tell that command names can now contain a . character. gdb/doc/ChangeLog 2019-11-30 Philippe Waroquiers * gdb.texinfo (Define): Indicate that user-defined prefix can be used in 'define' command. Document 'define-prefix' command. --- gdb/doc/ChangeLog | 5 +++++ gdb/doc/gdb.texinfo | 45 +++++++++++++++++++++++++++++++++++++++++++-- 2 files changed, 48 insertions(+), 2 deletions(-) (limited to 'gdb/doc') diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 2889538..aaac75a 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2019-11-30 Philippe Waroquiers + + * gdb.texinfo (Define): Indicate that user-defined prefix can + be used in 'define' command. Document 'define-prefix' command. + 2019-11-27 Andrew Burgess * doc/gdb.texinfo (GDB/MI Symbol Query): Document new MI command diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 478c95b..2c30ea6 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -26525,8 +26525,9 @@ end Define a command named @var{commandname}. If there is already a command by that name, you are asked to confirm that you want to redefine it. The argument @var{commandname} may be a bare command name consisting of letters, -numbers, dashes, and underscores. It may also start with any predefined -prefix command. For example, @samp{define target my-target} creates +numbers, dashes, dots, and underscores. It may also start with any +predefined or user-defined prefix command. +For example, @samp{define target my-target} creates a user-defined @samp{target my-target} command. The definition of the command is made up of other @value{GDBN} command lines, @@ -26547,6 +26548,46 @@ You may use the @code{document} command again to change the documentation of a command. Redefining the command with @code{define} does not change the documentation. +@kindex define-prefix +@item define-prefix @var{commandname} +Define or mark the command @var{commandname} as a user-defined prefix +command. Once marked, @var{commandname} can be used as prefix command +by the @code{define} command. +Note that @code{define-prefix} can be used with a not yet defined +@var{commandname}. In such a case, @var{commandname} is defined as +an empty user-defined command. +In case you redefine a command that was marked as a user-defined +prefix command, the subcommands of the redefined command are kept +(and @value{GDBN} indicates so to the user). + +Example: +@example +(gdb) define-prefix abc +(gdb) define-prefix abc def +(gdb) define abc def +Type commands for definition of "abc def". +End with a line saying just "end". +>echo command initial def\n +>end +(gdb) define abc def ghi +Type commands for definition of "abc def ghi". +End with a line saying just "end". +>echo command ghi\n +>end +(gdb) define abc def +Keeping subcommands of prefix command "def". +Redefine command "def"? (y or n) y +Type commands for definition of "abc def". +End with a line saying just "end". +>echo command def\n +>end +(gdb) abc def ghi +command ghi +(gdb) abc def +command def +(gdb) +@end example + @kindex dont-repeat @cindex don't repeat command @item dont-repeat -- cgit v1.1