Class docs for Datagram class are too brief and full of typos

[Hixie]

If you just search for "Datagram" in the docs and end up in the Datagram class, the documentation is impenetrable and unhelpful. It should at a minimum point you towards RawDatagramSocket. Ideally it would have sample code.

Datagram package.

This is misleading since it sounds like it's talking about a Dart package.

Data send to and received from datagram sockets

"sent"

contains the internet address and port of the destination or source

The data doesn't contain this stuff.

togeter

"together".

with the data.

The data contains the data? That makes no sense.

[Hixie]

I should add that the RawDatagramSocket class docs are pretty anemic as well.

[Hixie]

For example, look at the documentation for RawDatagramSocket.bind. What is the first argument? A hostname string? An integer containing an IP address? An InternetAddress object? There's absolutely no information there to answer even the most basic question about how to use this API.

[Hixie]

There's also a number of completely undocumented members in this API, for example RawSocketEvent.write.

[brianquinlan]

Most of this has been fixed:

• documentation for RawDatagramSocket.bind
• documentation for Datagram
• documentation for RawDatagramSocket
• documentation for RawSocketEvent.*