Clarify timeout doc to mention that close! should not be called on a timeout channel

Question

After running into a race-condition involving closed timeout channels, it seems like it would be appropriate to mention that close! should never be called on a timeout channel in its docstring. The attached patch tweaks the doc string to that effect. Please advise if you'd like the wording changed a bit.

Answer 1

Comment made by: hlewisship

Alternately/additionally, it would be nice if close! on a timeout channel would throw an exception.

Answer 2

Comment made by: slipset

or alternately, make it a no-op?

Answer 3

Comment made by: alexmiller

Yeah, I think it would be better to fix this than doc it.

Answer 4

Reference: https://clojure.atlassian.net/browse/ASYNC-109 (reported by alex+import)