Add doc example for `OsString::into_boxed_os_str`.

diff --git a/src/libstd/ffi/os_str.rs b/src/libstd/ffi/os_str.rs
index 9da6eca34086e01a879acdeef4096439f224ef57..b0f79f9a395a67a7584269764c23aeca77b04c64 100644 (file)
--- a/src/libstd/ffi/os_str.rs
+++ b/src/libstd/ffi/os_str.rs
@@ -248,6 +248,18 @@ pub fn shrink_to_fit(&mut self) {
     }
 
     /// Converts this `OsString` into a boxed `OsStr`.
+    ///
+    /// # Examples
+    ///
+    /// ```
+    /// #![feature(into_boxed_os_str)]
+    ///
+    /// use std::ffi::{OsString, OsStr};
+    ///
+    /// let s = OsString::from("hello");
+    ///
+    /// let b: Box<OsStr> = s.into_boxed_os_str();
+    /// ```
     #[unstable(feature = "into_boxed_os_str", issue = "0")]
     pub fn into_boxed_os_str(self) -> Box<OsStr> {
         unsafe { mem::transmute(self.inner.into_box()) }