Rollup of 5 pull requests

src/doc/trpl/error-handling.md

@@ -1605,14 +1605,11 @@ arguments.
 
 ## Writing the logic
 
-We're all different in how we write code, but error handling is
-usually the last thing we want to think about. This isn't very good
-practice for good design, but it can be useful for rapidly
-prototyping. In our case, because Rust forces us to be explicit about
-error handling, it will also make it obvious what parts of our program
-can cause errors. Why? Because Rust will make us call `unwrap`! This
-can give us a nice bird's eye view of how we need to approach error
-handling.
+We all write code differently, but error handling is usually the last thing we
+want to think about. This isn't great for the overall design of a program, but
+it can be useful for rapid prototyping. Because Rust forces us to be explicit
+about error handling (by making us call `unwrap`), it is easy to see which
+parts of our program can cause errors.
 
 In this case study, the logic is really simple. All we need to do is parse the
 CSV data given to us and print out a field in matching rows. Let's do it. (Make

src/doc/trpl/rust-inside-other-languages.md

@@ -177,7 +177,8 @@ build  deps  examples  libembed.so  native
 
 That `libembed.so` is our ‘shared object’ library. We can use this file
 just like any shared object library written in C! As an aside, this may be
-`embed.dll` or `libembed.dylib`, depending on the platform.
+`embed.dll` (Microsoft Windows) or `libembed.dylib` (Mac OS X), depending on 
+your operating system.
 
 Now that we’ve got our Rust library built, let’s use it from our Ruby.
 

src/libcore/iter.rs

@@ -1565,6 +1565,8 @@ pub trait Iterator {
     /// as soon as it finds a `false`, given that no matter what else happens,
     /// the result will also be `false`.
     ///
+    /// An empty iterator returns `true`.
+    ///
     /// # Examples
     ///
     /// Basic usage:
@@ -1613,6 +1615,8 @@ pub trait Iterator {
     /// as soon as it finds a `true`, given that no matter what else happens,
     /// the result will also be `true`.
     ///
+    /// An empty iterator returns `false`.
+    ///
     /// # Examples
     ///
     /// Basic usage:
@@ -2071,6 +2075,8 @@ pub trait Iterator {
     ///
     /// Takes each element, adds them together, and returns the result.
     ///
+    /// An empty iterator returns the zero value of the type.
+    ///
     /// # Examples
     ///
     /// Basic usage:
@@ -2094,6 +2100,8 @@ pub trait Iterator {
 
     /// Iterates over the entire iterator, multiplying all the elements
     ///
+    /// An empty iterator returns the one value of the type.
+    ///
     /// # Examples
     ///
     /// ```