Bug 737814 - Mark nsIHTMLContentSink as obsolete. r=smaug. DONTBUILD

content/html/document/src/nsHTMLContentSink.cpp

@@ -40,6 +40,12 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/**
+ * This file is near-OBSOLETE. It is used for about:blank only and for the
+ * HTML element factory.
+ * Don't bother adding new stuff in this file.
+ */
+
 #include "mozilla/Util.h"
 
 #include "nsContentSink.h"
@@ -155,6 +161,10 @@ static const contentCreatorCallback sContentCreatorCallbacks[] = {
 class SinkContext;
 class HTMLContentSink;
 
+/**
+ * This class is near-OBSOLETE. It is used for about:blank only.
+ * Don't bother adding new stuff in this file.
+ */
 class HTMLContentSink : public nsContentSink,
 #ifdef DEBUG
                         public nsIDebugDumpContent,

parser/htmlparser/public/nsIHTMLContentSink.h

@@ -38,6 +38,9 @@
 #define nsIHTMLContentSink_h___
 
 /**
+ * This interface is OBSOLETE and in the process of being REMOVED.
+ * Do NOT implement!
+ *
  * This file declares the concrete HTMLContentSink class.
  * This class is used during the parsing process as the
  * primary interface between the parser and the content
@@ -88,6 +91,10 @@
 
 #define MAX_REFLOW_DEPTH  200
 
+/**
+ * This interface is OBSOLETE and in the process of being REMOVED.
+ * Do NOT implement!
+ */
 class nsIHTMLContentSink : public nsIContentSink 
 {
 public: