record #232/#235, credit @Boiarshinov and add since tags

bodewig · bodewig · commit e6dcb3816225 · 2021-10-04T08:30:08.000+02:00
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -2,6 +2,13 @@
 
 ## XMLUnit for Java 2.8.3 - /not released, yet/
 
+* added a new `fullDescription` method to `Diff` that provides a
+  string-representation of all differences - not just the first one
+  like `toString` does.
+  PR [#235](https://github.com/xmlunit/xmlunit/issues/235) fixing
+  [#232](https://github.com/xmlunit/xmlunit/issues/232) by
+  [@Boiarshinov](https://github.com/Boiarshinov)
+
 * made sure AssertJ's methods to override the assertion message like
   `withFailMessage` are honored.
   [#225](https://github.com/xmlunit/xmlunit/issues/225)
diff --git a/xmlunit-core/src/main/java/org/xmlunit/diff/Diff.java b/xmlunit-core/src/main/java/org/xmlunit/diff/Diff.java
@@ -53,8 +53,11 @@ public Diff(Source controlSource, Source testSource,
      * Returns a string representation of this diff
      * using internal {@link ComparisonFormatter} or
      * {@link DefaultComparisonFormatter} if formatter wasn't set.
-     * Each comparison result separated by the end of the line.
+     *
+     * <p>Each comparison result separated by the end of the line.</p>
+     *
      * @return a string representation of this diff
+     * @since 2.8.3
      */
     public String fullDescription() {
         return fullDescription(formatter);
@@ -63,8 +66,12 @@ public String fullDescription() {
     /**
      * Returns a string representation of this diff
      * using the given {@link ComparisonFormatter}
+     *
+     * <p>Each comparison result separated by the end of the line.</p>
+     *
      * @param formatter the {@link ComparisonFormatter} to use
      * @return a string representation of this diff
+     * @since 2.8.3
      */
     public String fullDescription(ComparisonFormatter formatter) {
         if (!hasDifferences()) {
