File comments that show up in LXR and provide a quick summary of what's in each file.

layout/style/nsCSSAnonBoxList.h

@@ -36,6 +36,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* atom list for CSS anonymous boxes */
+
 /*
  * This file contains the list of nsIAtoms and their values for CSS
  * pseudo-element-ish things used internally for anonymous boxes.  It is

layout/style/nsCSSAnonBoxes.cpp

@@ -35,6 +35,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* atom list for CSS anonymous boxes */
+
 #include "nsCSSAnonBoxes.h"
 #include "nsAtomListUtils.h"
 #include "nsStaticAtom.h"

layout/style/nsCSSAnonBoxes.h

@@ -35,6 +35,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* atom list for CSS anonymous boxes */
+
 #ifndef nsCSSAnonBoxes_h___
 #define nsCSSAnonBoxes_h___
 

layout/style/nsCSSDataBlock.cpp

@@ -35,6 +35,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * compact representation of the property-value pairs within a CSS
+ * declaration, and the code for expanding and compacting it
+ */
+
 #include "nsCSSDataBlock.h"
 #include "nsCSSProps.h"
 #include "nsRuleData.h"

layout/style/nsCSSDataBlock.h

@@ -33,6 +33,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * compact representation of the property-value pairs within a CSS
+ * declaration, and the code for expanding and compacting it
+ */
+
 #ifndef nsCSSDataBlock_h__
 #define nsCSSDataBlock_h__
 

layout/style/nsCSSDeclaration.cpp

@@ -36,6 +36,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * representation of a declaration block (or style attribute) in a CSS
+ * stylesheet
+ */
+
 #include "nscore.h"
 #include "nsCSSDeclaration.h"
 #include "nsString.h"

layout/style/nsCSSDeclaration.h

@@ -35,6 +35,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * representation of a declaration block (or style attribute) in a CSS
+ * stylesheet
+ */
+
 #ifndef nsCSSDeclaration_h___
 #define nsCSSDeclaration_h___
 

layout/style/nsCSSKeywordList.h

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* keywords used within CSS property values */
+
 /******
 
   This file contains the list of all parsed CSS keywords

layout/style/nsCSSKeywords.cpp

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* keywords used within CSS property values */
+
 #include "nsCSSKeywords.h"
 #include "nsString.h"
 #include "nsStaticNameTable.h"

layout/style/nsCSSKeywords.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* keywords used within CSS property values */
+
 #ifndef nsCSSKeywords_h___
 #define nsCSSKeywords_h___
 

layout/style/nsCSSLoader.cpp

@@ -44,6 +44,9 @@
  * Date             Modified by     Description of modification
  * 04/20/2000       IBM Corp.      OS/2 VisualAge build.
  */
+
+/* loading of CSS style sheets using the network APIs */
+
 #include "nsCSSLoader.h"
 #include "nsIContent.h"
 #include "nsIDOMNode.h"

layout/style/nsCSSLoader.h

@@ -46,6 +46,8 @@
  * 04/20/2000       IBM Corp.      OS/2 VisualAge build.
  */
 
+/* loading of CSS style sheets using the network APIs */
+
 #ifndef nsCSSLoader_h__
 #define nsCSSLoader_h__
 

layout/style/nsCSSOMFactory.cpp

@@ -37,6 +37,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* an XPCOM service for cross-module creation of DOM .style objects */
+
 #include "nsCSSOMFactory.h"
 #include "nsDOMCSSAttrDeclaration.h"
 

layout/style/nsCSSOMFactory.h

@@ -37,6 +37,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* an XPCOM service for cross-module creation of DOM .style objects */
+
 #ifndef nsCSSOMFactory_h___
 #define nsCSSOMFactory_h___
 

layout/style/nsCSSParser.cpp

@@ -40,6 +40,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* parsing of CSS stylesheets, based on a token stream from the CSS scanner */
+ 
 #include "nsICSSParser.h"
 #include "nsCSSProps.h"
 #include "nsCSSKeywords.h"

layout/style/nsCSSPropList.h

@@ -36,6 +36,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * a list of all CSS properties with considerable data about them, for
+ * preprocessing
+ */
+
 /******
 
   This file contains the list of all parsed CSS properties.  It is

layout/style/nsCSSProps.cpp

@@ -36,6 +36,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * methods for dealing with CSS properties and tables of the keyword
+ * values they accept
+ */
+
 #include "nsCSSProps.h"
 #include "nsCSSKeywords.h"
 #include "nsStyleConsts.h"

layout/style/nsCSSProps.h

@@ -35,6 +35,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * methods for dealing with CSS properties and tables of the keyword
+ * values they accept
+ */
+
 #ifndef nsCSSProps_h___
 #define nsCSSProps_h___
 

layout/style/nsCSSPseudoClassList.h

@@ -36,6 +36,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* atom list for CSS pseudo-classes */
+
 /*
  * This file contains the list of nsIAtoms and their values for CSS
  * pseudo-classes.  It is designed to be used as inline input to

layout/style/nsCSSPseudoClasses.cpp

@@ -35,6 +35,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* atom list for CSS pseudo-classes */
+
 #include "nsCSSPseudoClasses.h"
 #include "nsAtomListUtils.h"
 #include "nsStaticAtom.h"

layout/style/nsCSSPseudoClasses.h

@@ -35,6 +35,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* atom list for CSS pseudo-classes */
+
 #ifndef nsCSSPseudoClasses_h___
 #define nsCSSPseudoClasses_h___
 

layout/style/nsCSSPseudoElementList.h

@@ -36,6 +36,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* atom list for CSS pseudo-elements */
+
 /*
  * This file contains the list of nsIAtoms and their values for CSS
  * pseudo-elements.  It is designed to be used as inline input to

layout/style/nsCSSPseudoElements.cpp

@@ -35,6 +35,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* atom list for CSS pseudo-elements */
+
 #include "nsCSSPseudoElements.h"
 #include "nsAtomListUtils.h"
 #include "nsStaticAtom.h"

layout/style/nsCSSPseudoElements.h

@@ -35,6 +35,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* atom list for CSS pseudo-elements */
+
 #ifndef nsCSSPseudoElements_h___
 #define nsCSSPseudoElements_h___
 

layout/style/nsCSSRule.cpp

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* base class for all rule types in a CSS style sheet */
+
 #include "nsCSSRule.h"
 #include "nsCRT.h"
 #include "nsICSSStyleSheet.h"

layout/style/nsCSSRule.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* base class for all rule types in a CSS style sheet */
+
 #ifndef nsCSSRule_h___
 #define nsCSSRule_h___
 

layout/style/nsCSSRuleProcessor.h

@@ -37,6 +37,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * style rule processor for CSS style sheets, responsible for selector
+ * matching and cascading
+ */
+
 #ifndef nsCSSRuleProcessor_h_
 #define nsCSSRuleProcessor_h_
 

layout/style/nsCSSRules.cpp

@@ -35,6 +35,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* rules in a CSS stylesheet other than style rules (e.g., @import rules) */
+
 #include "nsCSSRules.h"
 #include "nsICSSImportRule.h"
 #include "nsICSSNameSpaceRule.h"

layout/style/nsCSSRules.h

@@ -37,6 +37,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* rules in a CSS stylesheet other than style rules (e.g., @import rules) */
+
 #ifndef nsCSSRules_h_
 #define nsCSSRules_h_
 

layout/style/nsCSSScanner.cpp

@@ -36,6 +36,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* tokenization of CSS style sheets */
+
 #include "nsCSSScanner.h"
 #include "nsIFactory.h"
 #include "nsIInputStream.h"

layout/style/nsCSSScanner.h

@@ -36,6 +36,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* tokenization of CSS style sheets */
+
 #ifndef nsCSSScanner_h___
 #define nsCSSScanner_h___
 

layout/style/nsCSSStruct.cpp

@@ -36,6 +36,13 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * temporary (expanded) representation of the property-value pairs
+ * within a CSS declaration using during parsing and mutation, and
+ * representation of complex values for CSS properties
+ */
+
 #include "nscore.h"
 #include "nsCSSStruct.h"
 #include "nsString.h"

layout/style/nsCSSStruct.h

@@ -35,6 +35,13 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * temporary (expanded) representation of the property-value pairs
+ * within a CSS declaration using during parsing and mutation, and
+ * representation of complex values for CSS properties
+ */
+
 #ifndef nsCSSStruct_h___
 #define nsCSSStruct_h___
 

layout/style/nsCSSStyleRule.cpp

@@ -36,6 +36,13 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * representation of CSS style rules (selectors+declaration), CSS
+ * selectors, and DOM objects for style rules, selectors, and
+ * declarations
+ */
+
 #include "nsCOMPtr.h"
 #include "nsCSSRule.h"
 #include "nsICSSStyleRule.h"

layout/style/nsCSSStyleSheet.cpp

@@ -38,6 +38,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* implementation of nsCSSStyleSheet and nsCSSRuleProcessor */
+
 #include "nsCSSStyleSheet.h"
 
 #define PL_ARENA_CONST_ALIGN_MASK 7

layout/style/nsCSSStyleSheet.h

@@ -39,6 +39,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* representation of a CSS style sheet */
+
 #ifndef nsCSSStyleSheet_h_
 #define nsCSSStyleSheet_h_
 

layout/style/nsCSSValue.cpp

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* representation of simple property values within CSS declarations */
+
 #include "nsCSSValue.h"
 #include "nsString.h"
 #include "nsCSSProps.h"

layout/style/nsCSSValue.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* representation of simple property values within CSS declarations */
+
 #ifndef nsCSSValue_h___
 #define nsCSSValue_h___
 

layout/style/nsComputedDOMStyle.cpp

@@ -40,6 +40,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object returned from element.getComputedStyle() */
+
 #include "nsComputedDOMStyle.h"
 
 #include "nsDOMError.h"

layout/style/nsComputedDOMStyle.h

@@ -36,6 +36,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object returned from element.getComputedStyle() */
+
 #ifndef nsComputedDOMStyle_h__
 #define nsComputedDOMStyle_h__
 

layout/style/nsDOMCSSAttrDeclaration.cpp

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object for element.style */
+
 #include "nsDOMCSSAttrDeclaration.h"
 #include "nsCSSDeclaration.h"
 #include "nsIDocument.h"

layout/style/nsDOMCSSAttrDeclaration.h

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object for element.style */
+
 #ifndef nsDOMCSSAttributeDeclaration_h___
 #define nsDOMCSSAttributeDeclaration_h___
 

layout/style/nsDOMCSSDeclaration.cpp

@@ -36,6 +36,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* base class for DOM objects for element.style and cssStyleRule.style */
+
 #include "nsDOMCSSDeclaration.h"
 #include "nsIDOMCSSRule.h"
 #include "nsICSSParser.h"

layout/style/nsDOMCSSDeclaration.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* base class for DOM objects for element.style and cssStyleRule.style */
+
 #ifndef nsDOMCSSDeclaration_h___
 #define nsDOMCSSDeclaration_h___
 

layout/style/nsDOMCSSRGBColor.cpp

@@ -36,6 +36,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object representing color values in DOM computed style */
+
 #include "nsISupports.h"
 #include "nsCOMPtr.h"
 #include "nsIDOMCSSPrimitiveValue.h"

layout/style/nsDOMCSSRGBColor.h

@@ -36,6 +36,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object representing color values in DOM computed style */
+
 #ifndef nsDOMCSSRGBColor_h__
 #define nsDOMCSSRGBColor_h__
 

layout/style/nsDOMCSSRect.cpp

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object representing rectangle values in DOM computed style */
+
 #include "nsISupports.h"
 #include "nsCOMPtr.h"
 #include "nsIDOMCSSPrimitiveValue.h"

layout/style/nsDOMCSSRect.h

@@ -35,8 +35,10 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
-#ifndef nsCSSRect_h___
-#define nsCSSRect_h___
+/* DOM object representing rectangle values in DOM computed style */
+
+#ifndef nsDOMCSSRect_h_
+#define nsDOMCSSRect_h_
 
 #include "nsISupports.h"
 #include "nsIDOMRect.h"
@@ -61,4 +63,4 @@ private:
   nsCOMPtr<nsIDOMCSSPrimitiveValue> mLeft;
 };
 
-#endif /* nsCSSRect_h___ */
+#endif /* nsDOMCSSRect_h_ */

layout/style/nsDOMCSSValueList.cpp

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object representing lists of values in DOM computed style */
+
 #include "nsDOMCSSValueList.h"
 #include "nsCOMPtr.h"
 #include "nsDOMError.h"

layout/style/nsDOMCSSValueList.h

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object representing lists of values in DOM computed style */
+
 #ifndef nsDOMCSSValueList_h___
 #define nsDOMCSSValueList_h___
 

layout/style/nsHTMLCSSStyleSheet.cpp

@@ -36,6 +36,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * style sheet and style rule processor representing style attributes
+ * and some additional overrides
+ */
+
 #include "nsIHTMLCSSStyleSheet.h"
 #include "nsCRT.h"
 #include "nsIAtom.h"

layout/style/nsHTMLStyleSheet.cpp

@@ -44,6 +44,11 @@
  * 04/20/2000       IBM Corp.      OS/2 VisualAge build.
  */
 
+/*
+ * style sheet and style rule processor representing data from presentational
+ * HTML attributes
+ */
+
 #include "nsHTMLStyleSheet.h"
 #include "nsINameSpaceManager.h"
 #include "nsIAtom.h"

layout/style/nsHTMLStyleSheet.h

@@ -36,6 +36,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * style sheet and style rule processor representing data from presentational
+ * HTML attributes
+ */
+
 #ifndef nsHTMLStyleSheet_h_
 #define nsHTMLStyleSheet_h_
 

layout/style/nsICSSDeclaration.h

@@ -35,6 +35,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * faster version of nsIDOMCSSStyleDeclaration using enums instead of
+ * strings, for internal use
+ */
+
 #ifndef nsICSSDeclaration_h__
 #define nsICSSDeclaration_h__
 

layout/style/nsICSSGroupRule.h

@@ -34,6 +34,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * internal interface representing CSS style rules that contain other
+ * rules, such as @media rules
+ */
+
 #ifndef nsICSSGroupRule_h___
 #define nsICSSGroupRule_h___
 

layout/style/nsICSSImportRule.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* internal interface for CSS @import rules */
+
 #ifndef nsICSSImportRule_h___
 #define nsICSSImportRule_h___
 

layout/style/nsICSSLoader.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* loading of CSS style sheets using the network APIs */
+
 #ifndef nsICSSLoader_h___
 #define nsICSSLoader_h___
 

layout/style/nsICSSLoaderObserver.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* internal interface for observing CSS style sheet loads */
+
 #ifndef nsICSSLoaderObserver_h___
 #define nsICSSLoaderObserver_h___
 

layout/style/nsICSSNameSpaceRule.h

@@ -37,6 +37,8 @@
 #ifndef nsICSSNameSpaceRule_h___
 #define nsICSSNameSpaceRule_h___
 
+/* internal interface for CSS @namespace rules */
+
 #include "nsICSSRule.h"
 //#include "nsString.h"
 

layout/style/nsICSSOMFactory.h

@@ -37,6 +37,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* an XPCOM service for cross-module creation of DOM .style objects */
+
 #ifndef nsICSSOMFactory_h___
 #define nsICSSOMFactory_h___
 

layout/style/nsICSSParser.h

@@ -34,8 +34,11 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
-#ifndef nsCSS1Parser_h___
-#define nsCSS1Parser_h___
+
+/* parsing of CSS stylesheets, based on a token stream from the CSS scanner */
+
+#ifndef nsICSSParser_h___
+#define nsICSSParser_h___
 
 #include "nsISupports.h"
 #include "nsAString.h"
@@ -150,4 +153,4 @@ NS_DEFINE_STATIC_IID_ACCESSOR(nsICSSParser, NS_ICSS_PARSER_IID)
 nsresult
 NS_NewCSSParser(nsICSSParser** aInstancePtrResult);
 
-#endif /* nsCSS1Parser_h___ */
+#endif /* nsICSSParser_h___ */

layout/style/nsICSSPseudoComparator.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* internal interface for implementing complex pseudo-classes */
+
 #ifndef nsICSSPseudoComparator_h___
 #define nsICSSPseudoComparator_h___
 

layout/style/nsICSSRule.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* internal interface for all rule types in a CSS style sheet */
+
 #ifndef nsICSSRule_h___
 #define nsICSSRule_h___
 
@@ -48,7 +51,7 @@ class nsAString;
 #define NS_ICSS_RULE_IID     \
 {0xb9791e20, 0x1a04, 0x11d3, {0x80, 0x5a, 0x00, 0x60, 0x08, 0x15, 0x9b, 0x5a}}
 
-
+// inheriting from nsIStyleRule is only for style rules, not other rule types
 class nsICSSRule : public nsIStyleRule {
 public:
   NS_DECLARE_STATIC_IID_ACCESSOR(NS_ICSS_RULE_IID)

layout/style/nsICSSStyleRule.h

@@ -35,6 +35,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * representation of CSS style rules (selectors+declaration) and CSS
+ * selectors
+ */
+
 #ifndef nsICSSStyleRule_h___
 #define nsICSSStyleRule_h___
 

layout/style/nsICSSStyleRuleDOMWrapper.h

@@ -35,6 +35,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * interface to provide DOM inspector with access to internal interfaces
+ * via DOM interface
+ */
+
 #ifndef nsICSSStyleRuleDOMWrapper_h_
 #define nsICSSStyleRuleDOMWrapper_h_
 

layout/style/nsICSSStyleSheet.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* representation of a CSS style sheet */
+
 #ifndef nsICSSStyleSheet_h___
 #define nsICSSStyleSheet_h___
 

layout/style/nsIComputedDOMStyle.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* DOM object returned from element.getComputedStyle() */
+
 #ifndef nsIComputedDOMStyle_h___
 #define nsIComputedDOMStyle_h___
 

layout/style/nsIHTMLCSSStyleSheet.h

@@ -34,6 +34,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * style sheet and style rule processor representing style attributes
+ * and some additional overrides
+ */
+
 #ifndef nsIHTMLCSSStyleSheet_h___
 #define nsIHTMLCSSStyleSheet_h___
 

layout/style/nsIInspectorCSSUtils.h

@@ -37,6 +37,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* XPCOM interface to provide some internal information to DOM inspector */
+
 #ifndef nsIInspectorCSSUtils_h___
 #define nsIInspectorCSSUtils_h___
 

layout/style/nsIMediaList.h

@@ -35,6 +35,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * representation of media lists used when linking to style sheets or by
+ * @media rules
+ */
+
 #ifndef nsIMediaList_h_
 #define nsIMediaList_h_
 

layout/style/nsIStyleRule.h

@@ -34,6 +34,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * internal abstract interface for objects providing immutable style
+ * information
+ */
+
 #ifndef nsIStyleRule_h___
 #define nsIStyleRule_h___
 

layout/style/nsIStyleRuleProcessor.h

@@ -34,6 +34,13 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * internal abstract interface for containers (roughly origins within
+ * the CSS cascade) that provide style rules matching an element or
+ * pseudo-element
+ */
+
 #ifndef nsIStyleRuleProcessor_h___
 #define nsIStyleRuleProcessor_h___
 

layout/style/nsIStyleRuleSupplier.h

@@ -1,26 +0,0 @@
-#ifndef _nsIStyleRuleSupplier_h
-#define _nsIStyleRuleSupplier_h
-
-#include "nsISupports.h"
-#include "nsIStyleRuleProcessor.h"
-
-// {2D77A45B-4F3A-4203-A7D2-F4B84D0C1EE4}
-#define NS_ISTYLERULESUPPLIER_IID \
-{ 0x2d77a45b, 0x4f3a, 0x4203, { 0xa7, 0xd2, 0xf4, 0xb8, 0x4d, 0xc, 0x1e, 0xe4 } }
-
-class nsIContent;
-class nsStyleSet;
-
-class nsIStyleRuleSupplier : public nsISupports {
- public: 
-  NS_DECLARE_STATIC_IID_ACCESSOR(NS_ISTYLERULESUPPLIER_IID)
-
-  NS_IMETHOD WalkRules(nsStyleSet* aStyleSet, 
-                       nsIStyleRuleProcessor::EnumFunc aFunc,
-                       RuleProcessorData* aData,
-                       PRBool* aCutOffInheritance)=0;
-};
-
-NS_DEFINE_STATIC_IID_ACCESSOR(nsIStyleRuleSupplier, NS_ISTYLERULESUPPLIER_IID)
-
-#endif /* _nsIStyleRuleSupplier_h */

layout/style/nsIStyleSheet.h

@@ -34,6 +34,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * interface representing a collection of style data attached to a
+ * document, which may be or be combined into a style rule processor
+ */
+
 #ifndef nsIStyleSheet_h___
 #define nsIStyleSheet_h___
 

layout/style/nsInspectorCSSUtils.cpp

@@ -37,6 +37,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* XPCOM interface to provide some internal information to DOM inspector */
+
 #include "nsInspectorCSSUtils.h"
 #include "nsIStyleRule.h"
 #include "nsRuleNode.h"

layout/style/nsInspectorCSSUtils.h

@@ -37,6 +37,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* XPCOM interface to provide some internal information to DOM inspector */
+
 #ifndef nsInspectorCSSUtils_h___
 #define nsInspectorCSSUtils_h___
 

layout/style/nsROCSSPrimitiveValue.cpp

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object representing values in DOM computed style */
+
 #include "nsROCSSPrimitiveValue.h"
 
 #include "nsCOMPtr.h"

layout/style/nsROCSSPrimitiveValue.h

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* DOM object representing values in DOM computed style */
+
 #ifndef nsROCSSPrimitiveValue_h___
 #define nsROCSSPrimitiveValue_h___
 

layout/style/nsRuleData.h

@@ -36,6 +36,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * temporary (expanded) representation of property-value pairs used to
+ * hold data from matched rules during style data computation 
+ */
+
 #ifndef nsRuleData_h_
 #define nsRuleData_h_
 

layout/style/nsRuleNode.cpp

@@ -39,6 +39,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * a node in the lexicographic tree of rules that match an element,
+ * responsible for converting the rules' information into computed style
+ */
+
 #include "nsRuleNode.h"
 #include "nscore.h"
 #include "nsIServiceManager.h"

layout/style/nsRuleNode.h

@@ -36,6 +36,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * a node in the lexicographic tree of rules that match an element,
+ * responsible for converting the rules' information into computed style
+ */
+
 #ifndef nsRuleNode_h___
 #define nsRuleNode_h___
 

layout/style/nsRuleWalker.h

@@ -36,6 +36,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * a class that walks the lexicographic tree of rule nodes as style
+ * rules are matched
+ */
+
 #include "nsRuleNode.h"
 
 class nsRuleWalker {

layout/style/nsStyleContext.cpp

@@ -37,6 +37,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
  
+/* the interface (to internal code) for retrieving computed style data */
+
 #include "nsStyleConsts.h"
 #include "nsString.h"
 #include "nsPresContext.h"

layout/style/nsStyleContext.h

@@ -37,6 +37,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* the interface (to internal code) for retrieving computed style data */
+
 #ifndef _nsStyleContext_h_
 #define _nsStyleContext_h_
 

layout/style/nsStyleCoord.cpp

@@ -35,6 +35,8 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/* representation of length values in computed style data */
+
 #include "nsStyleCoord.h"
 #include "nsString.h"
 #include "nsCRT.h"

layout/style/nsStyleCoord.h

@@ -34,6 +34,9 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/* representation of length values in computed style data */
+
 #ifndef nsStyleCoord_h___
 #define nsStyleCoord_h___
 

layout/style/nsStyleSet.cpp

@@ -36,6 +36,13 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * the container for the style sheets that apply to a presentation, and
+ * the internal API that the style system exposes for creating (and
+ * potentially re-creating) style contexts
+ */
+
 #include "nsStyleSet.h"
 #include "nsNetUtil.h"
 #include "nsICSSStyleSheet.h"

layout/style/nsStyleSet.h

@@ -37,6 +37,12 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * the container for the style sheets that apply to a presentation, and
+ * the internal API that the style system exposes for creating (and
+ * potentially re-creating) style contexts
+ */
+
 #ifndef nsStyleSet_h_
 #define nsStyleSet_h_
 

layout/style/nsStyleStruct.cpp

@@ -37,6 +37,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * structs that contain the data provided by nsStyleContext, the
+ * internal API for computed style data for an element
+ */
+
 #include "nsStyleStruct.h"
 #include "nsStyleConsts.h"
 #include "nsString.h"

layout/style/nsStyleStruct.h

@@ -35,6 +35,12 @@
  * the terms of any one of the MPL, the GPL or the LGPL.
  *
  * ***** END LICENSE BLOCK ***** */
+
+/*
+ * structs that contain the data provided by nsStyleContext, the
+ * internal API for computed style data for an element
+ */
+
 #ifndef nsStyleStruct_h___
 #define nsStyleStruct_h___
 

layout/style/nsStyleStructList.h

@@ -37,6 +37,11 @@
  *
  * ***** END LICENSE BLOCK ***** */
 
+/*
+ * list of structs that contain the data provided by nsStyleContext, the
+ * internal API for computed style data for an element
+ */
+
 /*
  * This file is intended to be used by different parts of the code, with
  * the STYLE_STRUCT macro (or the STYLE_STRUCT_INHERITED and