diff --git a/utils/TableGen/Record.h b/utils/TableGen/Record.h
index d8a96495e76..95c50aea7fe 100644
--- a/utils/TableGen/Record.h
+++ b/utils/TableGen/Record.h
@@ -125,7 +125,8 @@ struct BitRecTy : public RecTy {
 };
 
 
-/// BitsRecTy - 'bits<n>' - Represent a fixed number of bits
+// BitsRecTy - 'bits<n>' - Represent a fixed number of bits
+/// BitsRecTy - 'bits&lt;n&gt;' - Represent a fixed number of bits
 ///
 class BitsRecTy : public RecTy {
   unsigned Size;
@@ -188,8 +189,10 @@ struct StringRecTy : public RecTy {
   virtual bool baseClassOf(const StringRecTy *RHS) const { return true; }
 };
 
-/// ListRecTy - 'list<Ty>' - Represent a list of values, all of which must be of
-/// the specified type.
+// ListRecTy - 'list<Ty>' - Represent a list of values, all of which must be of
+// the specified type.
+/// ListRecTy - 'list&lt;Ty&gt;' - Represent a list of values, all of which must
+/// be of the specified type.
 ///
 class ListRecTy : public RecTy {
   RecTy *Ty;
@@ -244,7 +247,7 @@ struct DagRecTy : public RecTy {
 };
 
 
-/// RecordRecTy - '<classname>' - Represent an instance of a class, such as:
+/// RecordRecTy - '[classname]' - Represent an instance of a class, such as:
 /// (R32 X = EAX).
 ///
 class RecordRecTy : public RecTy {