diff --git a/mozilla/base/src/nsIOutputStream.h b/mozilla/base/src/nsIOutputStream.h
index b044cb780cd..182b212a390 100644
--- a/mozilla/base/src/nsIOutputStream.h
+++ b/mozilla/base/src/nsIOutputStream.h
@@ -15,6 +15,7 @@
  * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
  * Reserved.
  */
+
 #ifndef nsIOutputStream_h___
 #define nsIOutputStream_h___
 
@@ -32,8 +33,8 @@ public:
     static const nsIID& GetIID() { static nsIID iid = NS_IOUTPUTSTREAM_IID; return iid; }
 
     /** Write data into the stream.
-     *  @param aBuf the buffer into which the data is read
-     *  @param aCount the maximum number of bytes to read
+     *  @param aBuf the buffer from which the data is read
+     *  @param aCount the maximum number of bytes to write
      *  @param aWriteCount out parameter to hold the number of
      *         bytes written. if an error occurs, the writecount
      *         is undefined
diff --git a/mozilla/xpcom/ds/nsICollection.h b/mozilla/xpcom/ds/nsICollection.h
index f79d46db4a6..5d4d166e735 100644
--- a/mozilla/xpcom/ds/nsICollection.h
+++ b/mozilla/xpcom/ds/nsICollection.h
@@ -50,13 +50,18 @@ public:
    */
   NS_IMETHOD_(PRUint32) Count(void) const = 0;
 
-  /** AddItem will take an ISupports and keep track of it 
-   *  @param aItem is the Item to be added WILL BE ADDREFFED
+  /**
+   * AppendElement will take an ISupports and keep track of it 
+   * @param aItem is the Item to be added WILL BE ADDREFFED
+   * @return NS_OK if successfully added
+   * @return NS_ERROR_FAILURE otherwise
    */
   NS_IMETHOD AppendElement(nsISupports *aItem) = 0;
 
-  /** RemoveItem will take an nsISupports and remove it from the collection
-   *  @param aItem is the item to be removed  WILL BE RELEASED
+  /** RemoveElement will take an nsISupports and remove it from the collection
+   * @param aItem is the item to be removed  WILL BE RELEASED
+   * @return NS_OK if successfully added
+   * @return NS_ERROR_FAILURE otherwise
    */
   NS_IMETHOD RemoveElement(nsISupports *aItem) = 0;
 
diff --git a/mozilla/xpcom/io/nsIOutputStream.h b/mozilla/xpcom/io/nsIOutputStream.h
index b044cb780cd..182b212a390 100644
--- a/mozilla/xpcom/io/nsIOutputStream.h
+++ b/mozilla/xpcom/io/nsIOutputStream.h
@@ -15,6 +15,7 @@
  * Copyright (C) 1998 Netscape Communications Corporation.  All Rights
  * Reserved.
  */
+
 #ifndef nsIOutputStream_h___
 #define nsIOutputStream_h___
 
@@ -32,8 +33,8 @@ public:
     static const nsIID& GetIID() { static nsIID iid = NS_IOUTPUTSTREAM_IID; return iid; }
 
     /** Write data into the stream.
-     *  @param aBuf the buffer into which the data is read
-     *  @param aCount the maximum number of bytes to read
+     *  @param aBuf the buffer from which the data is read
+     *  @param aCount the maximum number of bytes to write
      *  @param aWriteCount out parameter to hold the number of
      *         bytes written. if an error occurs, the writecount
      *         is undefined
diff --git a/mozilla/xpcom/public/nsICollection.h b/mozilla/xpcom/public/nsICollection.h
index f79d46db4a6..5d4d166e735 100644
--- a/mozilla/xpcom/public/nsICollection.h
+++ b/mozilla/xpcom/public/nsICollection.h
@@ -50,13 +50,18 @@ public:
    */
   NS_IMETHOD_(PRUint32) Count(void) const = 0;
 
-  /** AddItem will take an ISupports and keep track of it 
-   *  @param aItem is the Item to be added WILL BE ADDREFFED
+  /**
+   * AppendElement will take an ISupports and keep track of it 
+   * @param aItem is the Item to be added WILL BE ADDREFFED
+   * @return NS_OK if successfully added
+   * @return NS_ERROR_FAILURE otherwise
    */
   NS_IMETHOD AppendElement(nsISupports *aItem) = 0;
 
-  /** RemoveItem will take an nsISupports and remove it from the collection
-   *  @param aItem is the item to be removed  WILL BE RELEASED
+  /** RemoveElement will take an nsISupports and remove it from the collection
+   * @param aItem is the item to be removed  WILL BE RELEASED
+   * @return NS_OK if successfully added
+   * @return NS_ERROR_FAILURE otherwise
    */
   NS_IMETHOD RemoveElement(nsISupports *aItem) = 0;