---

yaml
---
r: 13022
b: refs/heads/master
c: 30f8555
h: refs/heads/master
v: v3

Author: eholk

[refs]

@@ -1,5 +1,5 @@
 ---
-refs/heads/master: 5b72e52e472ca06f42700a322dc2cac4c38e05f1
+refs/heads/master: 30f8555544481e998f52d196c5a0f4d04cbcf334
 refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
 refs/heads/snap-stage3: 4a81779abd786ff22d71434c6d9a5917ea4cdfff
 refs/heads/try: 2898dcc5d97da9427ac367542382b6239d9c0bbf

trunk/src/libstd/arc.rs

@@ -1,5 +1,5 @@
-#[doc = "An atomically reference counted wrapper that can be used
-hare immutable data between tasks."]
+#[doc = "An atomically reference counted wrapper that can be used to
+share immutable data between tasks."]
 
 export arc, get, clone;
 
@@ -34,6 +34,7 @@ resource arc_destruct<T>(data: *arc_data<T>) {
 
 type arc<T> = arc_destruct<T>;
 
+#[doc="Create an atomically reference counted wrapper."]
 fn arc<T>(-data: T) -> arc<T> {
     let data = ~{mut count: 1, data: data};
     unsafe {
@@ -43,12 +44,19 @@ fn arc<T>(-data: T) -> arc<T> {
     }
 }
 
+#[doc="Access the underlying data in an atomically reference counted
+ wrapper."]
 fn get<T>(rc: &a.arc<T>) -> &a.T {
     unsafe {
         &(***rc).data
     }
 }
 
+#[doc="Duplicate an atomically reference counted wrapper.
+
+The resulting two `arc` objects will point to the same underlying data
+object. However, one of the `arc` objects can be sent to another task,
+allowing them to share the underlying data."]
 fn clone<T>(rc: &arc<T>) -> arc<T> {
     let data = **rc;
     unsafe {