Rollup merge of rust-lang#27327 - steveklabnik:fix_take, r=alexcrichton

This only reads five bytes, so don't use a ten byte buffer, that's confusing.

r? @alexcrichton

Author: steveklabnik

src/libstd/io/mod.rs

@@ -707,7 +707,7 @@ pub trait Read {
     ///
     /// # fn foo() -> io::Result<()> {
     /// let mut f = try!(File::open("foo.txt"));
-    /// let mut buffer = [0; 10];
+    /// let mut buffer = [0; 5];
     ///
     /// // read at most five bytes
     /// let mut handle = f.take(5);