From 0bab0ea553cc3a513bd559ca1a1b5f67f6a24265 Mon Sep 17 00:00:00 2001
From: dockes <none@none>
Date: Mon, 29 Sep 2008 07:13:47 +0000
Subject: [PATCH] comments

---
 src/qtgui/reslist.h | 11 ++++++++++-
 1 file changed, 10 insertions(+), 1 deletion(-)

diff --git a/src/qtgui/reslist.h b/src/qtgui/reslist.h
index 35264470..3380e0d6 100644
--- a/src/qtgui/reslist.h
+++ b/src/qtgui/reslist.h
@@ -1,6 +1,6 @@
 #ifndef _RESLIST_H_INCLUDED_
 #define _RESLIST_H_INCLUDED_
-/* @(#$Id: reslist.h,v 1.15 2008-09-28 14:20:50 dockes Exp $  (C) 2005 J.F.Dockes */
+/* @(#$Id: reslist.h,v 1.16 2008-09-29 07:13:47 dockes Exp $  (C) 2005 J.F.Dockes */
 
 #include <list>
 
@@ -26,6 +26,15 @@ class Q3PopupMenu;
 #include "refcntr.h"
 #include "rcldoc.h"
 
+/**
+ * Display a list of document records. The data can be out of the history 
+ * manager or from an index query, both abstracted as a DocSequence. 
+ * Sorting and filtering are applied by stacking Sort/Filter DocSequences.
+ * This is nice because history and index result are handled the same, but 
+ * not nice because we can't use the sort/filter capabilities in the index 
+ * engine, and do it instead on the index output, which duplicates code and 
+ * may be sometimes slower.
+ */
 class ResList : public QTEXTBROWSER
 {
     Q_OBJECT;