---

yaml
---
r: 196109
b: refs/heads/beta
c: 00d929d
h: refs/heads/master
i:
  196107: fa4b568
v: v3

Author: tanadeau

[refs]

@@ -29,7 +29,7 @@ refs/tags/0.12.0: f0c419429ef30723ceaf6b42f9b5a2aeb5d2e2d1
 refs/heads/automation-fail: 1bf06495443584539b958873e04cc2f864ab10e4
 refs/heads/batch: b7fd822592a4fb577552d93010c4a4e14f314346
 refs/heads/building: 126db549b038c84269a1e4fe46f051b2c15d6970
-refs/heads/beta: cf00fc4da984481a75229ce1e40f339f292d2166
+refs/heads/beta: 00d929dcb33d0d4f734d85f7ad32716022de53cd
 refs/heads/windistfix: 7608dbad651f02e837ed05eef3d74a6662a6e928
 refs/tags/1.0.0-alpha: e42bd6d93a1d3433c486200587f8f9e12590a4d7
 refs/heads/tmp: 9de34a84bb300bab1bf0227f577331620cd60511

branches/beta/RELEASES.md

@@ -1,102 +1,3 @@
-Version 1.0.0-beta (April 2015)
--------------------------------------
-
-* ~1100 changes, numerous bugfixes
-
-* Highlights
-
-    * The big news is that the vast majority of the standard library
-      is now `#[stable]` -- 75% of the non-deprecated API surface at
-      last count. Numerous crates are now running on stable
-      Rust. Starting with this release, it is not possible to use
-      unstable features on a stable build.
-    * Arithmetic on basic integer types now
-      [checks for overflow in debug builds][overflow].
-
-* Language
-
-    * [`Send` no longer implies `'static`][send-rfc], which made
-      possible the [`thread::scoped` API][scoped]. Scoped threads can
-      borrow data from their parent's stack frame -- safely!
-    * [UFCS now supports trait-less associated paths][moar-ufcs] like
-      `MyType::default()`.
-    * Primitive types [now have inherent methods][prim-inherent],
-      obviating the need for extension traits like `SliceExt`.
-    * Methods with `Self: Sized` in their `where` clause are
-      [considered object-safe][self-sized], allowing many extension
-      traits like `IteratorExt` to be merged into the traits they
-      extended.
-    * You can now [refer to associated types][assoc-where] whose
-      corresponding trait bounds appear only in a `where` clause.
-    * The final bits of [OIBIT landed][oibit-final], meaning that
-      traits like `Send` and `Sync` are now library-defined.
-    * A [Reflect trait][reflect] was introduced, which means that
-      downcasting via the `Any` trait is effectively limited to
-      concrete types. This helps retain the potentially-important
-      "parametricity" property: generic code cannot behave differently
-      for different type arguments except in minor ways.
-    * The `unsafe_destructor` feature is now deprecated in favor of
-      the [new `dropck`][dropck]. This change is a major reduction in
-      unsafe code.
-    * Trait coherence was [revised again][fundamental], this time with
-      an eye toward API evolution over time.
-
-* Libraries
-
-    * The new path and IO modules are complete and `#[stable]`. This
-      was the major library focus for this cycle.
-    * The path API was [revised][path-normalize] to normalize `.`,
-      adjusting the tradeoffs in favor of the most common usage.
-    * A large number of remaining APIs in `std` were also stabilized
-      during this cycle; about 75% of the non-deprecated API surface
-      is now stable.
-    * The new [string pattern API][string-pattern] landed, which makes
-      the string slice API much more internally consistent and flexible.
-    * A shiny [framework for Debug implementations][debug-builder] landed.
-      This makes it possible to opt in to "pretty-printed" debugging output.
-    * A new set of [generic conversion traits][conversion] replaced
-      many existing ad hoc traits.
-    * Generic numeric traits were
-      [completely removed][num-traits]. This was made possible thanks
-      to inherent methods for primitive types, and the removal gives
-      maximal flexibility for designing a numeric hierarchy in the future.
-    * The `Fn` traits are now related via [inheritance][fn-inherit]
-      and provide ergonomic [blanket implementations][fn-blanket].
-    * The `Index` and `IndexMut` traits were changed to
-      [take the index by value][index-value], enabling code like
-      `hash_map["string"]` to work.
-    * `Copy` now [inherits][copy-clone] from `Clone`, meaning that all
-      `Copy` data is known to be `Clone` as well.
-
-* Infrastructure
-
-    * Metadata was tuned, shrinking binaries [by 27%][metadata-shrink].
-    * Much headway was made on ecosystem-wide CI, making it possible
-      to [compare builds for breakage][ci-compare].
-
-[send-rfc]: https://github.com/rust-lang/rfcs/blob/master/text/0458-send-improvements.md
-[scoped]: http://static.rust-lang.org/doc/master/std/thread/fn.scoped.html
-[moar-ufcs]: https://github.com/rust-lang/rust/pull/22172
-[prim-inherent]: https://github.com/rust-lang/rust/pull/23104
-[overflow]: https://github.com/rust-lang/rfcs/blob/master/text/0560-integer-overflow.md
-[metadata-shrink]: https://github.com/rust-lang/rust/pull/22971
-[self-sized]: https://github.com/rust-lang/rust/pull/22301
-[assoc-where]: https://github.com/rust-lang/rust/pull/22512
-[string-pattern]: https://github.com/rust-lang/rust/pull/22466
-[oibit-final]: https://github.com/rust-lang/rust/pull/21689
-[reflect]: https://github.com/rust-lang/rust/pull/23712
-[debug-builder]: https://github.com/rust-lang/rfcs/blob/master/text/0640-debug-improvements.md
-[conversion]: https://github.com/rust-lang/rfcs/pull/529
-[num-traits]: https://github.com/rust-lang/rust/pull/23549
-[index-value]: https://github.com/rust-lang/rust/pull/23601
-[dropck]: https://github.com/rust-lang/rfcs/pull/769
-[fundamental]: https://github.com/rust-lang/rfcs/pull/1023
-[ci-compare]: https://gist.github.com/brson/a30a77836fbec057cbee
-[fn-inherit]: https://github.com/rust-lang/rust/pull/23282
-[fn-blanket]: https://github.com/rust-lang/rust/pull/23895
-[copy-clone]: https://github.com/rust-lang/rust/pull/23860
-[path-normalize]: https://github.com/rust-lang/rust/pull/23229
-
 Version 1.0.0-alpha.2 (February 2015)
 -------------------------------------
 

branches/beta/src/compiletest/compiletest.rs

@@ -31,6 +31,7 @@ extern crate log;
 use std::env;
 use std::fs;
 use std::path::{Path, PathBuf};
+use std::thunk::Thunk;
 use getopts::{optopt, optflag, reqopt};
 use common::Config;
 use common::{Pretty, DebugInfoGdb, DebugInfoLldb, Codegen};
@@ -350,7 +351,7 @@ pub fn make_test_name(config: &Config, testfile: &Path) -> test::TestName {
 pub fn make_test_closure(config: &Config, testfile: &Path) -> test::TestFn {
     let config = (*config).clone();
     let testfile = testfile.to_path_buf();
-    test::DynTestFn(Box::new(move || {
+    test::DynTestFn(Thunk::new(move || {
         runtest::run(config, &testfile)
     }))
 }

branches/beta/src/compiletest/header.rs

@@ -311,7 +311,7 @@ fn parse_exec_env(line: &str) -> Option<(String, String)> {
     parse_name_value_directive(line, "exec-env").map(|nv| {
         // nv is either FOO or FOO=BAR
         let mut strs: Vec<String> = nv
-                                      .splitn(2, '=')
+                                      .splitn(1, '=')
                                       .map(|s| s.to_string())
                                       .collect();
 

branches/beta/src/doc/reference.md

@@ -1648,7 +1648,7 @@ specific type.
 Implementations are defined with the keyword `impl`.
 
 ```
-# #[derive(Copy, Clone)]
+# #[derive(Copy)]
 # struct Point {x: f64, y: f64};
 # type Surface = i32;
 # struct BoundingBox {x: f64, y: f64, width: f64, height: f64};
@@ -1661,10 +1661,6 @@ struct Circle {
 
 impl Copy for Circle {}
 
-impl Clone for Circle {
-    fn clone(&self) -> Circle { *self }
-}
-
 impl Shape for Circle {
     fn draw(&self, s: Surface) { do_draw_circle(s, *self); }
     fn bounding_box(&self) -> BoundingBox {

branches/beta/src/doc/trpl/SUMMARY.md

@@ -43,5 +43,6 @@
     * [Lang items](lang-items.md)
     * [Link args](link-args.md)
     * [Benchmark Tests](benchmark-tests.md)
+    * [Box Syntax and Patterns](box-syntax-and-patterns.md)
 * [Conclusion](conclusion.md)
 * [Glossary](glossary.md)

branches/beta/src/doc/trpl/box-syntax-and-patterns.md

@@ -0,0 +1,100 @@
+%  Box Syntax and Patterns
+
+Currently the only stable way to create a `Box` is via the `Box::new` method.
+Also it is not possible in stable Rust to destructure a `Box` in a match
+pattern. The unstable `box` keyword can be used to both create and destructure
+a `Box`. An example usage would be:
+
+```
+#![feature(box_syntax, box_patterns)]
+
+fn main() {
+    let b = Some(box 5);
+    match b {
+        Some(box n) if n < 0 => {
+            println!("Box contains negative number {}", n);
+        },
+        Some(box n) if n >= 0 => {
+            println!("Box contains non-negative number {}", n);
+        },
+        None => {
+            println!("No box");
+        },
+        _ => unreachable!()
+    }
+}
+```
+
+Note that these features are currently hidden behind the `box_syntax` (box
+creation) and `box_patterns` (destructuring and pattern matching) gates
+because the syntax may still change in the future.
+
+# Returning Pointers
+
+In many languages with pointers, you'd return a pointer from a function
+so as to avoid copying a large data structure. For example:
+
+```{rust}
+struct BigStruct {
+    one: i32,
+    two: i32,
+    // etc
+    one_hundred: i32,
+}
+
+fn foo(x: Box<BigStruct>) -> Box<BigStruct> {
+    Box::new(*x)
+}
+
+fn main() {
+    let x = Box::new(BigStruct {
+        one: 1,
+        two: 2,
+        one_hundred: 100,
+    });
+
+    let y = foo(x);
+}
+```
+
+The idea is that by passing around a box, you're only copying a pointer, rather
+than the hundred `int`s that make up the `BigStruct`.
+
+This is an antipattern in Rust. Instead, write this:
+
+```rust
+#![feature(box_syntax)]
+
+struct BigStruct {
+    one: i32,
+    two: i32,
+    // etc
+    one_hundred: i32,
+}
+
+fn foo(x: Box<BigStruct>) -> BigStruct {
+    *x
+}
+
+fn main() {
+    let x = Box::new(BigStruct {
+        one: 1,
+        two: 2,
+        one_hundred: 100,
+    });
+
+    let y: Box<BigStruct> = box foo(x);
+}
+```
+
+This gives you flexibility without sacrificing performance.
+
+You may think that this gives us terrible performance: return a value and then
+immediately box it up ?! Isn't this pattern the worst of both worlds? Rust is
+smarter than that. There is no copy in this code. `main` allocates enough room
+for the `box`, passes a pointer to that memory into `foo` as `x`, and then
+`foo` writes the value straight into the `Box<T>`.
+
+This is important enough that it bears repeating: pointers are not for
+optimizing returning values from your code. Allow the caller to choose how they
+want to use your output.