Move simd out of unstable

It's still marked experimental. Also add documentation.

Author: emberian

src/libstd/lib.rs

@@ -238,6 +238,8 @@ pub mod io;
 pub mod path;
 pub mod fmt;
 pub mod cleanup;
+#[experimental]
+pub mod simd;
 
 /* Unsupported interfaces */
 

src/libstd/unstable/simd.rs renamed to src/libstd/simd.rs

@@ -1,4 +1,4 @@
-// Copyright 2013 The Rust Project Developers. See the COPYRIGHT
+// Copyright 2014 The Rust Project Developers. See the COPYRIGHT
 // file at the top-level directory of this distribution and at
 // http://rust-lang.org/COPYRIGHT.
 //
@@ -8,54 +8,88 @@
 // option. This file may not be copied, modified, or distributed
 // except according to those terms.
 
-//! SIMD vectors
+//! SIMD vectors.
+//!
+//! These types can be used for accessing basic SIMD operations. Each of them
+//! implements the standard arithmetic operator traits (Add, Sub, Mul, Div,
+//! Rem, Shl, Shr) through compiler magic, rather than explicitly. Currently
+//! comparison operators are not implemented. To use SSE3+, you must enable
+//! the features, like `-C target-feature=sse3,sse4.1,sse4.2`, or a more
+//! specific `target-cpu`. No other SIMD intrinsics or high-level wrappers are
+//! provided beyond this module.
+//!
+//! ```rust
+//! #[allow(experimental)];
+//!
+//! fn main() {
+//!     use std::simd::f32x4;
+//!     let a = f32x4(40.0, 41.0, 42.0, 43.0);
+//!     let b = f32x4(1.0, 1.1, 3.4, 9.8);
+//!     println!("{}", a + b);
+//! }
+//! ```
+//!
+//! ## Stability Note
+//!
+//! These are all experimental. The inferface may change entirely, without
+//! warning.
 
 #![allow(non_camel_case_types)]
+#![allow(missing_doc)]
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct i8x16(pub i8, pub i8, pub i8, pub i8,
                  pub i8, pub i8, pub i8, pub i8,
                  pub i8, pub i8, pub i8, pub i8,
                  pub i8, pub i8, pub i8, pub i8);
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct i16x8(pub i16, pub i16, pub i16, pub i16,
                  pub i16, pub i16, pub i16, pub i16);
-
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct i32x4(pub i32, pub i32, pub i32, pub i32);
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct i64x2(pub i64, pub i64);
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct u8x16(pub u8, pub u8, pub u8, pub u8,
                  pub u8, pub u8, pub u8, pub u8,
                  pub u8, pub u8, pub u8, pub u8,
                  pub u8, pub u8, pub u8, pub u8);
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct u16x8(pub u16, pub u16, pub u16, pub u16,
                  pub u16, pub u16, pub u16, pub u16);
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct u32x4(pub u32, pub u32, pub u32, pub u32);
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct u64x2(pub u64, pub u64);
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct f32x4(pub f32, pub f32, pub f32, pub f32);
 
-#[experimental]
 #[simd]
+#[experimental]
+#[deriving(Show)]
 pub struct f64x2(pub f64, pub f64);

src/libstd/unstable/mod.rs

@@ -16,7 +16,7 @@ pub use core::finally;
 
 pub mod dynamic_lib;
 
-pub mod simd;
+pub mod finally;
 pub mod sync;
 pub mod mutex;
 

src/test/compile-fail/simd-experimental.rs

@@ -10,7 +10,7 @@
 
 #![deny(experimental)]
 
-use std::unstable::simd;
+use std::simd;
 
 fn main() {
     let _ = simd::i64x2(0, 0); //~ ERROR: experimental

src/test/run-pass/simd-binop.rs

@@ -10,7 +10,7 @@
 
 #![allow(experimental)]
 
-use std::unstable::simd::{i32x4, f32x4, u32x4};
+use std::simd::{i32x4, f32x4, u32x4};
 
 fn eq_u32x4(u32x4(x0, x1, x2, x3): u32x4, u32x4(y0, y1, y2, y3): u32x4) -> bool {
     (x0 == y0) && (x1 == y1) && (x2 == y2) && (x3 == y3)

src/test/run-pass/simd-issue-10604.rs

@@ -13,5 +13,5 @@
 #![feature(simd)]
 
 pub fn main() {
-    let _o = None::<std::unstable::simd::i32x4>;
+    let _o = None::<std::simd::i32x4>;
 }