COMPARISONJAVA-1051 - Update product Public Docs

COMPARISONJAVA-1052 - Prepare Changelog and Release Notes

Author: oleksii-unnamed

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/accept-or-reject-document-changes.md

@@ -28,27 +28,21 @@ The following code sample shows how to accept/reject detected changes.
 ## Accept or Reject changes from local disk
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
     comparer.compare("C:\\result.pdf");
-} finally {
-    comparer.dispose();
 }
 ```
 
 ## Accept or Reject changes from stream
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
     comparer.compare();
     ChangeInfo[] changes = comparer.getChanges();
     changes[0].setComparisonAction(ComparisonAction.REJECT);
     comparer.applyChanges(new FileOutputStream("C:\\result.pdf"), new ApplyChangeOptions(changes));
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/adjusting-comparison-sensitivity.md

@@ -49,16 +49,13 @@ The following code snippet demonstrates how compare files with specific sensit
 ## Compare files with sensitivity adjustment
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
 
     CompareOptions compareOptions = new CompareOptions();
     compareOptions.setSensitivityOfComparison(100);
 
     comparer.compare("C:\\result.pdf", compareOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/compare-multiple-documents/_index.md

@@ -23,28 +23,22 @@ The following code sample shows how to compare multiple documents with specific
 ## Compare multiple documents from local disk
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target1.pdf");
     comparer.add("C:\\target2.pdf");
     comparer.add("C:\\target3.pdf");
     comparer.compare("C:\\result.pdf");
-} finally {
-    comparer.dispose();
 }
 ```
 
 ## Compare multiple documents from stream
 
 ```java
-Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"));
-try {
+try (Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"))) {
     comparer.add(new FileInputStream("C:\\target1.pdf"));
     comparer.add(new FileInputStream("C:\\target2.pdf"));
     comparer.add(new FileInputStream("C:\\target3.pdf"));
     comparer.compare(new FileOutputStream("C:\\result.pdf"));
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/compare-multiple-documents/compare-multiple-documents-protected-with-password.md

@@ -24,28 +24,22 @@ The following code sample shows how to compare password-protected documents.
 ## Compare multiple protected documents from local disk
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf", new LoadOptions("source-password"));
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf", new LoadOptions("source-password"))) {
     comparer.add("C:\\target1.pdf", new LoadOptions("target-password"));
     comparer.add("C:\\target2.pdf", new LoadOptions("target-password"));
     comparer.add("C:\\target3.pdf", new LoadOptions("target-password"));
     comparer.compare("C:\\result.pdf");
-} finally {
-    comparer.dispose();
 }
 ```
 
 ## Compare multiple protected documents from stream
 
 ```java
-Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"), new LoadOptions("source-password"));
-try {
+try (Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"), new LoadOptions("source-password"))) {
     comparer.add(new FileInputStream("C:\\target1.pdf"), new LoadOptions("target-password"));
     comparer.add(new FileInputStream("C:\\target2.pdf"), new LoadOptions("target-password"));
     comparer.add(new FileInputStream("C:\\target3.pdf"), new LoadOptions("target-password"));
     comparer.compare(new FileOutputStream("C:\\result.pdf"));
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/compare-multiple-documents/compare-multiple-documents-with-specific-compare-settings.md

@@ -22,8 +22,7 @@ The following code sample shows how to compare multiple documents with specific
 ## Compare multiple documents with specific compare settings from local disk
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target1.pdf");
     comparer.add("C:\\target2.pdf");
     comparer.add("C:\\target3.pdf");
@@ -35,16 +34,13 @@ try {
     compareOptions.setInsertedItemStyle(styleSettings);
 
     comparer.compare("C:\\result.pdf", compareOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 
 ## Compare multiple documents with specific compare settings from stream
 
 ```java
-Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"));
-try {
+try (Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"))) {
     comparer.add(new FileInputStream("C:\\target1.pdf"));
     comparer.add(new FileInputStream("C:\\target2.pdf"));
     comparer.add(new FileInputStream("C:\\target3.pdf"));
@@ -56,8 +52,6 @@ try {
     compareOptions.setInsertedItemStyle(styleSettings);
 
     comparer.compare(new FileOutputStream("C:\\result.pdf"), compareOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/customize-changes-styles.md

@@ -23,8 +23,7 @@ The following code snippet demonstrates how to compare files with specific opt
 ## Compare files from local disk with custom change styles
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
 
     CompareOptions compareOptions = new CompareOptions();
@@ -53,16 +52,13 @@ try {
     changedStyleSettings.setItalic(true);
     compareOptions.setChangedItemStyle(changedStyleSettings);
     comparer.compare("C:\\result.pdf", compareOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 
 ## Compare files from stream with custom change styles
 
 ```java
-Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"));
-try {
+try (Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"))) {
     comparer.add(new FileInputStream("C:\\target.pdf"));
 
     CompareOptions compareOptions = new CompareOptions();
@@ -91,8 +87,6 @@ try {
     changedStyleSettings.setItalic(true);
     compareOptions.setChangedItemStyle(changedStyleSettings);
     comparer.compare(new FileOutputStream("C:\\result.pdf"), compareOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/get-changes-coordinates.md

@@ -24,8 +24,7 @@ The following code sample shows how to get changes coordinates.
 ## Coordinates calculation example
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
 
     CompareOptions compareOptions = new CompareOptions();
@@ -36,8 +35,6 @@ try {
     for (ChangeInfo change : changes) {
         System.out.println(String.format("Change Type: %d, X: %f, Y: %f, Text: %s", change.getType(), change.getBox().getX(), change.getBox().getY(), change.getText()));
     }
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/comparison/get-list-of-changes.md

@@ -23,28 +23,22 @@ The following code sample demonstrates how to get list of all changes.
 ## Get list of changes from local disk
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
     comparer.compare();
     ChangeInfo[] changes = comparer.getChanges();
     System.out.println("Count of changes: " + changes.length);
-} finally {
-    comparer.dispose();
 }
 ```
 
 ## Get list of changes from stream
 
 ```java
-Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"));
-try {
+try (Comparer comparer = new Comparer(new FileInputStream("C:\\source.pdf"))) {
     comparer.add(new FileInputStream("C:\\target.pdf"));
     comparer.compare();
     ChangeInfo[] changes = comparer.getChanges();
     System.out.println("Count of changes: " + changes.length);
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/generate-document-pages-preview.md

@@ -44,8 +44,7 @@ The following code snippet demonstrates how to generate document previews.
 ## Get page previews for source document
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     PreviewOptions previewOptions = new PreviewOptions(new Delegates.CreatePageStream() {
         @Override
         public OutputStream invoke(int pageNumber) {
@@ -61,18 +60,14 @@ try {
     previewOptions.setPreviewFormat(PreviewFormats.PNG);
     previewOptions.setPageNumbers(new int[]{1, 2});
     comparer.getSource().generatePreview(previewOptions);
-} finally {
-    comparer.dispose();
 }
-
 ```
 
 ## Get page previews for target document
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-comparer.add("C:\\target.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
+    comparer.add("C:\\target.pdf");
     PreviewOptions previewOptions = new PreviewOptions(new Delegates.CreatePageStream() {
         @Override
         public OutputStream invoke(int pageNumber) {
@@ -88,16 +83,13 @@ try {
     previewOptions.setPreviewFormat(PreviewFormats.PNG);
     previewOptions.setPageNumbers(new int[]{1, 2});
     comparer.getTargets().get(0).generatePreview(previewOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 
 ## Get page previews for resultant document
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
     comparer.compare("C:\\target.pdf");
     Document document = new Document("C:\\result.pdf");
@@ -116,8 +108,6 @@ try {
     previewOptions.setPreviewFormat(PreviewFormats.PNG);
     previewOptions.setPageNumbers(new int[]{1, 2});
     document.generatePreview(previewOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 
@@ -128,8 +118,7 @@ In some cases it may be useful to set specific image size during document pages
 The following code snippet demonstrates how to set specific size for preview images.
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
     comparer.compare(new FileOutputStream("C:\\result.pdf"));
     Document document = new Document("C:\\result.pdf");
@@ -151,8 +140,6 @@ try {
     previewOptions.setHeight(1000);
     previewOptions.setWidth(1000);
     document.generatePreview(previewOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 
@@ -170,8 +157,7 @@ private static void userReleaseStreamMethod(int pageNumber, OutputStream stream)
 }
 
 // Somewhere in the same class
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
     comparer.compare("C:\\result.pdf");
     Document document = new Document("C:\\result.pdf");
@@ -197,8 +183,6 @@ try {
         }
     });
     document.generatePreview(previewOptions);
-} finally {
-    comparer.dispose();
 }
 ```
 

Docs/content/comparison/java/developer-guide/advanced-usage/loading/load-file-from-local-disk.md

@@ -13,12 +13,9 @@ When the source file is located on the local disk **[GroupDocs.Comparison](htt
 Following code snippet shows how to load files from local disk.
 
 ```java
-Comparer comparer = new Comparer("C:\\source.pdf");
-try {
+try (Comparer comparer = new Comparer("C:\\source.pdf")) {
     comparer.add("C:\\target.pdf");
     comparer.compare("C:\\result.pdf");
-} finally {
-    comparer.dispose();
 }
 ```