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

@@ -61,11 +61,10 @@
  *   returns true for the row / column that this cell represents, and</li>
  *   <li>The {@link javafx.scene.control.TableSelectionModel#cellSelectionEnabledProperty() cell selection mode}
  *   property is set to true (to represent that it is allowable to select
  *   individual cells (and not just rows of cells)).</li>
  * </ol>
- * </p>
  *
  * @see TableView
  * @see TableColumn
  * @see Cell
  * @see IndexedCell

@@ -208,10 +207,11 @@
             return "tableColumn";
         }
     };
     /**
      * The TableColumn instance that backs this TableCell.
+     * @return the TableColumn instance that backs this TableCell
      */
     public final ReadOnlyObjectProperty<TableColumn<S,T>> tableColumnProperty() { return tableColumn.getReadOnlyProperty(); }
     private void setTableColumn(TableColumn<S,T> value) { tableColumn.set(value); }
     public final TableColumn<S,T> getTableColumn() { return tableColumn.get(); }
 

@@ -225,10 +225,11 @@
         return tableView == null ? null : tableView.get();
     }
 
     /**
      * The TableView associated with this TableCell.
+     * @return the TableView associated with this TableCell
      */
     public final ReadOnlyObjectProperty<TableView<S>> tableViewProperty() {
         return tableViewPropertyImpl().getReadOnlyProperty();
     }
 

@@ -693,35 +694,38 @@
 
     /**
      * Updates the TableView associated with this TableCell. This is typically
      * only done once when the TableCell is first added to the TableView.
      *
-     * @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 tv the TableView associated with this TableCell
      */
     public final void updateTableView(TableView tv) {
         setTableView(tv);
     }
 
     /**
      * Updates the TableRow associated with this TableCell.
      *
-     * @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 tableRow the TableRow associated with this TableCell
      */
     public final void updateTableRow(TableRow tableRow) {
         this.setTableRow(tableRow);
     }
 
     /**
      * Updates the TableColumn associated with this TableCell.
      *
-     * @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 col the TableColumn associated with this TableCell
      */
     public final void updateTableColumn(TableColumn col) {
         // remove style class of existing table column, if it is non-null
         TableColumn<S,T> oldCol = getTableColumn();
         if (oldCol != null) {