--- old/modules/javafx.controls/src/main/java/javafx/scene/control/IndexedCell.java	2017-03-09 14:44:21.246173619 -0800
+++ new/modules/javafx.controls/src/main/java/javafx/scene/control/IndexedCell.java	2017-03-09 14:44:21.134173617 -0800
@@ -84,6 +84,8 @@
     /**
      * Returns the index that this cell represents in the underlying control
      * data model.
+     * @return the index that this cell represents in the underlying control
+     * data model
      */
     public final int getIndex() { return index.get(); }
 
@@ -94,6 +96,7 @@
      * property. For example,
      * in the case of a {@link ListView}, this means the following:
      * <code>cell.item == listView.getItems().get(cell.getIndex())</code>
+     * @return the location of this cell in the virtualized control
      */
     public final ReadOnlyIntegerProperty indexProperty() { return index.getReadOnlyProperty(); }
 
@@ -106,9 +109,10 @@
     /**
      * Updates the index associated with this IndexedCell.
      *
-     * @expert This function is intended to be used by experts, primarily
-     *         by those implementing new Skins. It is not common
-     *         for developers or designers to access this function directly.
+     * Note: This function is intended to be used by experts, primarily
+     *       by those implementing new Skins. It is not common
+     *       for developers or designers to access this function directly.
+     * @param i the index associated with this indexed cell
      */
     public void updateIndex(int i) {
         final int oldIndex = index.get();