A couple tweaks

Author: mdinger

examples/fn/closures/anonymity/anonymity.rs

@@ -1,6 +1,6 @@
-// `F` must implement `Fn` for a function which takes no
+// `F` must implement `Fn` for a closure which takes no
 // inputs and returns nothing. Exactly what is required
-// for `diary`.
+// for `print`.
 fn apply<F>(f: F) where
     F: Fn() {
 

examples/fn/closures/anonymity/input.md

@@ -1,6 +1,6 @@
-Closures are supposedly anonymous. Does that affect it's usage? It surely
-does. Observe how using a closure in a function requires generics, which
-is necessary because of how they are defined:
+Closures succinctly capture variables from enclosing scopes. Does this have
+any consequences? It surely does. Observe how using a closure in a function
+requires generics, which is necessary because of how they are defined:
 
 ```rust
 // `F` must be generic.

examples/fn/closures/input.md

@@ -3,7 +3,8 @@ can capture the enclosing environment. Their syntax and capabilties make them
 very convenient for on the fly usage. Some characteristics include:
 
 * uses `||` instead of `()` around input variables.
-* *both* input and return types can be inferred.
+* *both* input and return *types* can be inferred.
+* input variable *names* must be specified.
 * body delimination (`{}`) is optional for a single expression. Mandatory
 otherwise.
 * the outer environment variables *may* be captured.

examples/fn/closures/input_parameters/input_parameters.rs

@@ -17,6 +17,7 @@ fn apply_to_3<F>(f: F) -> i32 where
 
 fn main() {
     let greeting = "hello";
+    // A non-copy type.
     let mut farewell = "goodbye".to_owned();
 
     // Capture 2 variables: `greeting` by reference and

examples/fn/closures/output_parameters/output_parameters.rs

@@ -1,6 +1,8 @@
 #![feature(core)]
 use std::boxed::FnBox;
 
+// Return a closure taking no inputs and returning nothing
+// which implements `FnBox` (capture by value).
 fn create_fnbox() -> Box<FnBox()> {
     let text = "FnBox".to_owned();
 

examples/structure.json

@@ -59,7 +59,7 @@
         { "id": "closures", "title": "Closures", "children": [
             { "id": "capture", "title": "Capturing", "children": null },
             { "id": "input_parameters", "title": "As input parameters", "children": null },
-            { "id": "anonymity", "title": "Anonymity", "children": null },
+            { "id": "anonymity", "title": "Type anonymity", "children": null },
             { "id": "input_functions", "title": "Input functions", "children": null },
             { "id": "output_parameters", "title": "As output parameters", "children": null },
             { "id": "closure_analysis", "title": "Analysis", "children": [