--- old/src/java.base/share/classes/java/text/DateFormatSymbols.java 2018-01-11 12:23:13.000000000 +0530 +++ new/src/java.base/share/classes/java/text/DateFormatSymbols.java 2018-01-11 12:23:13.000000000 +0530 @@ -1,5 +1,5 @@ /* - * Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 1996, 2018, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it @@ -394,6 +394,9 @@ /** * Gets month strings. For example: "January", "February", etc. + * An array with either 12 or 13 elements will be returned depending + * on whether or {@link java.util.Calendar#UNDECIMBER Calendar.UNDECIMBER} + * is supported. * *

If the language requires different forms for formatting and * stand-alone usages, this method returns month names in the @@ -405,6 +408,8 @@ * Calendar Elements in the Unicode Locale Data Markup Language * (LDML) specification for more details. * + * @implSpec This method returns 13 elements since + * {@link java.util.Calendar#UNDECIMBER Calendar.UNDECIMBER} is supported. * @return the month strings. Use * {@link java.util.Calendar#JANUARY Calendar.JANUARY}, * {@link java.util.Calendar#FEBRUARY Calendar.FEBRUARY}, @@ -427,7 +432,10 @@ /** * Gets short month strings. For example: "Jan", "Feb", etc. - * + * An array with either 12 or 13 elements will be returned depending + * on whether or {@link java.util.Calendar#UNDECIMBER Calendar.UNDECIMBER} + * is supported. + * *

If the language requires different forms for formatting and * stand-alone usages, this method returns short month names in * the formatting form. For example, the preferred abbreviation @@ -438,6 +446,8 @@ * Calendar Elements in the Unicode Locale Data Markup Language * (LDML) specification for more details. * + * @implSpec This method returns 13 elements since + * {@link java.util.Calendar#UNDECIMBER Calendar.UNDECIMBER} is supported. * @return the short month strings. Use * {@link java.util.Calendar#JANUARY Calendar.JANUARY}, * {@link java.util.Calendar#FEBRUARY Calendar.FEBRUARY},