--- old/src/java.base/share/classes/java/util/Formattable.java 2015-08-07 21:15:00.898584836 +0400 +++ new/src/java.base/share/classes/java/util/Formattable.java 2015-08-07 21:15:00.690584845 +0400 @@ -28,8 +28,8 @@ import java.io.IOException; /** - * The Formattable interface must be implemented by any class that - * needs to perform custom formatting using the 's' conversion + * The {@code Formattable} interface must be implemented by any class that + * needs to perform custom formatting using the {@code 's'} conversion * specifier of {@link java.util.Formatter}. This interface allows basic * control for formatting arbitrary objects. * @@ -110,7 +110,7 @@ * safety is optional and may be enforced by classes that extend and implement * this interface. * - *
Unless otherwise specified, passing a null argument to + *
Unless otherwise specified, passing a {@code null} argument to
* any method in this interface will cause a {@link
* NullPointerException} to be thrown.
*
@@ -126,7 +126,7 @@
* {@link Formatter#out() formatter.out()} or {@link
* Formatter#locale() formatter.locale()} to obtain the {@link
* Appendable} or {@link Locale} used by this
- * formatter respectively.
+ * {@code formatter} respectively.
*
* @param flags
* The flags modify the output format. The value is interpreted as
@@ -139,19 +139,19 @@
* @param width
* The minimum number of characters to be written to the output.
* If the length of the converted value is less than the
- * width then the output will be padded by
- * ' ' until the total number of characters
+ * {@code width} then the output will be padded by
+ * ' '
until the total number of characters
* equals width. The padding is at the beginning by default. If
* the {@link FormattableFlags#LEFT_JUSTIFY} flag is set then the
- * padding will be at the end. If width is -1
+ * padding will be at the end. If {@code width} is {@code -1}
* then there is no minimum.
*
* @param precision
* The maximum number of characters to be written to the output.
* The precision is applied before the width, thus the output will
- * be truncated to precision characters even if the
- * width is greater than the precision. If
- * precision is -1 then there is no explicit
+ * be truncated to {@code precision} characters even if the
+ * {@code width} is greater than the {@code precision}. If
+ * {@code precision} is {@code -1} then there is no explicit
* limit on the number of characters.
*
* @throws IllegalFormatException