---

yaml
---
r: 12184
b: refs/heads/master
c: 8e743b2
h: refs/heads/master
v: v3

Author: brson

[refs]

@@ -1,5 +1,5 @@
 ---
-refs/heads/master: 1446534271f01d38ff021cb7f92eb79551f1227b
+refs/heads/master: 8e743b2981754f1aa7e0eb5b57d79e5a8ad7d172
 refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
 refs/heads/snap-stage3: 4a81779abd786ff22d71434c6d9a5917ea4cdfff
 refs/heads/try: 2898dcc5d97da9427ac367542382b6239d9c0bbf

trunk/src/libcore/str.rs

@@ -1485,9 +1485,24 @@ fn as_c_str<T>(s: str, f: fn(*libc::c_char) -> T) -> T unsafe {
     as_buf(s) {|buf| f(buf as *libc::c_char) }
 }
 
-#[doc = "Allocate more memory for a string, up to `nn` + 1 bytes"]
-fn reserve(&ss: str, nn: uint) {
-    rustrt::str_reserve_shared(ss, nn);
+#[doc = "
+Reserves capacity for exactly `n` bytes in the given string, not including
+the null terminator.
+
+Assuming single-byte characters, the resulting string will be large
+enough to hold a string of length `n`. To account for the null terminator,
+the underlying buffer will have the size `n` + 1.
+
+If the capacity for `s` is already equal to or greater than the requested
+capacity, then no action is taken.
+
+# Arguments
+
+* s - A string
+* n - The number of bytes to reserve space for
+"]
+fn reserve(&s: str, n: uint) {
+    rustrt::str_reserve_shared(s, n);
 }
 
 #[doc = "Unsafe operations"]