+<h4>ColumnSorterMixin</h4>
+
+<code><b>ColumnSorterMixin(numColumns)</b></code>
+
+<p>A mixin class that handles sorting of a wxListCtrl in REPORT mode when the column
+header is clicked on.
+
+<p>There are a few requirments needed in order for this to work genericly:
+<p><ol>
+ <li>The combined class must have a <code>GetListCtrl</code> method that returns
+ the ListCtrl to be sorted, and the list control must exist at the time the
+ <code>ColumnSorterMixin.__init__()</code>method is called because it uses
+ <code>GetListCtrl</code>.
+
+ <li>Items in the list control must have a unique data value set with
+ <code>list.SetItemData</code>.
+
+ <li>The combined class must have an attribute named <code>itemDataMap</code>
+ that is a dictionary mapping the data values to a sequence of objects
+ representing the values in each column. These valuesare compared in
+ the column sorter to determine sort order.
+</ol>
+
+<p>Interesting methods to override are <code>GetColumnSorter</code>,
+<code>GetSecondarySortValues</code>, and <code>GetSortImages</code>.
+
+<h5>Methods</h5>
+<dl>
+<dt><code>SetColumnCount(newNumColumns)</code>
+<dd>Informs the mixin as to the number of columns in the control. When it is
+set, it also sets up an event handler for <code>EVT_LIST_COL_CLICK</code> events.
+
+<dt><code>SortListItems(col=-1, ascending=1)</code>
+<dd>Sort the list on demand. Can also be used to set the sort column and order.
+
+<dt><code>GetColumnWidths()</code>
+<dd>Returns a list of column widths. Can be used to help restore the current
+view later.
+
+<dt><code>GetSortImages()</code>
+<dd>Returns a tuple of image list indexes the indexes in the image list for an
+image to be put on the column header when sorting in descending order
+
+<dt><code>GetColumnSorter()</code>
+<dd>Returns a callable object to be used for comparing column values when sorting.
+
+<dt><code>GetSecondarySortValues(col, key1, key2)</code>
+<dd>Returns a tuple of 2 values to use for secondary sort values when the
+items in the selected column match equal. The default just returns the
+item data values.