--- old/src/java.base/share/classes/java/util/JapaneseImperialCalendar.java 2015-04-28 17:43:12.631600375 +0400 +++ new/src/java.base/share/classes/java/util/JapaneseImperialCalendar.java 2015-04-28 17:43:12.331600375 +0400 @@ -53,7 +53,7 @@ * ------------------------------------------------------ * } * - *

ERA value 0 specifies the years before Meiji and + *

{@code ERA} value 0 specifies the years before Meiji and * the Gregorian year values are used. Unlike {@link * GregorianCalendar}, the Julian to Gregorian transition is not * supported because it doesn't make any sense to the Japanese @@ -66,7 +66,7 @@ *

A new era can be specified using property * jdk.calendar.japanese.supplemental.era. The new era is added to the * predefined eras. The syntax of the property is as follows. - *

+ * 
  *   {@code name=,abbr=,since=}
  * 
* where @@ -83,7 +83,7 @@ * ignored. * *

The following is an example of the property usage. - *

+ * 
  *   java -Djdk.calendar.japanese.supplemental.era="name=NewEra,abbr=N,since=253374307200000"
  * 
* The property specifies an era change to NewEra at 9999-02-11T00:00:00 local time. @@ -315,7 +315,7 @@ private transient int[] originalFields; /** - * Constructs a JapaneseImperialCalendar based on the current time + * Constructs a {@code JapaneseImperialCalendar} based on the current time * in the given time zone with the given locale. * * @param zone the given time zone. @@ -351,16 +351,16 @@ } /** - * Compares this JapaneseImperialCalendar to the specified - * Object. The result is true if and - * only if the argument is a JapaneseImperialCalendar object + * Compares this {@code JapaneseImperialCalendar} to the specified + * {@code Object}. The result is {@code true} if and + * only if the argument is a {@code JapaneseImperialCalendar} object * that represents the same time value (millisecond offset from * the Epoch) under the same - * Calendar parameters. + * {@code Calendar} parameters. * * @param obj the object to compare with. - * @return true if this object is equal to obj; - * false otherwise. + * @return {@code true} if this object is equal to {@code obj}; + * {@code false} otherwise. * @see Calendar#compareTo(Calendar) */ @Override @@ -371,7 +371,7 @@ /** * Generates the hash code for this - * JapaneseImperialCalendar object. + * {@code JapaneseImperialCalendar} object. */ @Override public int hashCode() { @@ -382,27 +382,27 @@ * Adds the specified (signed) amount of time to the given calendar field, * based on the calendar's rules. * - *

Add rule 1. The value of field - * after the call minus the value of field before the - * call is amount, modulo any overflow that has occurred in - * field. Overflow occurs when a field value exceeds its + *

Add rule 1. The value of {@code field} + * after the call minus the value of {@code field} before the + * call is {@code amount}, modulo any overflow that has occurred in + * {@code field}. Overflow occurs when a field value exceeds its * range and, as a result, the next larger field is incremented or * decremented and the field value is adjusted back into its range.

* *

Add rule 2. If a smaller field is expected to be * invariant, but it is impossible for it to be equal to its * prior value because of changes in its minimum or maximum after - * field is changed, then its value is adjusted to be as close + * {@code field} is changed, then its value is adjusted to be as close * as possible to its expected value. A smaller field represents a - * smaller unit of time. HOUR is a smaller field than - * DAY_OF_MONTH. No adjustment is made to smaller fields + * smaller unit of time. {@code HOUR} is a smaller field than + * {@code DAY_OF_MONTH}. No adjustment is made to smaller fields * that are not expected to be invariant. The calendar system * determines what fields are expected to be invariant.

* * @param field the calendar field. * @param amount the amount of date or time to be added to the field. - * @exception IllegalArgumentException if field is - * ZONE_OFFSET, DST_OFFSET, or unknown, + * @exception IllegalArgumentException if {@code field} is + * {@code ZONE_OFFSET}, {@code DST_OFFSET}, or unknown, * or if any calendar fields have out-of-range values in * non-lenient mode. */ @@ -548,12 +548,12 @@ *

This method calls {@link #complete()} before adding the * amount so that all the calendar fields are normalized. If there * is any calendar field having an out-of-range value in non-lenient mode, then an - * IllegalArgumentException is thrown. + * {@code IllegalArgumentException} is thrown. * * @param field the calendar field. - * @param amount the signed amount to add to field. - * @exception IllegalArgumentException if field is - * ZONE_OFFSET, DST_OFFSET, or unknown, + * @param amount the signed amount to add to {@code field}. + * @exception IllegalArgumentException if {@code field} is + * {@code ZONE_OFFSET}, {@code DST_OFFSET}, or unknown, * or if any calendar fields have out-of-range values in * non-lenient mode. * @see #roll(int,boolean) @@ -1055,7 +1055,7 @@ /** * Returns the minimum value for the given calendar field of this - * Calendar instance. The minimum value is + * {@code Calendar} instance. The minimum value is * defined as the smallest value returned by the {@link * Calendar#get(int) get} method for any possible time value, * taking into consideration the current values of the @@ -1077,7 +1077,7 @@ /** * Returns the maximum value for the given calendar field of this - * GregorianCalendar instance. The maximum value is + * {@code GregorianCalendar} instance. The maximum value is * defined as the largest value returned by the {@link * Calendar#get(int) get} method for any possible time value, * taking into consideration the current values of the @@ -1108,7 +1108,7 @@ /** * Returns the highest minimum value for the given calendar field - * of this GregorianCalendar instance. The highest + * of this {@code GregorianCalendar} instance. The highest * minimum value is defined as the largest value returned by * {@link #getActualMinimum(int)} for any possible time value, * taking into consideration the current values of the @@ -1130,7 +1130,7 @@ /** * Returns the lowest maximum value for the given calendar field - * of this GregorianCalendar instance. The lowest + * of this {@code GregorianCalendar} instance. The lowest * maximum value is defined as the smallest value returned by * {@link #getActualMaximum(int)} for any possible time value, * taking into consideration the current values of the @@ -1166,7 +1166,7 @@ * * @param field the calendar field * @return the minimum of the given field for the time value of - * this JapaneseImperialCalendar + * this {@code JapaneseImperialCalendar} * @see #getMinimum(int) * @see #getMaximum(int) * @see #getGreatestMinimum(int) @@ -1269,13 +1269,13 @@ * and * {@link Calendar#getTimeZone() getTimeZone} methods. * For example, if the date of this instance is Heisei 16February 1, - * the actual maximum value of the DAY_OF_MONTH field + * the actual maximum value of the {@code DAY_OF_MONTH} field * is 29 because Heisei 16 is a leap year, and if the date of this * instance is Heisei 17 February 1, it's 28. * * @param field the calendar field * @return the maximum of the given field for the time value of - * this JapaneseImperialCalendar + * this {@code JapaneseImperialCalendar} * @see #getMinimum(int) * @see #getMaximum(int) * @see #getGreatestMinimum(int) @@ -1558,7 +1558,7 @@ * href="Calendar.html#Epoch">Epoch) to calendar field values. * The time is not * recomputed first; to recompute the time, then the fields, call the - * complete method. + * {@code complete} method. * * @see Calendar#complete */