Re: [rfa] Add ``Maintenance Commands'' appendix

[Andrew Cagney <ac131313@cygnus.com>]

> On Tue, 15 Jan 2002, Andrew Cagney wrote:
> 
> 
>> This was suggested long ago as a way of incorporating the maintenance 
>> commands (one of those strange GDB interfaces that should be in the user 
>> guide but can't be made to fit).
>> 
>> Thoughts?
> 
> 
> I'm for it, but such a change should include moving the few maint
> commands already documented in gdb.texinfo into this appendix.


Found one (there are not too many):

> @cindex negative breakpoint numbers
> @cindex internal @value{GDBN} breakpoints
> @value{GDBN} itself sometimes sets breakpoints in your program for special
> purposes, such as proper handling of @code{longjmp} (in C programs).
> These internal breakpoints are assigned negative numbers, starting with
> @code{-1}; @samp{info breakpoints} does not display them.
> 
> You can see these breakpoints with the @value{GDBN} maintenance command
> @samp{maint info breakpoints}.


I guess I snip things here and change the @samp{} to some sort of cross 
reference to the maintenance command.

The below being moved to the maintenance section and being the target of 
the reference.


> @table @code
> @kindex maint info breakpoints
> @item maint info breakpoints
> Using the same format as @samp{info breakpoints}, display both the
> breakpoints you've set explicitly, and those @value{GDBN} is using for
> internal purposes.  Internal breakpoints are shown with negative
> breakpoint numbers.  The type column identifies what kind of breakpoint
> is shown:
> 
> @table @code
> @item breakpoint
> Normal, explicitly set breakpoint.
> 
> @item watchpoint
> Normal, explicitly set watchpoint.
> 
> @item longjmp
> Internal breakpoint, used to handle correctly stepping through
> @code{longjmp} calls.
> 
> @item longjmp resume
> Internal breakpoint at the target of a @code{longjmp}.
> 
> @item until
> Temporary internal breakpoint used by the @value{GDBN} @code{until} command.
> 
> @item finish
> Temporary internal breakpoint used by the @value{GDBN} @code{finish} command.
> 
> @item shlib events
> Shared library events.
> 
> @end table
> 
> @end table


Er, how do I do the cross reference bit?

Andrew