---

yaml
---
r: 63096
b: refs/heads/snap-stage3
c: 9b0986a
h: refs/heads/master
v: v3

Author: bors

[refs]

@@ -1,7 +1,7 @@
 ---
 refs/heads/master: 2d28d645422c1617be58c8ca7ad9a457264ca850
 refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
-refs/heads/snap-stage3: 239b81f111d522b1fbb0dbefdde16715ef68a204
+refs/heads/snap-stage3: 9b0986acf4397207a29ee6f94433efd5b4b5bc79
 refs/heads/try: 7b78b52e602bb3ea8174f9b2006bff3315f03ef9
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105
 refs/heads/ndm: f3868061cd7988080c30d6d5bf352a5a5fe2460b

branches/snap-stage3/doc/tutorial.md

@@ -569,8 +569,10 @@ loop {
 This code prints out a weird sequence of numbers and stops as soon as
 it finds one that can be divided by five.
 
-For more involved iteration, such as enumerating the elements of a
-collection, Rust uses [higher-order functions](#closures).
+Rust also has a `for` construct. It's different from C's `for` and it works
+best when iterating over collections. See the section on [closures](#closures)
+to find out how to use `for` and higher-order functions for enumerating
+elements of a collection.
 
 # Data structures
 
@@ -1393,6 +1395,7 @@ assert!(crayons.len() == 3);
 assert!(!crayons.is_empty());
 
 // Iterate over a vector, obtaining a pointer to each element
+// (`for` is explained in the next section)
 for crayons.each |crayon| {
     let delicious_crayon_wax = unwrap_crayon(*crayon);
     eat_crayon_wax(delicious_crayon_wax);

branches/snap-stage3/src/libstd/str.rs

@@ -39,13 +39,6 @@ use vec::{OwnedVector, OwnedCopyableVector};
 
 #[cfg(not(test))] use cmp::{Eq, Ord, Equiv, TotalEq};
 
-/*
-Section: Conditions
-*/
-condition! {
-    not_utf8: (~str) -> ~str;
-}
-
 /*
 Section: Creating a string
 */
@@ -55,20 +48,11 @@ Section: Creating a string
  *
  * # Failure
  *
- * Raises the `not_utf8` condition if invalid UTF-8
+ * Fails if invalid UTF-8
  */
-
-pub fn from_bytes(vv: &[u8]) -> ~str {
-    use str::not_utf8::cond;
-
-    if !is_utf8(vv) {
-        let first_bad_byte = vec::find(vv, |b| !is_utf8([*b])).get();
-        cond.raise(fmt!("from_bytes: input is not UTF-8; first bad byte is %u",
-                        first_bad_byte as uint))
-    }
-    else {
-        return unsafe { raw::from_bytes(vv) }
-    }
+pub fn from_bytes(vv: &const [u8]) -> ~str {
+    assert!(is_utf8(vv));
+    return unsafe { raw::from_bytes(vv) };
 }
 
 /**
@@ -3579,10 +3563,9 @@ mod tests {
     }
 
     #[test]
+    #[should_fail]
     #[ignore(cfg(windows))]
     fn test_from_bytes_fail() {
-        use str::not_utf8::cond;
-
         let bb = ~[0xff_u8, 0xb8_u8, 0xa8_u8,
                   0xe0_u8, 0xb9_u8, 0x84_u8,
                   0xe0_u8, 0xb8_u8, 0x97_u8,
@@ -3594,15 +3577,7 @@ mod tests {
                   0x20_u8, 0x4e_u8, 0x61_u8,
                   0x6d_u8];
 
-        let mut error_happened = false;
-        let _x = do cond.trap(|err| {
-            assert_eq!(err, ~"from_bytes: input is not UTF-8; first bad byte is 255");
-            error_happened = true;
-            ~""
-        }).in {
-            from_bytes(bb)
-        };
-        assert!(error_happened);
+         let _x = from_bytes(bb);
     }
 
     #[test]