> The last added paragraph says (emphasis mine): > > +The default metaphor for _picking_ is that you're pulling colored > +marbles out a bag and then putting them back. (For "picking without > replacement" see C<pick> instead.) > +Rolling requires no temporary state. > > This is confusing to me. It is supposed to be describing the _roll_ > method (as evidenced by the last sentence). Why does it mention the > default metaphor for _picking_ instead of the default metaphor of > _rolling_?
How about, The default metaphor for rolling is that you're throwing a fair die and noting which side lands. (For "picking without replacement" see C<pick> instead.) Rolling requires no temporary state. -y