`for` section of the manual hasn't been updated for iterators

[toqueteos]

(... other than the code examples.)

New docs have updated examples to include the new in syntax but no other mention to in is made on http://static.rust-lang.org/doc/rust.html#for-expressions.

Also grammar production is wrong (doesn't include new "in" syntax).

[toqueteos]

Also "in" is missing on keywords list, sending PR for that in a moment.

[huonw]

It looks like the whole for section is wrong, not just the grammar: e.g. the first sentence:

A for expression is similar to a do expression, in that it provides a special block-form of lambda expression, suited to passing the block function to a higher-order function implementing a loop.

In any case, the grammar is now for_expr : "for" pat "in" expr '{' block '}' ;.

(I'm changing this issue to be more general, and just cover the whole section, which needs a rewrite to reflect reality.)

[brandonson]

@toqueteos Are you still looking at rewriting the docs? If not, I may take a poke at it sometime in the semi-near future.

[toqueteos]

@singingboyo Feel free to contribute, I didn't make a PR for the "for" section because I'm not that experienced on Rust.

[thestinger]

This could be better documented, but is no longer out-of-date. The iterator tutorial does cover this stuff fairly well too.