Fix for #110795 - Freeze core DOM interfaces

r/sr=jst

dom/public/idl/core/nsIDOMAttr.idl

@@ -40,6 +40,17 @@
 
 #include "nsIDOMNode.idl"
 
+/**
+ * The nsIDOMAttr interface represents an attribute in an "Element" object. 
+ * Typically the allowable values for the attribute are defined in a document 
+ * type definition.
+ * 
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9070-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMAttr : nsIDOMNode
 {

dom/public/idl/core/nsIDOMCDATASection.idl

@@ -40,6 +40,18 @@
 
 #include "nsIDOMText.idl"
 
+/**
+ * CDATA sections are used to escape blocks of text containing characters 
+ * that would otherwise be regarded as markup.
+ * Their primary purpose is for including material such as XML fragments, 
+ * without needing to escape all the delimiters.
+ * 
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9071-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMCDATASection : nsIDOMText
 {

dom/public/idl/core/nsIDOMCharacterData.idl

@@ -40,6 +40,16 @@
 
 #include "nsIDOMNode.idl"
 
+/**
+ * The nsIDOMCharacterData interface extends nsIDOMNode with a set of 
+ * attributes and methods for accessing character data in the DOM.
+ * 
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9072-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMCharacterData : nsIDOMNode
 {

dom/public/idl/core/nsIDOMComment.idl

@@ -40,6 +40,17 @@
 
 #include "nsIDOMCharacterData.idl"
 
+/**
+ * The nsIDOMComment interface inherits from nsIDOMCharacterData and represents 
+ * the content of a comment, i.e., all the characters between the starting 
+ * '<!--' and ending '-->'.
+ * 
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9073-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMComment : nsIDOMCharacterData
 {

dom/public/idl/core/nsIDOMDOMException.idl

@@ -40,6 +40,20 @@
 
 #include "domstubs.idl"
 
+/**
+ * In general, DOM methods return specific error values in ordinary 
+ * processing situations, such as out-of-bound errors.
+ * However, DOM operations can raise exceptions in "exceptional" 
+ * circumstances, i.e., when an operation is impossible to perform 
+ * (either for logical reasons, because data is lost, or because the 
+ * implementation has become unstable)
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf910a-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMDOMException : nsISupports
 {

dom/public/idl/core/nsIDOMDOMImplementation.idl

@@ -40,6 +40,17 @@
 
 #include "domstubs.idl"
 
+/**
+ * The nsIDOMDOMImplementation interface provides a number of methods for 
+ * performing operations that are independent of any particular instance 
+ * of the document object model.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9074-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMDOMImplementation : nsISupports
 {

dom/public/idl/core/nsIDOMDocument.idl

@@ -40,6 +40,21 @@
 
 #include "nsIDOMNode.idl"
 
+/**
+ * The nsIDOMDocument interface represents the entire HTML or XML document.
+ * Conceptually, it is the root of the document tree, and provides the 
+ * primary access to the document's data.
+ * Since elements, text nodes, comments, processing instructions, etc. 
+ * cannot exist outside the context of a Document, the nsIDOMDocument 
+ * interface also contains the factory methods needed to create these 
+ * objects.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9075-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMDocument : nsIDOMNode
 {

dom/public/idl/core/nsIDOMDocumentFragment.idl

@@ -39,6 +39,17 @@
  * ***** END LICENSE BLOCK ***** */
 
 #include "nsIDOMNode.idl"
+    
+/**
+ * DocumentFragment is a "lightweight" or "minimal" Document object.
+ * nsIDOMDocumentFragment is used in situations where the Document
+ * interface can potentially be a heavyweight interface.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
 
 [scriptable, uuid(a6cf9076-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMDocumentFragment : nsIDOMNode

dom/public/idl/core/nsIDOMDocumentType.idl

@@ -39,6 +39,18 @@
  * ***** END LICENSE BLOCK ***** */
 
 #include "nsIDOMNode.idl"
+     
+/**
+ * Each Document has a doctype attribute whose value is either null 
+ * or a DocumentType object. 
+ * The nsIDOMDocumentType interface in the DOM Core provides an 
+ * interface to the list of entities that are defined for the document.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
 
 [scriptable, uuid(a6cf9077-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMDocumentType : nsIDOMNode

dom/public/idl/core/nsIDOMElement.idl

@@ -40,6 +40,16 @@
 
 #include "nsIDOMNode.idl"
 
+/**
+ * The nsIDOMElement interface represents an element in an HTML or 
+ * XML document. 
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9078-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMElement : nsIDOMNode
 {

dom/public/idl/core/nsIDOMEntity.idl

@@ -40,6 +40,16 @@
 
 #include "nsIDOMNode.idl"
 
+/**
+ * The nsIDOMEntity interface represents an entity, either parsed 
+ * or unparsed, in an XML document.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9079-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMEntity : nsIDOMNode
 {

dom/public/idl/core/nsIDOMEntityReference.idl

@@ -40,6 +40,16 @@
 
 #include "nsIDOMNode.idl"
 
+/**
+ * nsIDOMEntityReference is an interface to a node that represents a 
+ * reference to one of the entities defined in the document.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf907a-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMEntityReference : nsIDOMNode
 {

dom/public/idl/core/nsIDOMNamedNodeMap.idl

@@ -40,6 +40,16 @@
 
 #include "domstubs.idl"
 
+/**
+ * Objects implementing the nsIDOMNamedNodeMap interface are used to 
+ * represent collections of nodes that can be accessed by name.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf907b-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMNamedNodeMap : nsISupports
 {

dom/public/idl/core/nsIDOMNode.idl

@@ -40,6 +40,17 @@
 
 #include "domstubs.idl"
 
+/**
+ * The nsIDOMNode interface is the primary datatype for the entire 
+ * Document Object Model.
+ * It represents a single node in the document tree.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf907c-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMNode : nsISupports
 {

dom/public/idl/core/nsIDOMNodeList.idl

@@ -40,6 +40,18 @@
 
 #include "domstubs.idl"
 
+/**
+ * The nsIDOMNodeList interface provides the abstraction of an ordered 
+ * collection of nodes, without defining or constraining how this collection 
+ * is implemented.
+ * The items in the list are accessible via an integral index, starting from 0.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf907d-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMNodeList : nsISupports
 {

dom/public/idl/core/nsIDOMNotation.idl

@@ -40,6 +40,17 @@
 
 #include "nsIDOMNode.idl"
 
+/**
+ * The nsIDOMNotation interface represents a notation declared in the DTD.
+ * A notation  either declares, by name, the format of an unparsed entity, 
+ * or is used for formal declaration of processing instruction targets.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf907e-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMNotation : nsIDOMNode
 {

dom/public/idl/core/nsIDOMProcessingInstruction.idl

@@ -40,6 +40,17 @@
 
 #include "nsIDOMNode.idl"
 
+/**
+ * The nsIDOMProcessingInstruction interface represents a 
+ * "processing instruction", used in XML as a way to keep processor-specific 
+ * information in the text of the document.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf907f-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMProcessingInstruction : nsIDOMNode
 {

dom/public/idl/core/nsIDOMText.idl

@@ -40,6 +40,16 @@
 
 #include "nsIDOMCharacterData.idl"
 
+/**
+ * The nsIDOMText interface inherits from nsIDOMCharacterData and represents 
+ * the textual content (termed character data in XML) of an Element or Attr.
+ *
+ * For more information on this interface please see 
+ * http://www.w3.org/TR/DOM-Level-2-Core/
+ *
+ * @status FROZEN
+ */
+
 [scriptable, uuid(a6cf9082-15b3-11d2-932e-00805f8add32)]
 interface nsIDOMText : nsIDOMCharacterData
 {