changeset 1049:a913df1621ac

comments
author Johannes Hofmann <Johannes.Hofmann@gmx.de>
date Thu, 23 Apr 2009 11:49:25 +0200
parents 52ca66a9a69c
children 6a270ab021ce
files src/doctree.hh src/styleengine.hh
diffstat 2 files changed, 18 insertions(+), 0 deletions(-) [+]
line wrap: on
line diff
--- a/src/doctree.hh	Thu Apr 23 10:37:05 2009 +0200
+++ b/src/doctree.hh	Thu Apr 23 11:49:25 2009 +0200
@@ -11,6 +11,15 @@
       const char *id;
 };
 
+/**
+ * \brief HTML document tree interface.
+ *
+ * The Doctree class defines the interface to the parsed HTML document tree
+ * as it is used for CSS selector matching.
+ * Currently the Doctree can be represented as stack, however to support
+ * CSS adjacent siblings or for future JavaScript support it may have to
+ * be extended to a real tree.
+ */
 class Doctree {
    public:
       virtual ~Doctree () {};
--- a/src/styleengine.hh	Thu Apr 23 10:37:05 2009 +0200
+++ b/src/styleengine.hh	Thu Apr 23 11:49:25 2009 +0200
@@ -8,6 +8,15 @@
 #include "css.hh"
 #include "cssparser.hh"
 
+/**
+ * \brief This class provides the glue between HTML parser and CSS subsystem.
+ *
+ * It maintains a document tree and creates and cashes style objects for use
+ * by the HTML parser.
+ * The HTML parser in turn informs StyleEngine about opened or closed
+ * HTML elements and their attributes via the startElement() / endElement()
+ * methods.
+ */
 class StyleEngine : public Doctree {
    private:
       class Node : public DoctreeNode {