diff options
| author | Robert Griesemer <gri@golang.org> | 2010-01-27 09:35:39 -0800 |
|---|---|---|
| committer | Robert Griesemer <gri@golang.org> | 2010-01-27 09:35:39 -0800 |
| commit | 94d870b20fa9c13e96cc5d4894497c4d8df35b95 (patch) | |
| tree | 6c09f3ba106be136665436a8e896cb3ede4e4a04 | |
| parent | da0f154cecf72a30fb2412aa018803208e80dde3 (diff) | |
| download | golang-94d870b20fa9c13e96cc5d4894497c4d8df35b95.tar.gz | |
Clarify parsing of channel types.
R=r, rsc
CC=golang-dev
http://codereview.appspot.com/194091
| -rw-r--r-- | doc/go_spec.html | 14 |
1 files changed, 13 insertions, 1 deletions
diff --git a/doc/go_spec.html b/doc/go_spec.html index b5931c110..382387645 100644 --- a/doc/go_spec.html +++ b/doc/go_spec.html @@ -1108,6 +1108,19 @@ RecvChannel = "<-" "chan" ElementType . </pre> <p> +To avoid a parsing ambiguity in cases such as <code>chan<- chan int</code>, +the Channel production's ElementType cannot be a RecvChannel. +To construct such a type, parenthesize the RecvChannel first. +</p> + +<pre> +chan<- chan int // same as chan<- (chan int) +chan<- <-chan int // same as chan<- (<-chan int) +<-chan <-chan int // same as <-chan (<-chan int) +chan (<-chan int) +</pre> + +<p> Upon creation, a channel can be used both to send and to receive values. By conversion or assignment, a channel may be constrained only to send or to receive. This constraint is called a channel's <i>direction</i>; either @@ -1126,7 +1139,6 @@ value can be made using the built-in function <code>make</code>, which takes the channel type and an optional capacity as arguments: </p> - <pre> make(chan int, 100) </pre> |