Add some documentation to the new classes

src/libtomahawk/utils/stylehelper.h

@@ -27,20 +27,42 @@
 class QPalette;
 class QPainter;
 
+/**
+ * \class StyleHelper
+ * \brief A static class that contains Tomahawk's styling details (colors, etc).
+ */
 class StyleHelper
 {
 public:
 
+    /**
+     * Our header BG is a two color gradient. This is the upper color.
+     */
     static QColor headerUpperColor();
+    /**
+     * Our header BG is a two color gradient. This is the lower color.
+     */
     static QColor headerLowerColor();
+    /**
+     * The color of text on a Header.
+     */
     static QColor headerTextColor();
+    /**
+     * The widget highlight color for headers
+     */
     static QColor headerHighlightColor();
 
+    /**
+     * Draws a header background on a painter with the specified rectangle
+     */
     static void horizontalHeader(QPainter *painter, const QRect &rect);
+    /**
+     * Draws a styled arrow that looks good on a Header (from qwindowstyle.cpp)
+     * \copyright {  Licensed under the GPL v3+
+     *               Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
+     *               Contact: Nokia Corporation (qt-info@nokia.com) }
+     */
     static void drawArrow(QStyle::PrimitiveElement, QPainter *painter, const QStyleOption *opt);
-private:
-    static QColor m_baseColor;
-    static QColor m_requestedBaseColor;
 };
 
 #endif // STYLEHELPER_H

src/libtomahawk/widgets/HeaderLabel.h

@@ -23,6 +23,10 @@
 
 #include "dllmacro.h"
 
+/**
+ * \class HeaderLabel
+ * \brief A styled label for use in headers.
+ */
 class DLLEXPORT HeaderLabel : public QLabel
 {
 Q_OBJECT

src/libtomahawk/widgets/HeaderWidget.h

@@ -25,6 +25,11 @@
 
 #include "dllmacro.h"
 
+
+/**
+ * \class HeaderWidget
+ * \brief A QWidget subclass with a background for use in headers.
+ */
 class DLLEXPORT HeaderWidget : public QWidget
 {
 Q_OBJECT

src/libtomahawk/widgets/combobox.h

@@ -24,6 +24,10 @@
 
 #include "dllmacro.h"
 
+/**
+ * \class ComboBox
+ * \brief A styled combo box that has a header background.
+ */
 class DLLEXPORT ComboBox : public QComboBox
 {
 Q_OBJECT

src/libtomahawk/widgets/whatshotwidget.h

@@ -43,6 +43,10 @@ namespace Ui
     class WhatsHotWidget;
 }
 
+/**
+ * \class
+ * \brief The tomahawk page that shows music charts.
+ */
 class DLLEXPORT WhatsHotWidget : public QWidget, public Tomahawk::ViewPage
 {
 Q_OBJECT