diff --git a/mozilla/xpcom/ds/nsISupportsPrimitives.idl b/mozilla/xpcom/ds/nsISupportsPrimitives.idl
index f84ea117f27..d1cabc4d9ff 100644
--- a/mozilla/xpcom/ds/nsISupportsPrimitives.idl
+++ b/mozilla/xpcom/ds/nsISupportsPrimitives.idl
@@ -69,6 +69,10 @@ interface nsISupportsPrimitive : nsISupports
     readonly attribute unsigned short type;
 };
 
+/**
+ * Scriptable storage for nsID structures
+ */
+
 [scriptable, uuid(d18290a0-4a1c-11d3-9890-006008962422)]
 interface nsISupportsID : nsISupportsPrimitive
 {
@@ -76,6 +80,12 @@ interface nsISupportsID : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for ASCII strings
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(d65ff270-4a1c-11d3-9890-006008962422)]
 interface nsISupportsCString : nsISupportsPrimitive
 {
@@ -83,6 +93,12 @@ interface nsISupportsCString : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for Unicode strings
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(d79dc970-4a1c-11d3-9890-006008962422)]
 interface nsISupportsString : nsISupportsPrimitive
 {
@@ -94,6 +110,12 @@ interface nsISupportsString : nsISupportsPrimitive
  * The rest are truly primitive and are passed by value
  */ 
 
+/**
+ * Scriptable storage for booleans
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(ddc3b490-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRBool : nsISupportsPrimitive
 {
@@ -101,6 +123,12 @@ interface nsISupportsPRBool : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for 8-bit integers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(dec2e4e0-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRUint8 : nsISupportsPrimitive
 {
@@ -108,6 +136,12 @@ interface nsISupportsPRUint8 : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for unsigned 16-bit integers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(dfacb090-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRUint16 : nsISupportsPrimitive
 {
@@ -115,6 +149,12 @@ interface nsISupportsPRUint16 : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for unsigned 32-bit integers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(e01dc470-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRUint32 : nsISupportsPrimitive
 {
@@ -122,6 +162,12 @@ interface nsISupportsPRUint32 : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for 64-bit integers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(e13567c0-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRUint64 : nsISupportsPrimitive
 {
@@ -129,6 +175,12 @@ interface nsISupportsPRUint64 : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for NSPR date/time values
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(e2563630-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRTime : nsISupportsPrimitive
 {
@@ -136,6 +188,13 @@ interface nsISupportsPRTime : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for single character values
+ * (often used to store an ASCII character)
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(e2b05e40-4a1c-11d3-9890-006008962422)]
 interface nsISupportsChar : nsISupportsPrimitive
 {
@@ -143,6 +202,12 @@ interface nsISupportsChar : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for 16-bit integers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(e30d94b0-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRInt16 : nsISupportsPrimitive
 {
@@ -150,6 +215,12 @@ interface nsISupportsPRInt16 : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for 32-bit integers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(e36c5250-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRInt32 : nsISupportsPrimitive
 {
@@ -157,6 +228,12 @@ interface nsISupportsPRInt32 : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for 64-bit integers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(e3cb0ff0-4a1c-11d3-9890-006008962422)]
 interface nsISupportsPRInt64 : nsISupportsPrimitive
 {
@@ -164,6 +241,12 @@ interface nsISupportsPRInt64 : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for floating point numbers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(abeaa390-4ac0-11d3-baea-00805f8a5dd7)]
 interface nsISupportsFloat : nsISupportsPrimitive
 {
@@ -171,6 +254,12 @@ interface nsISupportsFloat : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for doubles
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(b32523a0-4ac0-11d3-baea-00805f8a5dd7)]
 interface nsISupportsDouble : nsISupportsPrimitive
 {
@@ -178,6 +267,12 @@ interface nsISupportsDouble : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for generic pointers
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(464484f0-568d-11d3-baf8-00805f8a5dd7)]
 interface nsISupportsVoid : nsISupportsPrimitive
 {
@@ -185,6 +280,12 @@ interface nsISupportsVoid : nsISupportsPrimitive
     string toString();
 };
 
+/**
+ * Scriptable storage for other XPCOM objects
+ * 
+ * @status UNDER_REVIEW
+ */
+
 [scriptable, uuid(995ea724-1dd1-11b2-9211-c21bdd3e7ed0)]
 interface nsISupportsInterfacePointer : nsISupportsPrimitive
 {