--- old/src/share/classes/java/time/overview.html 2013-02-08 10:47:59.000000000 -0800 +++ new/src/share/classes/java/time/overview.html 2013-02-08 10:47:59.000000000 -0800 @@ -88,12 +88,6 @@ The set of supported units and fields can be extended by applications if desired.

- It also contains the basic part of the calendar neutral API. - This is intended for use by applications that need to use localized calendars. - Ensure that you read the class documentation of {@link java.time.temporal.ChronoLocalDate} - before using non-ISO calendar systems. -

-

{@link java.time.format} contains the API to print and parse fields into date-time objects and to customize parsing and printing. Formatters can be created in a variety of ways, including constants, patterns, @@ -105,7 +99,8 @@ Detailed information is made available about the rules of each time-zone.

- The {@link java.time.calendar} package contains alternate calendar systems. + {@link java.time.chrono} contains the basic part of the calendar neutral API + and alternate calendar systems. This is intended for use by applications that need to use localized calendars. Support is provided for the Hijrah, Japanese, Minguo, and Thai Buddhist Calendars.

@@ -136,7 +131,7 @@ excessively complicated the API. Notably, there would be additional combinations at the offset and date-time levels, such as offset-date-hour-minute. To avoid this explosion of types, {@link java.time.LocalTime} is used for all precisions of time. - By contrast, some additional classes were used for dates, such as {@link java.time.temporal.YearMonth}. + By contrast, some additional classes were used for dates, such as {@link java.time.YearMonth}. This proved necessary, as the API for year-month is significantly different to that for a date, whereas an absence of nanoseconds in a time can be approximated by returning zero.

@@ -161,7 +156,7 @@

There are, however, some limited use cases where users believe they need to store and use dates in arbitrary calendar systems throughout the application. - This is supported by {@link java.time.temporal.ChronoLocalDate}, however it is vital to read + This is supported by {@link java.time.chrono.ChronoLocalDate}, however it is vital to read all the associated warnings in the Javadoc of that interface before using it. In summary, applications that require general interoperation between multiple calendar systems typically need to be written in a very different way to those only using the ISO calendar,