<Swing Dev> RFR JDK 8 8022453: Fix doclint issues in javax.accessibility

[Phil Race]

Looks fine to me.

-phil.

On 8/6/13 4:27 PM, Joe Darcy wrote:
> Hello,
>
> Please review this change to fix the doclint issues in 
> javax.accessibility; full patch below.
>
>     http://cr.openjdk.java.net/~darcy/8022453.0/
>
> Thanks,
>
> -Joe
>
> diff -r d5694d78ebc6 
> src/share/classes/javax/accessibility/Accessible.java
> --- a/src/share/classes/javax/accessibility/Accessible.java    Tue Aug 
> 06 16:01:39 2013 -0700
> +++ b/src/share/classes/javax/accessibility/Accessible.java    Tue Aug 
> 06 16:26:49 2013 -0700
> @@ -1,5 +1,5 @@
>  /*
> - * Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights 
> reserved.
> + * Copyright (c) 1997, 2013, 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
> @@ -45,6 +45,7 @@
>       * of an object that implements Accessible, and that subclass
>       * is not Accessible, the developer should override the
>       * getAccessibleContext method to return null.
> +     * @return the AccessibleContext associated with this object
>       */
>      public AccessibleContext getAccessibleContext();
>  }
> diff -r d5694d78ebc6 
> src/share/classes/javax/accessibility/AccessibleBundle.java
> --- a/src/share/classes/javax/accessibility/AccessibleBundle.java Tue 
> Aug 06 16:01:39 2013 -0700
> +++ b/src/share/classes/javax/accessibility/AccessibleBundle.java Tue 
> Aug 06 16:26:49 2013 -0700
> @@ -1,5 +1,5 @@
>  /*
> - * Copyright (c) 1997, 2002, Oracle and/or its affiliates. All rights 
> reserved.
> + * Copyright (c) 1997, 2013, 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
> @@ -53,6 +53,9 @@
>      private final String defaultResourceBundleName
>          = "com.sun.accessibility.internal.resources.accessibility";
>
> +    /**
> +     * Construct an {@code AccessibleBundle}.
> +     */
>      public AccessibleBundle() {
>      }
>
> diff -r d5694d78ebc6 
> src/share/classes/javax/accessibility/AccessibleExtendedTable.java
> --- 
> a/src/share/classes/javax/accessibility/AccessibleExtendedTable.java 
> Tue Aug 06 16:01:39 2013 -0700
> +++ 
> b/src/share/classes/javax/accessibility/AccessibleExtendedTable.java 
> Tue Aug 06 16:26:49 2013 -0700
> @@ -1,5 +1,5 @@
>  /*
> - * Copyright (c) 2001, 2006, Oracle and/or its affiliates. All rights 
> reserved.
> + * Copyright (c) 2001, 2013, 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
> @@ -60,7 +60,7 @@
>        */
>       public int getAccessibleColumn(int index);
>
> -     /*
> +    /**
>        * Returns the index at a row and column in the table.
>        *
>        * @param r zero-based row of the table
> diff -r d5694d78ebc6 
> src/share/classes/javax/accessibility/AccessibleRelationSet.java
> --- a/src/share/classes/javax/accessibility/AccessibleRelationSet.java 
> Tue Aug 06 16:01:39 2013 -0700
> +++ b/src/share/classes/javax/accessibility/AccessibleRelationSet.java 
> Tue Aug 06 16:26:49 2013 -0700
> @@ -1,5 +1,5 @@
>  /*
> - * Copyright (c) 1999, 2006, Oracle and/or its affiliates. All rights 
> reserved.
> + * Copyright (c) 1999, 2013, 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
> @@ -163,6 +163,7 @@
>
>      /**
>       * Returns the number of relations in the relation set.
> +     * @return the number of relations in the relation set
>       */
>      public int size() {
>          if (relations == null) {
> diff -r d5694d78ebc6 
> src/share/classes/javax/accessibility/AccessibleTable.java
> --- a/src/share/classes/javax/accessibility/AccessibleTable.java Tue 
> Aug 06 16:01:39 2013 -0700
> +++ b/src/share/classes/javax/accessibility/AccessibleTable.java Tue 
> Aug 06 16:26:49 2013 -0700
> @@ -1,5 +1,5 @@
>  /*
> - * Copyright (c) 1999, 2006, Oracle and/or its affiliates. All rights 
> reserved.
> + * Copyright (c) 1999, 2013, 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
> @@ -90,6 +90,8 @@
>       * Returns the number of rows occupied by the Accessible at
>       * a specified row and column in the table.
>       *
> +     * @param r zero-based row of the table
> +     * @param c zero-based column of the table
>       * @return the number of rows occupied by the Accessible at a
>       * given specified (row, column)
>       */
> @@ -99,6 +101,8 @@
>       * Returns the number of columns occupied by the Accessible at
>       * a specified row and column in the table.
>       *
> +     * @param r zero-based row of the table
> +     * @param c zero-based column of the table
>       * @return the number of columns occupied by the Accessible at a
>       * given specified row and column
>       */
> diff -r d5694d78ebc6 
> src/share/classes/javax/accessibility/AccessibleTableModelChange.java
> --- 
> a/src/share/classes/javax/accessibility/AccessibleTableModelChange.java Tue 
> Aug 06 16:01:39 2013 -0700
> +++ 
> b/src/share/classes/javax/accessibility/AccessibleTableModelChange.java Tue 
> Aug 06 16:26:49 2013 -0700
> @@ -1,5 +1,5 @@
>  /*
> - * Copyright (c) 1999, 2006, Oracle and/or its affiliates. All rights 
> reserved.
> + * Copyright (c) 1999, 2013, 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
> @@ -71,8 +71,8 @@
>      public static final int DELETE = -1;
>
>      /**
> -     *  Returns the type of event
> -     *
> +     *  Returns the type of event.
> +     *  @return the type of event
>       *  @see #INSERT
>       *  @see #UPDATE
>       *  @see #DELETE
> @@ -81,21 +81,25 @@
>
>      /**
>       * Returns the first row that changed.
> +     * @return the first row that changed
>       */
>      public int getFirstRow();
>
>      /**
>       * Returns the last row that changed.
> +     * @return the last row that changed
>       */
>      public int getLastRow();
>
>      /**
>       * Returns the first column that changed.
> +     * @return the first column that changed
>       */
>      public int getFirstColumn();
>
>      /**
>       * Returns the last column that changed.
> +     * @return the last column that changed
>       */
>      public int getLastColumn();
>  }
> diff -r d5694d78ebc6 
> src/share/classes/javax/accessibility/AccessibleTextSequence.java
> --- 
> a/src/share/classes/javax/accessibility/AccessibleTextSequence.java 
> Tue Aug 06 16:01:39 2013 -0700
> +++ 
> b/src/share/classes/javax/accessibility/AccessibleTextSequence.java 
> Tue Aug 06 16:26:49 2013 -0700
> @@ -1,5 +1,5 @@
>  /*
> - * Copyright (c) 2003, 2005, Oracle and/or its affiliates. All rights 
> reserved.
> + * Copyright (c) 2003, 2013, 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
> @@ -49,7 +49,7 @@
>   */
>  public class AccessibleTextSequence {
>
> -    /* The start index of the text sequence */
> +    /** The start index of the text sequence */
>      public int startIndex;
>
>      /** The end index of the text sequence */
> diff -r d5694d78ebc6 
> src/share/classes/javax/accessibility/AccessibleValue.java
> --- a/src/share/classes/javax/accessibility/AccessibleValue.java Tue 
> Aug 06 16:01:39 2013 -0700
> +++ b/src/share/classes/javax/accessibility/AccessibleValue.java Tue 
> Aug 06 16:26:49 2013 -0700
> @@ -1,5 +1,5 @@
>  /*
> - * Copyright (c) 1997, 1999, Oracle and/or its affiliates. All rights 
> reserved.
> + * Copyright (c) 1997, 2013, 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
> @@ -60,6 +60,7 @@
>      /**
>       * Set the value of this object as a Number.
>       *
> +     * @param n the number to use for the value
>       * @return True if the value was set; else False
>       * @see #getCurrentAccessibleValue
>       */
>