--- 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