modules/javafx.controls/src/main/java/javafx/scene/control/IndexedCell.java

@@ -82,20 +82,23 @@
     };
 
     /**
      * 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(); }
 
     /**
      * The location of this cell in the virtualized control (e.g:
      * {@link ListView}, {@link TreeView}, {@link TableView}, etc). This is the model
      * index which corresponds exactly with the Cell {@link #itemProperty() item}
      * 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(); }
 
     /***************************************************************************
      *                                                                         *

@@ -104,13 +107,14 @@
      **************************************************************************/
 
     /**
      * Updates the index associated with this IndexedCell.
      *
-     * @expert This function is intended to be used by experts, primarily
+     * 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();
         index.set(i);
         indexChanged(oldIndex, i);