---

yaml
---
r: 7727
b: refs/heads/snap-stage3
c: 04351a8
h: refs/heads/master
i:
  7725: 3352604
  7723: 1b25232
  7719: b795a96
  7711: dfbf04b
v: v3

Author: brson

[refs]

@@ -1,6 +1,6 @@
 ---
 refs/heads/master: 2898dcc5d97da9427ac367542382b6239d9c0bbf
 refs/heads/snap-stage1: e33de59e47c5076a89eadeb38f4934f58a3618a6
-refs/heads/snap-stage3: ef941998bea47c601adbb4af03beda98412aee6d
+refs/heads/snap-stage3: 04351a84ca342f4580e40b9c195b5403b864090b
 refs/heads/try: 2898dcc5d97da9427ac367542382b6239d9c0bbf
 refs/tags/release-0.1: 1f5c5126e96c79d22cb7862f75304136e204f105

branches/snap-stage3/src/libcore/comm.rs

@@ -1,21 +1,25 @@
 #[doc(
   brief = "Communication between tasks",
-  desc  = "Communication between tasks is facilitated by ports (in the \
-           receiving task), and channels (in the sending task). Any \
-           number of channels may feed into a single port. \
-           Ports and channels may only transmit values of unique \
-           types; that is, values that are statically guaranteed to \
-           be accessed by a single 'owner' at a time.  Unique types \
-           include scalars, vectors, strings, and records, tags, \
-           tuples and unique boxes (~T) thereof. Most notably, \
-           shared boxes (@T) may not be transmitted across channels. \
-           Example: \
-               let p = comm::port(); \
-               task::spawn(comm::chan(p), fn (c: chan<str>) { \
-                   comm::send(c, \"Hello, World\"); \
-               }); \
-               io::println(comm::recv(p));"
-)];
+  desc  = "
+
+Communication between tasks is facilitated by ports (in the receiving
+task), and channels (in the sending task). Any number of channels may
+feed into a single port.  Ports and channels may only transmit values
+of unique types; that is, values that are statically guaranteed to be
+accessed by a single 'owner' at a time.  Unique types include scalars,
+vectors, strings, and records, tags, tuples and unique boxes (`~T`)
+thereof. Most notably, shared boxes (`@T`) may not be transmitted
+across channels.
+
+Example:
+
+    let p = comm::port();
+    task::spawn(comm::chan(p), fn (c: chan<str>) {
+        comm::send(c, \"Hello, World\");
+    });
+    io::println(comm::recv(p));
+
+")];
 
 import sys;
 import task;