---

yaml
---
r: 236299
b: refs/heads/master
c: b30d896
h: refs/heads/master
i:
  236297: 6114453
  236295: ef6e34e
v: v3

Author: alevy

[refs]

@@ -1,5 +1,5 @@
 ---
-refs/heads/master: 85f48d300a1161338e14b9579007b003c48dc4ba
+refs/heads/master: b30d8969e86fa2c9dd3b8e2e28ddda2202331f0f
 refs/heads/snap-stage3: 1af31d4974e33027a68126fa5a5a3c2c6491824f
 refs/heads/try: ea3892f76a2180dd4ce724f1dafd9186959702d9
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105

trunk/src/libcore/array.rs

@@ -35,6 +35,15 @@ use slice::{Iter, IterMut, SliceExt};
 ///
 /// This trait can be used to implement other traits on fixed-size arrays
 /// without causing much metadata bloat.
+///
+/// The trait is marked unsafe in order to restrict implementors to fixed-size
+/// arrays. User of this trait can assume that implementors have the exact
+/// layout in memory of a fixed size array (for example, for unsafe
+/// initialization).
+///
+/// Note that the traits AsRef and AsMut provide similar methods for types that
+/// may not be fixed-size arrays. Implementors should prefer those traits
+/// instead.
 pub unsafe trait FixedSizeArray<T> {
     /// Converts the array to immutable slice
     fn as_slice(&self) -> &[T];