Re: [RFA] Implement *running.

[Eli Zaretskii <eliz@gnu.org>]

> From: Vladimir Prus <vladimir@codesourcery.com>
> Date: Sun, 4 May 2008 18:37:43 +0400
> Cc: gdb-patches@sources.redhat.com
> 
> I've added the docs. Eli, are those OK?

Thanks.  Yes, it's okay, except for a couple of comments:

> +@item *running,thread-id="@var{thread}"
> +The target is now running.  The @var{thread} field tells which
> +specific thread is now running, and can be @samp{all} if all threads
> +are running.  The frontend should assume that no interaction with a
> +running thread is possible after this notification is produced.
> +@value{GDBN} may emit this notification several times for a given
> +thread, and the frontend should handle this gracefully.

The last sentence begs a question: why would this notification emitted
more than once, and what do you mean by "gracefully"? just that it
shouldn't assume the notification is emitted only once?

> +@deftypefun void target_resumed (ptid_t @var{ptid})
> +The target was resumed.  The @var{ptid} parameter specifies which
> +thread was resume
              ^^^^^^
"resumed".

>                   , and may be RESUME_ALL if all threads are resumed.

"RESUME_ALL" should be in @code, since it's a C symbol.

Thanks.