1.1 --- a/BLIP/BLIPMessage.h	Fri May 23 17:37:36 2008 -0700
     1.2 +++ b/BLIP/BLIPMessage.h	Sat May 24 17:25:06 2008 -0700
     1.3 @@ -31,7 +31,7 @@
     1.4  };
     1.5  
     1.6  
     1.7 -/** Abstract superclass for both requests and responses. */
     1.8 +/** Abstract superclass for BLIP requests and responses. */
     1.9  @interface BLIPMessage : NSObject 
    1.10  {
    1.11      BLIPConnection *_connection;
    1.12 @@ -65,12 +65,12 @@
    1.13  /** Has the entire message, including the body, arrived? */
    1.14  @property (readonly) BOOL complete;
    1.15  
    1.16 -/** Should the message body be compressed using gzip?
    1.17 -    This property can only be set before sending the message. */
    1.18 +/** Should the message body be compressed with gzip?
    1.19 +    This property can only be set <i>before</i> sending the message. */
    1.20  @property BOOL compressed;
    1.21  
    1.22  /** Should the message be sent ahead of normal-priority messages?
    1.23 -    This property can only be set before sending the message. */
    1.24 +    This property can only be set <i>before</i> sending the message. */
    1.25  @property BOOL urgent;
    1.26  
    1.27  /** Can this message be changed? (Only true for outgoing messages, before you send them.) */
    1.28 @@ -84,7 +84,8 @@
    1.29  
    1.30  #pragma mark PROPERTIES:
    1.31  
    1.32 -/** The message's properties, a dictionary-like object. */
    1.33 +/** The message's properties, a dictionary-like object.
    1.34 +    Message properties are much like the headers in HTTP, MIME and RFC822. */
    1.35  @property (readonly) BLIPProperties* properties;
    1.36  
    1.37  /** Mutable version of the message's properties; only available if this mesage is mutable. */