additional comment tweaks for bug 157133 "freeze nsIHttpChannel,

nsIHttpHeaderVisitor" r/sr=nobody


git-svn-id: svn://10.0.0.236/trunk@134727 18797224-902f-48f8-a5cc-f745e15eee43

mozilla/netwerk/protocol/http/public/Makefile.in

@@ -29,10 +29,13 @@ include $(DEPTH)/config/autoconf.mk
 MODULE = necko
 XPIDL_MODULE = necko_http
 
-XPIDLSRCS	= \
+SDK_XPIDLSRCS   = \
 		nsIHttpChannel.idl \
-		nsIHttpChannelInternal.idl \
 		nsIHttpHeaderVisitor.idl \
+		$(NULL)
+
+XPIDLSRCS	= \
+		nsIHttpChannelInternal.idl \
 		nsIHttpNotify.idl \
 		nsIHttpProtocolHandler.idl \
 		nsIHttpEventSink.idl \

mozilla/netwerk/protocol/http/public/nsIHttpHeaderVisitor.idl

@@ -18,21 +18,29 @@
  * Rights Reserved.
  * 
  * Contributor(s): 
- *   Gagan Saksena <gagan@netscape.com> (original author) 
- *   Darin Fisher <darin@netscape.com>
+ *   Darin Fisher <darin@netscape.com> (original author)
  */
 
 #include "nsISupports.idl"
+
 /**
  * Implement this interface to visit http headers.
  *
- * @status UNDER_REVIEW
+ * @status FROZEN
  */
 [scriptable, uuid(0cf40717-d7c1-4a94-8c1e-d6c9734101bb)]
 interface nsIHttpHeaderVisitor : nsISupports
 {
     /**
+     * Called by the nsIHttpChannel implementation when visiting request and
+     * response headers.
+     *
+     * @param aHeader
+     *        the header being visited.
+     * @param aValue
+     *        the header value (possibly a comma delimited list).
+     *
      * @throw any exception to terminate enumeration
      */
-    void visitHeader(in ACString header, in ACString value);
+    void visitHeader(in ACString aHeader, in ACString aValue);
 };