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

[Eli Zaretskii <eliz@gnu.org>]

> 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.