---

yaml
---
r: 195544
b: refs/heads/master
c: 8d3e559
h: refs/heads/master
v: v3

Author: bcoopers

[refs]

@@ -1,5 +1,5 @@
 ---
-refs/heads/master: 2982fe39ad93e29709a2e1414a4228718c8de28a
+refs/heads/master: 8d3e55908ae0e51f04c170133c9f9739886b8e2e
 refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
 refs/heads/snap-stage3: b3317d68910900f135f9f38e43a7a699bc736b4a
 refs/heads/try: 961e0358e1a5c0faaef606e31e9965742c1643bf

trunk/src/libstd/io/mod.rs

@@ -106,9 +106,9 @@ fn read_to_end<R: Read + ?Sized>(r: &mut R, buf: &mut Vec<u8>) -> Result<usize>
     loop {
         if len == buf.len() {
             if buf.capacity() == buf.len() {
-                // reserve() rounds up our request to the nearest power of two,
-                // so after the first time the capacity is exceeded, we double
-                // our capacity at each call to reserve. 
+                // reserve() rounds up our request such that every request
+                // (with maybe the exception of the first request) for the
+                // same amount of space doubles our capacity.
                 buf.reserve(min_cap_bump);
             }
             let new_area = buf.capacity() - buf.len();