diff --git a/src/libcore/char.rs b/src/libcore/char.rs
index b92536db99466..2c46c652cd07c 100644
--- a/src/libcore/char.rs
+++ b/src/libcore/char.rs
@@ -140,7 +140,7 @@ pure fn to_upper(c: char) -> char {
 
 #[doc(
   brief =  "Compare two chars.",
-  return = "-1 if a<b, 0 if a==b, +1 if a>b"
+  return = "-1 if a<b, 0 if a==b, +1 if a>b"
 )]
 pure fn cmp(a: char, b: char) -> int {
     ret  if b > a { -1 }
diff --git a/src/libcore/comm.rs b/src/libcore/comm.rs
index 1976e4b9c1a18..f9e95edf5e299 100644
--- a/src/libcore/comm.rs
+++ b/src/libcore/comm.rs
@@ -11,7 +11,7 @@
            shared boxes (@T) may not be transmitted across channels. \
            Example: \
                let p = comm::port(); \
-               task::spawn(comm::chan(p), fn (c: chan&lt;str>) { \
+               task::spawn(comm::chan(p), fn (c: chan<str>) { \
                    comm::send(c, \"Hello, World\"); \
                }); \
                io::println(comm::recv(p));"
@@ -87,7 +87,7 @@ resource port_ptr<T: send>(po: *rustrt::rust_port) {
   desc = "Each port has a unique per-task identity and may not \
           be replicated or transmitted. If a port value is \
           copied, both copies refer to the same port. \
-          Ports may be associated with multiple &lt;chan>s."
+          Ports may be associated with multiple <chan>s."
 )]
 tag port<T: send> { port_t(@port_ptr<T>); }