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

Andrew Cagney
2002-01-15T20:19:36Z

> 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