src/share/classes/java/lang/CharSequence.java

rev 7588 : 8019862: Fix doclint errors in java.lang.*.
Summary: Fix doclint errors in java.lang.*
Reviewed-by: darcy
Contributed-by: Brian Burkhalter <brian.burkhalter@oracle.com>

*** 58,78 ****
  
  public interface CharSequence {
  
      /**
       * Returns the length of this character sequence.  The length is the number
!      * of 16-bit <code>char</code>s in the sequence.</p>
       *
       * @return  the number of <code>char</code>s in this sequence
       */
      int length();
  
      /**
       * Returns the <code>char</code> value at the specified index.  An index ranges from zero
       * to <tt>length() - 1</tt>.  The first <code>char</code> value of the sequence is at
       * index zero, the next at index one, and so on, as for array
!      * indexing. </p>
       *
       * <p>If the <code>char</code> value specified by the index is a
       * <a href="{@docRoot}/java/lang/Character.html#unicode">surrogate</a>, the surrogate
       * value is returned.
       *
--- 58,78 ----
  
  public interface CharSequence {
  
      /**
       * Returns the length of this character sequence.  The length is the number
!      * of 16-bit <code>char</code>s in the sequence.
       *
       * @return  the number of <code>char</code>s in this sequence
       */
      int length();
  
      /**
       * Returns the <code>char</code> value at the specified index.  An index ranges from zero
       * to <tt>length() - 1</tt>.  The first <code>char</code> value of the sequence is at
       * index zero, the next at index one, and so on, as for array
!      * indexing.
       *
       * <p>If the <code>char</code> value specified by the index is a
       * <a href="{@docRoot}/java/lang/Character.html#unicode">surrogate</a>, the surrogate
       * value is returned.
       *
*** 90,100 ****
       * Returns a new <code>CharSequence</code> that is a subsequence of this sequence.
       * The subsequence starts with the <code>char</code> value at the specified index and
       * ends with the <code>char</code> value at index <tt>end - 1</tt>.  The length
       * (in <code>char</code>s) of the
       * returned sequence is <tt>end - start</tt>, so if <tt>start == end</tt>
!      * then an empty sequence is returned. </p>
       *
       * @param   start   the start index, inclusive
       * @param   end     the end index, exclusive
       *
       * @return  the specified subsequence
--- 90,100 ----
       * Returns a new <code>CharSequence</code> that is a subsequence of this sequence.
       * The subsequence starts with the <code>char</code> value at the specified index and
       * ends with the <code>char</code> value at index <tt>end - 1</tt>.  The length
       * (in <code>char</code>s) of the
       * returned sequence is <tt>end - start</tt>, so if <tt>start == end</tt>
!      * then an empty sequence is returned.
       *
       * @param   start   the start index, inclusive
       * @param   end     the end index, exclusive
       *
       * @return  the specified subsequence
*** 107,117 ****
      CharSequence subSequence(int start, int end);
  
      /**
       * Returns a string containing the characters in this sequence in the same
       * order as this sequence.  The length of the string will be the length of
!      * this sequence. </p>
       *
       * @return  a string consisting of exactly this sequence of characters
       */
      public String toString();
  
--- 107,117 ----
      CharSequence subSequence(int start, int end);
  
      /**
       * Returns a string containing the characters in this sequence in the same
       * order as this sequence.  The length of the string will be the length of
!      * this sequence.
       *
       * @return  a string consisting of exactly this sequence of characters
       */
      public String toString();