src/java.base/share/classes/sun/nio/cs/Surrogate.java

*** 173,183 ****
           *
           * @param  c    The first character
           * @param  in   The source buffer, from which one more character
           *              will be consumed if c is a high surrogate
           *
!          * @returns  Either a parsed UCS-4 character, in which case the isPair()
           *           and increment() methods will return meaningful values, or
           *           -1, in which case error() will return a descriptive result
           *           object
           */
          public int parse(char c, CharBuffer in) {
--- 173,183 ----
           *
           * @param  c    The first character
           * @param  in   The source buffer, from which one more character
           *              will be consumed if c is a high surrogate
           *
!          * @return  Either a parsed UCS-4 character, in which case the isPair()
           *          and increment() methods will return meaningful values, or
           *          -1, in which case error() will return a descriptive result
           *          object
           */
          public int parse(char c, CharBuffer in) {
*** 214,224 ****
           * @param  ia   The input array, from which one more character
           *              will be consumed if c is a high surrogate
           * @param  ip   The input index
           * @param  il   The input limit
           *
!          * @returns  Either a parsed UCS-4 character, in which case the isPair()
           *           and increment() methods will return meaningful values, or
           *           -1, in which case error() will return a descriptive result
           *           object
           */
          public int parse(char c, char[] ia, int ip, int il) {
--- 214,224 ----
           * @param  ia   The input array, from which one more character
           *              will be consumed if c is a high surrogate
           * @param  ip   The input index
           * @param  il   The input limit
           *
!          * @return  Either a parsed UCS-4 character, in which case the isPair()
           *          and increment() methods will return meaningful values, or
           *          -1, in which case error() will return a descriptive result
           *          object
           */
          public int parse(char c, char[] ia, int ip, int il) {
*** 278,288 ****
           * @param  len  The number of input bytes from which the UCS-4 value
           *              was constructed (used when creating result objects)
           * @param  dst  The destination buffer, to which one or two UTF-16
           *              characters will be written
           *
!          * @returns  Either a positive count of the number of UTF-16 characters
           *           written to the destination buffer, or -1, in which case
           *           error() will return a descriptive result object
           */
          public int generate(int uc, int len, CharBuffer dst) {
              if (Character.isBmpCodePoint(uc)) {
--- 278,288 ----
           * @param  len  The number of input bytes from which the UCS-4 value
           *              was constructed (used when creating result objects)
           * @param  dst  The destination buffer, to which one or two UTF-16
           *              characters will be written
           *
!          * @return  Either a positive count of the number of UTF-16 characters
           *          written to the destination buffer, or -1, in which case
           *          error() will return a descriptive result object
           */
          public int generate(int uc, int len, CharBuffer dst) {
              if (Character.isBmpCodePoint(uc)) {
*** 323,333 ****
           * @param  da   The destination array, to which one or two UTF-16
           *              characters will be written
           * @param  dp   The destination position
           * @param  dl   The destination limit
           *
!          * @returns  Either a positive count of the number of UTF-16 characters
           *           written to the destination buffer, or -1, in which case
           *           error() will return a descriptive result object
           */
          public int generate(int uc, int len, char[] da, int dp, int dl) {
              if (Character.isBmpCodePoint(uc)) {
--- 323,333 ----
           * @param  da   The destination array, to which one or two UTF-16
           *              characters will be written
           * @param  dp   The destination position
           * @param  dl   The destination limit
           *
!          * @return  Either a positive count of the number of UTF-16 characters
           *          written to the destination buffer, or -1, in which case
           *          error() will return a descriptive result object
           */
          public int generate(int uc, int len, char[] da, int dp, int dl) {
              if (Character.isBmpCodePoint(uc)) {