diff options
author | Fernando Nasser <fnasser@redhat.com> | 2000-03-23 23:50:51 +0000 |
---|---|---|
committer | Fernando Nasser <fnasser@redhat.com> | 2000-03-23 23:50:51 +0000 |
commit | ac4919a214b3184f9aa94726d35f15cf73e10478 (patch) | |
tree | 4cf174efcd7bc3736fab3cad64b6f7576b434273 | |
parent | 8d8f248f80f9dc31fdc4be69eb3d9141bba30074 (diff) | |
download | gdb-ac4919a214b3184f9aa94726d35f15cf73e10478.tar.gz |
2000-03-23 Fernando Nasser <fnasser@totem.to.cygnus.com>
From David Whedon <dwhedon@gordian.com>
* gdbint.texinfo : Added paragraphs about command deprecation.
-rw-r--r-- | gdb/doc/ChangeLog | 5 | ||||
-rw-r--r-- | gdb/doc/gdbint.texinfo | 18 |
2 files changed, 20 insertions, 3 deletions
diff --git a/gdb/doc/ChangeLog b/gdb/doc/ChangeLog index 48efadf2bbe..b3043d11d69 100644 --- a/gdb/doc/ChangeLog +++ b/gdb/doc/ChangeLog @@ -1,3 +1,8 @@ +2000-03-23 Fernando Nasser <fnasser@totem.to.cygnus.com> + + From David Whedon <dwhedon@gordian.com> + * gdbint.texinfo : Added paragraphs about command deprecation. + 2000-03-22 Daniel Berlin <dan@cgsoftware.com> * gdb.texinfo: Add documentation for the apropos command. diff --git a/gdb/doc/gdbint.texinfo b/gdb/doc/gdbint.texinfo index 92816374c59..569f2a6e916 100644 --- a/gdb/doc/gdbint.texinfo +++ b/gdb/doc/gdbint.texinfo @@ -46,7 +46,7 @@ regarded as a program in the language TeX). @page @tex \def\$#1${{#1}} % Kluge: collect RCS revision info without $...$ -\xdef\manvers{\$Revision: 1.3 $} % For use in headers, footers too +\xdef\manvers{\$Revision: 1.4 $} % For use in headers, footers too {\parskip=0pt \hfill Cygnus Solutions\par \hfill \manvers\par @@ -332,8 +332,20 @@ to the @code{set_thread_cmd_list}. To add commands in general, use @code{add_cmd}. @code{add_com} adds to the main command list, and should be used for those commands. The usual -place to add commands is in the @code{_initialize_@var{xyz}} routines at the -ends of most source files. +place to add commands is in the @code{_initialize_@var{xyz}} routines at +the ends of most source files. + +Before removing commands from the command set it is a good idea to +deprecate them for some time. Use @code{deprecate_cmd} on commands or +aliases to set the deprecated flag. @code{deprecate_cmd} takes a +@code{struct cmd_list_element} as it's first argument. You can use the +return value from @code{add_com} or @code{add_cmd} to deprecate the +command immediately after it is created. + +The first time a comamnd is used the user will be warned and offered a +replacement (if one exists). Note that the replacement string passed to +@code{deprecate_cmd} should be the full name of the command, i.e. the +entire string the user should type at the command line. @section Console Printing |