Merge pull request #158 from joshtriplett/clarifications

Clarifications on unbraced closures

Author: calebcartwright

guide/expressions.md

@@ -61,9 +61,9 @@ An empty block should be written as `{}`.
 A block may be written on a single line if:
 
 * it is either used in expression position (not statement position) or is an
-  unsafe block in statement position
-* contains a single-line expression and no statements
-* contains no comments
+  unsafe block in statement position,
+* it contains a single-line expression and no statements, and
+* it contains no comments
 
 A single line block should have spaces after the opening brace and before the
 closing brace.
@@ -122,9 +122,9 @@ closure. Between the `|`s, you should use function definition syntax, however,
 elide types where possible.
 
 Use closures without the enclosing `{}`, if possible. Add the `{}` when you have
-a return type, when there are statements, there are comments in the body, or the
-body expression spans multiple lines and is a control-flow expression. If using
-braces, follow the rules above for blocks. Examples:
+a return type, when there are statements, when there are comments inside the
+closure, or when the body expression is a control-flow expression that spans
+multiple lines. If using braces, follow the rules above for blocks. Examples:
 
 ```rust
 |arg1, arg2| expr