Documentation for Chan could be better

The summary is two words, and none of the operations say whether they block or not. Someone on reddit was expecting a read to throw an exception if the Chan was empty, for example.

changed weight to 5

added Tbug Trac import core libraries labels

For deprecated docs, ideally haddock would generate them from the pragmas.

assigned to @trac-ekmett

Moving over to new owning component 'Core Libraries'.

Trac metadata

Trac field	Value
Component	libraries/base → Core Libraries

changed the description

Trac metadata

Trac field	Value
CC	→ core-libraries-committee@haskell.org

On the plus side, at least the deprecations now show up in the haddocks.

Trac metadata

Trac field	Value
TypeOfFailure	OtherFailure → DocumentationBug
CC	core-libraries-committee@haskell.org → core-libraries-committee@haskell.org, ekmett

https://phabricator.haskell.org/D3439 maybe doesn't close this ticket but it's an improvement.

mentioned in commit 42ef0845

added Pnormal label

added documentation label

removed Tbug label