--- a/src/qtgui/advshist.h
+++ b/src/qtgui/advshist.h
@@ -23,6 +23,17 @@
 #include "refcntr.h"
 #include "searchdata.h"
 
+/** Advanced search history. 
+ *
+ * We store previous searches using the "dynconf" mechanism, as string
+ * entries under the "advSearchHist" key. The strings are generated by
+ * translating the SearchData structure to XML, which is done by
+ * calling SearchData::asXML(). 
+ * When reading, we use a QXmlSimpleReader and QXmlDefaultHandler to
+ * turn the XML back into a SearchData object, which is then passed to
+ * the advanced search object fromSearch() method to rebuild the
+ * window state.
+ */ 
 class AdvSearchHist {
 public:
     AdvSearchHist();
@@ -39,5 +50,4 @@
     std::vector<RefCntr<Rcl::SearchData> > m_entries;
 };
 
-
 #endif // _ADVSHIST_H_INCLUDED_