diff -r af9b0e113108 -r d2c27621cc81 web/htmlwidgets.py
--- a/web/htmlwidgets.py	Thu Nov 05 12:42:15 2009 +0100
+++ b/web/htmlwidgets.py	Thu Nov 05 12:44:24 2009 +0100
@@ -283,7 +283,14 @@
 
 
 class TableWidget(HTMLWidget):
+    """
+    Display data in a Table with sortable column.
 
+    When using remember to include the required css and js with:
+
+    self.req.add_js('jquery.tablesorter.js')
+    self.req.add_css(('cubicweb.tablesorter.css', 'cubicweb.tableview.css'))
+    """
     highlight = "onmouseover=\"addElementClass(this, 'highlighted');\" " \
                 "onmouseout=\"removeElementClass(this, 'highlighted');\""