# HG changeset patch # User yan # Date 1403783886 -14400 # Node ID b345c47c02b3840daedbfa1b8026b12b8a4dfc4a # Parent 5dd99a9e443b3a5116312cc46e4fdfb8fc9f4c5a 8044281: Fix doclint warnings (missing javadoc tags) in javax.swing.table Reviewed-by: alexsch Contributed-by: Rocky Sloan diff -r 5dd99a9e443b -r b345c47c02b3 jdk/src/share/classes/javax/swing/table/DefaultTableColumnModel.java --- a/jdk/src/share/classes/javax/swing/table/DefaultTableColumnModel.java Wed Jun 25 12:36:03 2014 -0700 +++ b/jdk/src/share/classes/javax/swing/table/DefaultTableColumnModel.java Thu Jun 26 15:58:06 2014 +0400 @@ -716,6 +716,8 @@ /** * Creates a new default list selection model. + * + * @return a newly created default list selection model. */ protected ListSelectionModel createSelectionModel() { return new DefaultListSelectionModel(); diff -r 5dd99a9e443b -r b345c47c02b3 jdk/src/share/classes/javax/swing/table/DefaultTableModel.java --- a/jdk/src/share/classes/javax/swing/table/DefaultTableModel.java Wed Jun 25 12:36:03 2014 -0700 +++ b/jdk/src/share/classes/javax/swing/table/DefaultTableModel.java Thu Jun 26 15:58:06 2014 +0400 @@ -335,6 +335,8 @@ * * @see #setColumnCount * @since 1.3 + * + * @param rowCount number of rows in the model */ public void setRowCount(int rowCount) { setNumRows(rowCount); @@ -577,6 +579,9 @@ * element going to row 0, etc. This method will send a * tableChanged notification message to all the listeners. * + * @param columnName identifier of the newly created column + * @param columnData new data to be added to the column + * * @see #addColumn(Object, Vector) */ public void addColumn(Object columnName, Object[] columnData) { diff -r 5dd99a9e443b -r b345c47c02b3 jdk/src/share/classes/javax/swing/table/JTableHeader.java --- a/jdk/src/share/classes/javax/swing/table/JTableHeader.java Wed Jun 25 12:36:03 2014 -0700 +++ b/jdk/src/share/classes/javax/swing/table/JTableHeader.java Thu Jun 26 15:58:06 2014 +0400 @@ -336,6 +336,10 @@ * Returns the index of the column that point lies in, or -1 if it * lies out of bounds. * + * @param point if this point lies within a column, the index of + * that column will be returned; otherwise it is out of bounds + * and -1 is returned + * * @return the index of the column that point lies in, or -1 if it * lies out of bounds */ @@ -352,6 +356,8 @@ * When the column parameter is out of bounds this method uses the * same conventions as the JTable method getCellRect. * + * @param column index of the column + * * @return the rectangle containing the header tile at column * @see JTable#getCellRect */ @@ -883,6 +889,10 @@ /** * Constructs an AccessiblJTableHeaaderEntry * @since 1.4 + * + * @param c the column index + * @param p the parent JTableHeader + * @param t the table JTable */ public AccessibleJTableHeaderEntry(int c, JTableHeader p, JTable t) { parent = p; diff -r 5dd99a9e443b -r b345c47c02b3 jdk/src/share/classes/javax/swing/table/TableCellRenderer.java --- a/jdk/src/share/classes/javax/swing/table/TableCellRenderer.java Wed Jun 25 12:36:03 2014 -0700 +++ b/jdk/src/share/classes/javax/swing/table/TableCellRenderer.java Thu Jun 26 15:58:06 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -86,6 +86,9 @@ * drawing the header, the value of * row is -1 * @param column the column index of the cell being drawn + * + * @return the component used for drawing the cell. + * * @see javax.swing.JComponent#isPaintingForPrint() */ Component getTableCellRendererComponent(JTable table, Object value, diff -r 5dd99a9e443b -r b345c47c02b3 jdk/src/share/classes/javax/swing/table/TableColumn.java --- a/jdk/src/share/classes/javax/swing/table/TableColumn.java Wed Jun 25 12:36:03 2014 -0700 +++ b/jdk/src/share/classes/javax/swing/table/TableColumn.java Thu Jun 26 15:58:06 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -201,6 +201,11 @@ * Cover method, using a default width of 75, a null * renderer and a null editor. * @see #TableColumn(int, int, TableCellRenderer, TableCellEditor) + * + * @param modelIndex the index of the column in the model + * that supplies the data for this column in the table; + * the model index remains the same even when columns + * are reordered in the view */ public TableColumn(int modelIndex) { this(modelIndex, 75, null, null); @@ -210,6 +215,12 @@ * Cover method, using a null renderer and a * null editor. * @see #TableColumn(int, int, TableCellRenderer, TableCellEditor) + * + * @param modelIndex the index of the column in the model + * that supplies the data for this column in the table; + * the model index remains the same even when columns + * are reordered in the view + * @param width this column's preferred width and initial width */ public TableColumn(int modelIndex, int width) { this(modelIndex, width, null, null); diff -r 5dd99a9e443b -r b345c47c02b3 jdk/src/share/classes/javax/swing/table/TableColumnModel.java --- a/jdk/src/share/classes/javax/swing/table/TableColumnModel.java Wed Jun 25 12:36:03 2014 -0700 +++ b/jdk/src/share/classes/javax/swing/table/TableColumnModel.java Thu Jun 26 15:58:06 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1997, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1997, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -162,6 +162,9 @@ * model. If the column index for a given X coordinate in 2D space is * required, JTable.columnAtPoint can be used instead. * + * @param xPosition width from the start of the first column in + * the model. + * * @return the index of the column; or -1 if no column is found * @see javax.swing.JTable#columnAtPoint */