diff --git a/itemfield.cabal b/itemfield.cabal
--- a/itemfield.cabal
+++ b/itemfield.cabal
@@ -1,5 +1,5 @@
 name:                itemfield
-version:             1.1.0.1
+version:             1.1.0.2
 
 synopsis:            A brick Widget for selectable summary of many elements on a terminal
 description:         
@@ -12,19 +12,19 @@
   code can get the list of marked elements and perform a
   state-changing operation).
   .
-  .   * 0.1.0.0  -- initial version
+  * 0.1.0.0  -- initial version
   .
-  .   * 0.2.0.0  -- more key events: Shift+Arrow to mark/unmark with move
+  * 0.2.0.0  -- more key events: Shift+Arrow to mark/unmark with move
   .
-  .   * 0.2.0.1  -- more key events: G=mrk/unm group, A=mrk/unm all, !=mrk bad; add helpMsg
+  * 0.2.0.1  -- more key events: G=mrk/unm group, A=mrk/unm all, !=mrk bad; add helpMsg
   .
-  .   * 0.3.0.0  -- rename from StateFieldSelector to ItemField
+  * 0.3.0.0  -- rename from StateFieldSelector to ItemField
   .
-  .   * 0.3.1.0  -- add + key selector to select all successful targets
+  * 0.3.1.0  -- add + key selector to select all successful targets
   .
-  .   * 1.0.0.0  -- update from vty-ui to brick
+  * 1.0.0.0  -- update from vty-ui to brick
   .
-  .   * 1.1.0.0  -- add support for 's' and 'f' keys and mouse events
+  * 1.1.0.0  -- add support for 's' and 'f' keys and mouse events
   
 license:             BSD3
 license-file:        LICENSE
diff --git a/src/TextUI/ItemField.hs b/src/TextUI/ItemField.hs
--- a/src/TextUI/ItemField.hs
+++ b/src/TextUI/ItemField.hs
@@ -24,33 +24,36 @@
 an associated state, which is reflected in both the character used for
 that item and the associated attributes:
 
+@
     State           Character    Attribute
     Free (unmarked)    .         itemFreeAttr
     Marked             *         itemMarkedAttr
     Good               +         itemGoodAttr
     Bad                !         itemBadAttr
     Pending            ~         itemCaVaAttr
+@
 
-(The TextUI.ItemField.Attrs module defines additional attributes.)
+See below for the definitions of these and other attributes that can
+be controlled by the user.
 
 The widget provides a default event handler that handles the following:
 
-    Arrow keys: move in the specified direction
-    Mouse-click: move cursor to clicked item
-    Space:      select/deselect the item under the cursor (state->Marked or Free)
-    Shift-RightArrow or Shift-LeftArrow: extend selection
-    < or >: move 15 items backward or forward
-    L: toggle Marked/Free for the current line
-    G: toggle Marked/Free for the current group
-    Mouse-click on a group: toggle Marked/Free for the current group
-    A: toggle Marked/Free for all items
-    +: change all Good items to Marked
-    !: change all Bad items to Marked
-    ~: change all Pending items to Marked
-    s: change all Good items to Marked, everything else to Free
-    f: change all Bad items to Marked, everything else to Free
+- Arrow keys: move in the specified direction
+- Mouse-click: move cursor to clicked item
+- Space: select/deselect the item under the cursor (state->Marked or Free)
+- Shift-RightArrow or Shift-LeftArrow: extend selection
+- < or >: move 15 items backward or forward
+- L: toggle Marked/Free for the current line
+- G: toggle Marked/Free for the current group
+- Mouse-click on a group: toggle Marked/Free for the current group
+- A: toggle Marked/Free for all items
+- +: change all Good items to Marked
+- !: change all Bad items to Marked
+- ~: change all Pending items to Marked
+- s: change all Good items to Marked, everything else to Free
+- f: change all Bad items to Marked, everything else to Free
 
-Use "cabal configure -fexamples" to build a couple of example programs
+Use @cabal configure -fexamples@ to build a couple of example programs
 that use the ItemField and demonstrate its capabilities.
 
 This module provides the top-level imports and the interaction with
@@ -61,7 +64,9 @@
 module TextUI.ItemField
     ( module TextUI.ItemField.Types
       -- * Types
-    , ItemFieldWidget(..), itemFieldWidget
+    , ItemFieldWidget(..)
+    -- * Rendering
+    , itemFieldWidget
 #ifdef TEST
     , itemFieldRender -- export for testing only
 #endif