Raku / doc

🦋 Raku documentation
https://docs.raku.org/
Artistic License 2.0
286 stars 293 forks source link

IO::Socket::Async::ListenSocket is undocumented #2446

Open Kaiepi opened 5 years ago

Kaiepi commented 5 years ago

The problem

IO::Socket::Async::ListenSocket, the type returned by IO::Socket::Async.listen(...).tap(...) is undocumented

Suggestions

Document it, along with .socket-host, .socket-port, and .native-descriptor (once that's merged).

JJ commented 5 years ago

It's part of Rakudo. We've done this usually with other classes, only it should be very clear it's not spec.

Kaiepi commented 5 years ago

Ah, my mistake.

JJ commented 5 years ago

No mistake at all. Usual policy is that if it's returned from some specced method, it's also documented, and this definitely should be, I think. Thanks for raising the issue.