Javadoc

src/main/java/javax/time/calendar/LocalDate.java

@@ -471,15 +471,14 @@ private LocalDate resolveDate(DateResolver dateResolver, int year, MonthOfYear m
     /**
      * Returns a copy of this {@code LocalDate} with the date altered using the adjuster.
      * <p>
-     * Adjusters can be used to alter the date in various ways.
+     * This adjusts the date according to the rules of the specified adjuster.
      * A simple adjuster might simply set the one of the fields, such as the year field.
      * A more complex adjuster might set the date to the last day of the month.
      * <p>
      * This instance is immutable and unaffected by this method call.
      *
      * @param adjuster  the adjuster to use, not null
      * @return a {@code LocalDate} based on this date adjusted as necessary, not null
-     * @throws NullPointerException if the adjuster returned null
      */
     public LocalDate with(DateAdjuster adjuster) {
         ISOChronology.checkNotNull(adjuster, "DateAdjuster must not be null");

src/main/java/javax/time/calendar/LocalDateTime.java

@@ -631,17 +631,15 @@ public boolean isLeapYear() {
     /**
      * Returns a copy of this {@code LocalDateTime} with the date altered using the adjuster.
      * <p>
-     * Adjusters can be used to alter the date in various ways.
-     * A simple adjuster might simply set the one of the fields, such as the year field.
-     * A more complex adjuster might set the date to the last day of the month.
-     * <p>
-     * The time does not affect the calculation and will be the same in the result.
+     * This adjusts the date according to the rules of the specified adjuster.
+     * The time is not part of the calculation and will be unchanged in the result.
+     * Note that {@link LocalDate} implements {@code DateAdjuster}, thus this method
+     * can be used to change the entire date.
      * <p>
      * This instance is immutable and unaffected by this method call.
      *
      * @param adjuster  the adjuster to use, not null
      * @return a {@code LocalDateTime} based on this date-time with the date adjusted, not null
-     * @throws NullPointerException if the adjuster returned null
      */
     public LocalDateTime with(DateAdjuster adjuster) {
         return with(date.with(adjuster), time);
@@ -650,17 +648,15 @@ public LocalDateTime with(DateAdjuster adjuster) {
     /**
      * Returns a copy of this {@code LocalDateTime} with the time altered using the adjuster.
      * <p>
-     * Adjusters can be used to alter the time in various ways.
-     * A simple adjuster might simply set the one of the fields, such as the hour field.
-     * A more complex adjuster might set the time to end of the working day.
-     * <p>
-     * The date does not affect the calculation and will be the same in the result.
+     * This adjusts the time according to the rules of the specified adjuster.
+     * The date is not part of the calculation and will be unchanged in the result.
+     * Note that {@link LocalTime} implements {@code TimeAdjuster}, thus this method
+     * can be used to change the entire time.
      * <p>
      * This instance is immutable and unaffected by this method call.
      *
      * @param adjuster  the adjuster to use, not null
      * @return a {@code LocalDateTime} based on this date-time with the time adjusted, not null
-     * @throws IllegalArgumentException if the adjuster returned null
      */
     public LocalDateTime with(TimeAdjuster adjuster) {
         return with(date, time.with(adjuster));

src/main/java/javax/time/calendar/LocalTime.java

@@ -493,7 +493,7 @@ public int getNanoOfSecond() {
     /**
      * Returns a copy of this {@code LocalTime} with the time altered using the adjuster.
      * <p>
-     * Adjusters can be used to alter the time in various ways.
+     * This adjusts the time according to the rules of the specified adjuster.
      * A simple adjuster might simply set the one of the fields, such as the hour field.
      * A more complex adjuster might set the time to end of the working day.
      * <p>
@@ -505,7 +505,7 @@ public int getNanoOfSecond() {
     public LocalTime with(TimeAdjuster adjuster) {
         LocalTime time = adjuster.adjustTime(this);
         if (time == null) {
-            throw new NullPointerException("The implementation of TimeAdjuster must not return null");
+            throw new NullPointerException("TimeAdjuster implementation must not return null");
         }
         return time;
     }