Edit documentation for ReceivePort and Isolate.

Edit documentation for ReceivePort and Isolate.


BUG=
TEST=

Committed: https://code.google.com/p/dart/source/detail?r=1345

[Bill Hesse, 2011-11-09 11:20:06]

Also, in Isolate's class comment, it says "light isolates live in the same
thread as the isolate which spawned them".

Should we say "may live in the same thread", since we don't guarantee that light
isolates don't run while the parent is running (current implementation uses a
new thread).  Also, which should be that.

[floitsch, 2011-11-09 11:52:23]

On 2011/11/09 11:20:06, Bill Hesse wrote:
> Also, in Isolate's class comment, it says "light isolates live in the same
> thread as the isolate which spawned them".
> 
> Should we say "may live in the same thread", since we don't guarantee that
light
> isolates don't run while the parent is running (current implementation uses a
> new thread).  Also, which should be that.

I already had a similar comment, but I was told to remove it. I'm not sure. On
the one hand the current behavior is not final, and the comment should maybe
rather say what the intended behavior is. On the other hand having a comment on
what is actually happening would be nice...

[floitsch, 2011-11-09 11:52:30]

LGTM!