 import spark.components.DataGrid;
 
 /**
- *  Grid item editors must implement this interface. 
+ *  The IGridItemEditor interface defines the interface that item editors for 
+ *  the Spark DataGrid and Spark Grid controls must implement. 
+ *  The DataGrid and Grid controls are referred to as the item renderer owner,
+ *  or as the host component of the item editor.
  * 
- *  <p>All of the item editor's properties are set by the DataGrid during 
- *  the start of the editor session. The <code>data</code> property is the 
- *  last property set. When the data property is set a grid item editor should
- *  set the value of the editor's controls. Next the editor's 
- *  <code>prepare()</code> method is called. IGridItemEditor 
- *  implementations should override the preprare() method to make any final
- *  adjustments to its properties or any aspect of its visual elements. 
- *  When the editor is closing the <code>discard()</code> method is called.</p>
+ *  <p>All of the item editor's properties are set by the owner during 
+ *  the start of the editor session. 
+ *  The <code>data</code> property is the last property set. 
+ *  When the <code>data</code> property is set, an item editor should
+ *  set the value of the editor's controls. 
+ *  Next, the editor's <code>prepare()</code> method is called. 
+ *  IGridItemEditor implementations should override the <code>prepare()</code> method 
+ *  to make any final adjustments to its properties or any aspect of its visual elements. 
+ *  When the editor is closing, the <code>discard()</code> method is called.</p>
  *  
- * <p>When the editor is closed the input value can be saved or cancelled. If saving, 
- * the <code>save()</code> function is called by the editor.
- * </p>
+ *  <p>When the editor is closed, the input value can be saved or canceled. 
+ *  If saving, the <code>save()</code> function is called by the editor
+ *  to write new values to the data provider element corresponding to the 
+ *  row of the edited cell. </p>
+ *
+ *  @see spark.components.DataGrid
+ *  @see spark.components.Grid
+ * 
+ *  @langversion 3.0
+ *  @playerversion Flash 10
+ *  @playerversion AIR 2.5
+ *  @productversion Flex 4.5 
  */
 public interface IGridItemEditor extends IDataRenderer, IVisualElement, 
                                  IFocusManagerComponent, IIMESupport

    //----------------------------------
    
    /** 
     *  The zero-based index of the column that is being edited.
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.0
     *  @productversion Flex 4.5 
     */ 
    function get columnIndex():int;

    //----------------------------------
    
    /** 
     *  The zero-based index of the row of the cell being edited.
     *  That means that values are 0, 1, 2, ... , n - 1, 
     *  where n is the total number of rows.
     * 
     *  @langversion 3.0
     *  @playerversion Flash 10
     *  @playerversion AIR 2.5
     *  @productversion Flex 4.5 
     */ 
    function get rowIndex():int;
