--- 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 {