src/java.base/share/classes/java/text/MessageFormat.java

*** 818,829 ****
       * <code>Field.ARGUMENT</code>, the location of the first formatted
       * string will be returned.
       *
       * @param arguments an array of objects to be formatted and substituted.
       * @param result where text is appended.
!      * @param pos On input: an alignment field, if desired.
!      *            On output: the offsets of the alignment field.
       * @return the string buffer passed in as {@code result}, with formatted
       * text appended
       * @exception IllegalArgumentException if an argument in the
       *            <code>arguments</code> array is not of the type
       *            expected by the format element(s) that use it.
--- 818,829 ----
       * <code>Field.ARGUMENT</code>, the location of the first formatted
       * string will be returned.
       *
       * @param arguments an array of objects to be formatted and substituted.
       * @param result where text is appended.
!      * @param pos keeps track on the position of the first replaced argument
!                   in the output string.
       * @return the string buffer passed in as {@code result}, with formatted
       * text appended
       * @exception IllegalArgumentException if an argument in the
       *            <code>arguments</code> array is not of the type
       *            expected by the format element(s) that use it.
*** 866,877 ****
       *     <code>{@link #format(java.lang.Object[], java.lang.StringBuffer, java.text.FieldPosition) format}((Object[]) arguments, result, pos)</code>
       * </blockquote>
       *
       * @param arguments an array of objects to be formatted and substituted.
       * @param result where text is appended.
!      * @param pos On input: an alignment field, if desired.
!      *            On output: the offsets of the alignment field.
       * @exception IllegalArgumentException if an argument in the
       *            <code>arguments</code> array is not of the type
       *            expected by the format element(s) that use it.
       * @exception NullPointerException if {@code result} is {@code null}
       */
--- 866,877 ----
       *     <code>{@link #format(java.lang.Object[], java.lang.StringBuffer, java.text.FieldPosition) format}((Object[]) arguments, result, pos)</code>
       * </blockquote>
       *
       * @param arguments an array of objects to be formatted and substituted.
       * @param result where text is appended.
!      * @param pos keeps track on the position of the first replaced argument
!      *            in the output string.
       * @exception IllegalArgumentException if an argument in the
       *            <code>arguments</code> array is not of the type
       *            expected by the format element(s) that use it.
       * @exception NullPointerException if {@code result} is {@code null}
       */
*** 1237,1251 ****
       * @serial
       */
      private int maxOffset = -1;
  
      /**
!      * Internal routine used by format. If <code>characterIterators</code> is
!      * non-null, AttributedCharacterIterator will be created from the
!      * subformats as necessary. If <code>characterIterators</code> is null
!      * and <code>fp</code> is non-null and identifies
!      * <code>Field.MESSAGE_ARGUMENT</code>, the location of
       * the first replaced argument will be set in it.
       *
       * @exception IllegalArgumentException if an argument in the
       *            <code>arguments</code> array is not of the type
       *            expected by the format element(s) that use it.
--- 1237,1251 ----
       * @serial
       */
      private int maxOffset = -1;
  
      /**
!      * Internal routine used by format. If {@code characterIterators} is
!      * {@code non-null}, AttributedCharacterIterator will be created from the
!      * subformats as necessary. If {@code characterIterators} is {@code null}
!      * and {@code fp} is {@code non-null} and identifies
!      * {@code Field.ARGUMENT} as the field attribute, the location of
       * the first replaced argument will be set in it.
       *
       * @exception IllegalArgumentException if an argument in the
       *            <code>arguments</code> array is not of the type
       *            expected by the format element(s) that use it.