Adding more information about the behavior of Arc/Rc

when you perform a clone() call.

2 files changed, 5 insertions, 1 deletions

diff --git a/src/liballoc/arc.rs b/src/liballoc/arc.rs
index b5d16d29272..b012612af59 100644
--- a/src/liballoc/arc.rs
+++ b/src/liballoc/arc.rs
@@ -94,6 +94,9 @@ use heap::deallocate;
 /// With simple pipes, without `Arc`, a copy would have to be made for each
 /// task.
 ///
+/// When you clone an `Arc<T>`, it will create another pointer to the data and
+/// increase the reference counter.
+///
 /// ```
 /// # #![feature(alloc, core)]
 /// use std::sync::Arc;
diff --git a/src/liballoc/rc.rs b/src/liballoc/rc.rs
index eb3c5c16726..085042ce5a7 100644
--- a/src/liballoc/rc.rs
+++ b/src/liballoc/rc.rs
@@ -431,7 +431,8 @@ impl<T> Clone for Rc<T> {
 
     /// Makes a clone of the `Rc<T>`.
     ///
-    /// This increases the strong reference count.
+    /// When you clone an `Rc<T>`, it will create another pointer to the data and
+    /// increase the strong reference counter.
     ///
     /// # Examples
     ///