Re: [RFA/doco] Document task-specific breakpoints

Eli Zaretskii
2009-04-09T17:40:56Z

> Date: Thu, 9 Apr 2009 10:33:04 -0700
> From: Joel Brobecker <brobecker@adacore.com>
> Cc: tromey@redhat.com, gdb-patches@sourceware.org
>
> > @xref{Thread-Specific Breakpoints}, for more about this. For
> > Ada-specific aspects, see @ref{Ada Tasks}.
>
> I agree with what you are saying, except that I think that the actual
> suggestion does not flow well with the way the paragraph is written.
> Currently, we have:
>
> It is also possible to insert a breakpoint that will stop the program
> only if a specific thread or a specific task hits that breakpoint.
> @xref{Thread-Specific Breakpoints} and @ref{Ada Tasks} for more
> information about this feature.
>
> Basically, we say: thread-specific breakpoint, or task-specific
> breakpoint. Then xref thread-specific. Then xref task-specific.

In that case, how about

It is also possible to insert a breakpoint that will stop the program
only if a specific thread or a specific task hits that breakpoint.
@xref{Thread-Specific Breakpoints}, for more information about
thread-specific breakpoints; see @ref{Ada Tasks}, for more
information about task-specific breakpoints.

or

It is also possible to insert a breakpoint that will stop the program
only if a specific thread (@pxref{Thread-Specific Breakpoints})
or a specific task (@pxref{Ada Tasks}) hits that breakpoint.

> So I propose the following in the end:
>
> It is also possible to insert a breakpoint that will stop the program
> only if a specific thread or a specific task hits that breakpoint.
> @xref{Thread-Specific Breakpoints}, and @ref{Ada Tasks}, for more
> information about this feature.

That's also OK.