--- a/src/gui/itemviews/qabstractitemdelegate.cpp	Tue Jul 06 15:10:48 2010 +0300
+++ b/src/gui/itemviews/qabstractitemdelegate.cpp	Wed Aug 18 10:37:55 2010 +0300
@@ -291,8 +291,14 @@
 }
 
 /*!
-    Whenever an event occurs, this function is called with the \a event
-    \a model \a option and the \a index that corresponds to the item being edited.
+    When editing of an item starts, this function is called with the
+    \a event that triggered the editing, the \a model, the \a index of
+    the item, and the \a option used for rendering the item.
+
+    Mouse events are sent to editorEvent() even if they don't start
+    editing of the item. This can, for instance, be useful if you wish
+    to open a context menu when the right mouse button is pressed on
+    an item.
 
     The base implementation returns false (indicating that it has not
     handled the event).