--- old/src/java.xml/share/classes/javax/xml/datatype/XMLGregorianCalendar.java	Tue Jul 19 17:22:43 2016
+++ new/src/java.xml/share/classes/javax/xml/datatype/XMLGregorianCalendar.java	Tue Jul 19 17:22:43 2016
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) 2003, 2006, Oracle and/or its affiliates. All rights reserved.
+ * Copyright (c) 2003, 2016, 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
@@ -512,12 +512,12 @@
         public abstract BigInteger getEonAndYear();
 
         /**
-         * Return number of month or {@link DatatypeConstants#FIELD_UNDEFINED}.
+         * Returns the month of this calendar or {@link DatatypeConstants#FIELD_UNDEFINED}.
          *
          * <p>Value constraints for this value are summarized in
          * <a href="#datetimefield-month">month field of date/time field mapping table</a>.
          *
-         * @return year  of this {@code XMLGregorianCalendar}.
+         * @return Returns the month of this {@code XMLGregorianCalendar}.
          *
          */
         public abstract int getMonth();
@@ -528,6 +528,8 @@
          * <p>Value constraints for this value are summarized in
          * <a href="#datetimefield-day">day field of date/time field mapping table</a>.
          *
+         * @return Day in month of this {@code XMLGregorianCalendar}.
+         *
          * @see #setDay(int)
          */
         public abstract int getDay();
@@ -539,6 +541,8 @@
          * <p>Value constraints for this value are summarized in
          * <a href="#datetimefield-timezone">timezone field of date/time field mapping table</a>.
          *
+         * @return Timezone offset in minutes of this {@code XMLGregorianCalendar}.
+         *
          * @see #setTimezone(int)
          */
         public abstract int getTimezone();
@@ -549,6 +553,9 @@
          *
          * <p>Value constraints for this value are summarized in
          * <a href="#datetimefield-hour">hour field of date/time field mapping table</a>.
+         *
+         * @return Hours of this {@code XMLGregorianCalendar}.
+         *
          * @see #setTime(int, int, int)
          */
         public abstract int getHour();
@@ -559,6 +566,9 @@
          *
          * <p>Value constraints for this value are summarized in
          * <a href="#datetimefield-minute">minute field of date/time field mapping table</a>.
+         *
+         * @return Minutes of this {@code XMLGregorianCalendar}.
+         *
          * @see #setTime(int, int, int)
          */
         public abstract int getMinute();
@@ -681,6 +691,7 @@
      * returns {@link DatatypeConstants#EQUAL},
      * otherwise {@code false}.
      */
+    @Override
     public boolean equals(Object obj) {
 
         if (obj == null || !(obj instanceof XMLGregorianCalendar)) {
@@ -694,6 +705,7 @@
      *
      * @return hash code of this object.
      */
+    @Override
     public int hashCode() {
 
         // Following two dates compare to EQUALS since in different timezones.
@@ -846,18 +858,18 @@
      */
     public abstract QName getXMLSchemaType();
 
-        /**
-         * Returns a {@code String} representation of this {@code XMLGregorianCalendar} {@code Object}.
-         *
-         * <p>The result is a lexical representation generated by {@link #toXMLFormat()}.
-         *
-         * @return A non-{@code null} valid {@code String} representation of this {@code XMLGregorianCalendar}.
-         *
+    /**
+     * Returns a {@code String} representation of this {@code XMLGregorianCalendar} {@code Object}.
+     *
+     * <p>The result is a lexical representation generated by {@link #toXMLFormat()}.
+     *
+     * @return A non-{@code null} valid {@code String} representation of this {@code XMLGregorianCalendar}.
+     *
      * @throws IllegalStateException if the combination of set fields
      *    does not match one of the eight defined XML Schema builtin date/time datatypes.
-     *
      * @see #toXMLFormat()
-         */
+     */
+    @Override
     public String toString() {
 
         return toXMLFormat();
@@ -970,6 +982,8 @@
      *       {@code Calendar.set(int,int)}</li>
      * </ul>
      *
+     * @return a {@code java.util.GregorianCalendar} conversion of this instance.
+     *
      * @see #toGregorianCalendar(java.util.TimeZone, java.util.Locale, XMLGregorianCalendar)
      */
     public abstract GregorianCalendar toGregorianCalendar();
@@ -1049,11 +1063,11 @@
     public abstract TimeZone getTimeZone(int defaultZoneoffset);
 
 
-
     /**
      * Creates and returns a copy of this object.
      *
      * @return copy of this {@code Object}
      */
-   public abstract Object clone();
+    @Override
+    public abstract Object clone();
 }