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

@@ -80,11 +80,10 @@
  *      right-clicks the column header area
  *    <li>Have the contents of the table be sorted (using
  *      {@link #comparatorProperty() comparator}, {@link #sortable sortable} and
  *      sortType).
  * </ul>
- * </p>
  *
  * When instantiating a concrete subclass of TableColumnBase, perhaps the two
  * most important properties to set are the column {@link #textProperty() text}
  * (what to show in the column header area), and the column
  * {@code cell value factory} (which is used to populate individual cells in the

@@ -403,10 +402,11 @@
      * The width of this column. Modifying this will result in the column width
      * adjusting visually. It is recommended to not bind this property to an
      * external property, as that will result in the column width not being
      * adjustable by the user through dragging the left and right borders of
      * column headers.
+     * @return the width property
      */
     public final ReadOnlyDoubleProperty widthProperty() { return width.getReadOnlyProperty(); }
     public final double getWidth() { return width.get(); }
     void setWidth(double value) { width.set(value); }
     private ReadOnlyDoubleWrapper width = new ReadOnlyDoubleWrapper(this, "width", DEFAULT_WIDTH);

@@ -436,10 +436,11 @@
 
 
     // --- Preferred Width
     /**
      * The preferred width of the TableColumn.
+     * @return preferred width property
      */
     public final DoubleProperty prefWidthProperty() { return prefWidth; }
     public final void setPrefWidth(double value) { prefWidthProperty().set(value); }
     public final double getPrefWidth() { return prefWidth.get(); }
     private final DoubleProperty prefWidth = new SimpleDoubleProperty(this, "prefWidth", DEFAULT_WIDTH) {

@@ -452,10 +453,11 @@
     // --- Maximum Width
     // The table does not resize properly if this is set to Number.MAX_VALUE,
     // so I've arbitrarily chosen a better, smaller number.
     /**
      * The maximum width the table column is permitted to be resized to.
+     * @return maximum width property
      */
     public final DoubleProperty maxWidthProperty() { return maxWidth; }
     public final void setMaxWidth(double value) { maxWidthProperty().set(value); }
     public final double getMaxWidth() { return maxWidth.get(); }
     private DoubleProperty maxWidth = new SimpleDoubleProperty(this, "maxWidth", DEFAULT_MAX_WIDTH) {

@@ -733,10 +735,11 @@
      * Registers an event handler to this table column. The TableColumnBase class allows
      * registration of listeners which will be notified when editing occurs.
      * Note however that TableColumnBase is <b>not</b> a Node, and therefore no visual
      * events will be fired on it.
      *
+     * @param <E> The type of event
      * @param eventType the type of the events to receive by the handler
      * @param eventHandler the handler to register
      * @throws NullPointerException if the event type or handler is null
      */
     public <E extends Event> void addEventHandler(EventType<E> eventType, EventHandler<E> eventHandler) {

@@ -747,10 +750,11 @@
      * Unregisters a previously registered event handler from this table column. One
      * handler might have been registered for different event types, so the
      * caller needs to specify the particular event type from which to
      * unregister the handler.
      *
+     * @param <E> The type of event
      * @param eventType the event type from which to unregister
      * @param eventHandler the handler to unregister
      * @throws NullPointerException if the event type or handler is null
      */
     public <E extends Event> void removeEventHandler(EventType<E> eventType, EventHandler<E> eventHandler) {