This is the mail archive of the
gdb-patches@sources.redhat.com
mailing list for the GDB project.
Re: [rfa] Add ``Maintenance Commands'' appendix
- From: Andrew Cagney <ac131313 at cygnus dot com>
- To: Eli Zaretskii <eliz at is dot elta dot co dot il>
- Cc: gdb-patches at sources dot redhat dot com
- Date: Tue, 15 Jan 2002 15:19:33 -0500
- Subject: Re: [rfa] Add ``Maintenance Commands'' appendix
- References: <Pine.SUN.3.91.1020115095652.23380Q-100000@is>
> 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