From f757ef9c8ed42e4caabeb5d7126320d1d6e2aaad Mon Sep 17 00:00:00 2001
From: Martin Goik <goik@hdm-stuttgart.de>
Date: Tue, 17 Jan 2023 15:29:06 +0100
Subject: [PATCH] Some Java 17 cosmetics applied

---
 Klausuren/Sd1/2018winter/Solve/Readme.md            | 13 +++++++++++--
 Klausuren/Sd1/2018winter/Solve/pom.xml              |  2 +-
 .../de/hdm_stuttgart/mi/sd1/aufgabe1/_2_Person.java |  5 +++++
 .../mi/sd1/aufgabe1/_3_ArrayHelper.java             |  2 ++
 .../java/de/hdm_stuttgart/mi/sd1/aufgabe2/Geo.java  |  8 +++-----
 5 files changed, 22 insertions(+), 8 deletions(-)

diff --git a/Klausuren/Sd1/2018winter/Solve/Readme.md b/Klausuren/Sd1/2018winter/Solve/Readme.md
index 2491ba2c5..6cf0117cb 100644
--- a/Klausuren/Sd1/2018winter/Solve/Readme.md
+++ b/Klausuren/Sd1/2018winter/Solve/Readme.md
@@ -1,4 +1,14 @@
-Aquire exam unit test results:
+# Generate API using Javadoc:
+
+```
+mvn javadoc:javadoc
+```
+
+Then open [target/site/apidocs/index.html](target/site/apidocs/index.html) in your browser of choice.
+
+
+
+# Aquire exam unit test results:
 
 ```shell
 mvn compile test-compile
@@ -6,6 +16,5 @@ mvn -Dmaven.test.skip=true package
 java -jar target/sd1_2018winter_solve-0.9-fat-tests.jar
 ```
 
-See [generatated API docs]().
 
 
diff --git a/Klausuren/Sd1/2018winter/Solve/pom.xml b/Klausuren/Sd1/2018winter/Solve/pom.xml
index 25ecf28bb..9811c8b60 100644
--- a/Klausuren/Sd1/2018winter/Solve/pom.xml
+++ b/Klausuren/Sd1/2018winter/Solve/pom.xml
@@ -55,7 +55,7 @@
                     <!-- Tweak: Get rid of Error message
                       »fetching link: .../target/javadoc-bundle-options. Ignored it«
                       corresponding to api_11 below -->
-                    <release>11</release>
+                    <release>17</release>
                     <doclint>all</doclint>
                     <show>public</show>
                     <docfilessubdirs>true</docfilessubdirs>
diff --git a/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe1/_2_Person.java b/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe1/_2_Person.java
index 60d00bd5b..c50f98631 100644
--- a/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe1/_2_Person.java
+++ b/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe1/_2_Person.java
@@ -62,4 +62,9 @@ public class _2_Person {
   public String toString() {
     return vorname + " " + nachname + " (" + geschlecht + ")";
   }
+
+  private _2_Person() {
+    /* Pls. ignore me; My sole purpose is suppressing default constructor Javadoc generation */
+    nachname = vorname = null;
+  }
 }
diff --git a/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe1/_3_ArrayHelper.java b/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe1/_3_ArrayHelper.java
index 6629b974c..28f08f4fa 100644
--- a/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe1/_3_ArrayHelper.java
+++ b/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe1/_3_ArrayHelper.java
@@ -84,4 +84,6 @@ public class _3_ArrayHelper {
     }
     return false;
   }
+
+  private _3_ArrayHelper() {/* Pls. ignore me; My sole purpose is suppressing default constructor Javadoc generation */}
 }
diff --git a/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe2/Geo.java b/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe2/Geo.java
index d1541fde0..c95af295c 100644
--- a/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe2/Geo.java
+++ b/Klausuren/Sd1/2018winter/Solve/src/main/java/de/hdm_stuttgart/mi/sd1/aufgabe2/Geo.java
@@ -164,7 +164,7 @@ import java.text.DecimalFormat;
  */
 public class Geo implements Comparable<Geo> {
 
-  private static DecimalFormat df = new DecimalFormat();
+  private static final DecimalFormat df = new DecimalFormat();
   static {
     df.setMaximumFractionDigits(6);
     df.setMinimumFractionDigits(6);
@@ -173,7 +173,7 @@ public class Geo implements Comparable<Geo> {
   static private boolean nutzeDezimalDarstellung = false;
 
   /**
-   * Die {@link #toString()} erzeugt im Standard einen String der Form »48° 23' 11''«. Alternativ
+   * Die {@link #toString()} erzeugt im Standard einen String der Form »<code>48° 23' 11"</code>«. Alternativ
    * kann auch die dezimale Graddarstellung der Art »48.78222222...« als Default festgelegt werden.
    * @param nutzeDezimalDarstellung Für true erzeugt {@link #toString()} die Darstellung  »48.78222222...«,
    *                          ansonsten »48°,23',11''«.
@@ -262,9 +262,7 @@ public class Geo implements Comparable<Geo> {
 
   @Override
   public boolean equals(final Object other) {
-    if (other instanceof Geo) {
-      final Geo g = (Geo) other;
-
+    if (other instanceof final Geo g) {
       return grad == g.grad && minuten == g.minuten && sekunden == g.sekunden;
     } else {
       return false;
-- 
GitLab