From da0c3d8d5f14cd4c896ba93b35b698f14eecbef5 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 6 Oct 2023 16:09:47 +0200
Subject: [PATCH 01/89] Improve the readability of parent project references

---
 java/executable-jar-maven-intellij/README.md | 2 +-
 java/java-project-cli/README.md              | 6 +++---
 java/java-project-intellij/README.md         | 6 +++---
 java/java-project-maven-intellij/README.md   | 4 ++--
 4 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/java/executable-jar-maven-intellij/README.md b/java/executable-jar-maven-intellij/README.md
index 423c027..f9730f1 100644
--- a/java/executable-jar-maven-intellij/README.md
+++ b/java/executable-jar-maven-intellij/README.md
@@ -4,7 +4,7 @@
 
 ## Introduction
 
-With this part of the [Challenges](../..) > [Java](..) project, I provide the code and settings for a project that can create an executable JAR using Maven and IntelliJ IDEA.
+With this part of the [Java challenges](..) project, I provide the code and settings for a project that can create an executable JAR using Maven and IntelliJ IDEA.
 
 Below, I give [background information](#1-background) on the project's [code](#11-java), [IntelliJ IDEA's configuration](#12-intellij-idea) and the used [Maven configuration](#13-maven).
 I also detail some [issues](#2-issues-and-solutions) that can occur when creating an executable JAR using Maven, for which I provide possible solutions.
diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 7c10bfe..22e32b2 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -4,21 +4,21 @@
 
 ## Introduction
 
-With this part of the [Challenges](../..) > [Java](..) project, I provide the code and settings for a Java project, set up using the command line.
+With this part of the [Java challenges](..) project, I provide the code and settings for a Java project, set up using the command line.
 
 Below, I give detailed [background information](#1-background) on the project's [code](#11-java).
 In addition, I list several [issues](#2-issues-and-solutions) that can occur when setting up a Java project.
 I also describe solutions to these issues.
 
 Listed commands can, for example, be executed using Bash.
-I describe this command-line interface in the [Bash section](../#22-bash) of the [Challenges](../..) > [Java](..) project.
+I describe this command-line interface in the [Bash section](../#22-bash) of the [Java challenges](..) project.
 
 ## 1. Background
 
 ### 1.1 Java
 
 This project makes use of Java.
-I describe this programming language in the [Java section](../#21-java) of the [Challenges](../..) > [Java](..) project.
+I describe this programming language in the [Java section](../#21-java) of the [Java challenges](..) project.
 
 #### 1.1.1 Code
 
diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index ed70290..1dc031e 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -4,7 +4,7 @@
 
 ## Introduction
 
-With this part of the [Challenges](../..) > [Java](..) project, I provide the code and settings for a Java project set up using IntelliJ IDEA.
+With this part of the [Java challenges](..) project, I provide the code and settings for a Java project set up using IntelliJ IDEA.
 
 Below, I give [background information](#1-background) on the project's [code](#11-java) and [IntelliJ IDEA's configuration](#12-intellij-idea).
 
@@ -13,7 +13,7 @@ Below, I give [background information](#1-background) on the project's [code](#1
 ### 1.1 Java
 
 This project makes use of Java.
-I describe this programming language in the [Java section](../#21-java) of the [Challenges](../..) > [Java](..) project.
+I describe this programming language in the [Java section](../#21-java) of the [Java challenges](..) project.
 
 #### 1.1.1 Code
 
@@ -31,7 +31,7 @@ public class Main {
 
 ### 1.2 IntelliJ IDEA
 
-This project is set up using IntelliJ IDEA (see, e.g., the [IntelliJ IDEA section](../#23-intellij-idea) of the [Challenges](../..) > [Java](..) project).
+This project is set up using IntelliJ IDEA (see, e.g., the [IntelliJ IDEA section](../#23-intellij-idea) of the [Java challenges](..) project).
 
 The used IntelliJ IDEA configuration is described in what follows.
 
diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index e4b2a6f..d04d358 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -4,7 +4,7 @@
 
 ## Introduction
 
-With this part of the [Challenges](../..) > [Java](..) project, I provide the code and settings for a Java project set up using Maven and IntelliJ IDEA.
+With this part of the [Java challenges](..) project, I provide the code and settings for a Java project set up using Maven and IntelliJ IDEA.
 
 Below, I give detailed [background information](#1-background) on the project's [code](#11-java), [IntelliJ IDEA's configuration](#12-intellij-idea) and the used [Maven configuration](#13-maven).
 I also describe several [issues](#2-issues-and-solutions) that can occur when setting up a Maven project, for which I provide possible solutions.
@@ -45,7 +45,7 @@ Note that execution of the JAR will [fail](#24-maven-jar-plugin-issues).
 
 ### 1.3 Maven
 
-This Java project is managed and built using Maven (see, e.g., the [Maven section](../#24-maven) of the [Challenges](../..) > [Java](..) project).
+This Java project is managed and built using Maven (see, e.g., the [Maven section](../#24-maven) of the [Java challenges](..) project).
 
 The Maven configuration of the current project is detailed in what follows.
 

From 8e977ee1d009835c8689c26be0e4031345e21273 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Sun, 8 Oct 2023 13:49:28 +0200
Subject: [PATCH 02/89] Update the keep a changelog version

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 723d111..0d48119 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,7 +2,7 @@
 
 All notable changes to the [Challenges](https://github.com/mauritssilvis/challenges) project are documented in this file.
 
-The file format is based on [keep a changelog](https://keepachangelog.com/en/1.0.0/),
+The file format is based on [keep a changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
 ## [0.3.1] - 2023-09-16

From 379153c0fad19a49a15cc74b8d284fe09204e59a Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 16:52:08 +0200
Subject: [PATCH 03/89] Add a list of solved challenges to the top-level readme

---
 README.md | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/README.md b/README.md
index 1abf2c8..4f14dd3 100644
--- a/README.md
+++ b/README.md
@@ -33,6 +33,13 @@ Currently, solutions to common programming challenges are available for the foll
 
 - [Java](java)
 
+Specifically, I solved the following challenges:
+
+- [Setting up a Java project using the command line](java/java-project-cli)
+- [Setting up a Java project using IntelliJ IDEA](java/java-project-intellij)
+- [Setting up a Java project using Maven and IntelliJ IDEA](java/java-project-maven-intellij)
+- [Creating an executable JAR using Maven and IntelliJ IDEA](java/executable-jar-maven-intellij)
+
 ## License
 
 Copyright © 2021–2023 Maurits Silvis

From ff4d03176e32ed96aab093982cc0d4060bad45e9 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 17:31:18 +0200
Subject: [PATCH 04/89] Add a Git attributes file

---
 .gitattributes | 4 ++++
 1 file changed, 4 insertions(+)
 create mode 100644 .gitattributes

diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..0a0f148
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,4 @@
+# https://help.github.com/articles/dealing-with-line-endings/
+* text eol=lf
+
+*.bat text eol=crlf

From 6171279bd08b70a20a42367f33f282d40fa851c8 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 17:40:28 +0200
Subject: [PATCH 05/89] Add IntelliJ IDEA inspections

---
 .../.idea/inspectionProfiles/All.xml                | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/java/java-project-intellij/.idea/inspectionProfiles/All.xml b/java/java-project-intellij/.idea/inspectionProfiles/All.xml
index a2b8fc5..bcdaa4a 100644
--- a/java/java-project-intellij/.idea/inspectionProfiles/All.xml
+++ b/java/java-project-intellij/.idea/inspectionProfiles/All.xml
@@ -202,6 +202,8 @@
     </inspection_tool>
     <inspection_tool class="ContinueStatement" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ContinueStatementWithLabel" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ConvertJavadoc" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ConvertOldAnnotations" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CovariantEquals" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CustomClassloader" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CustomSecurityManager" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -215,6 +217,7 @@
       <option name="ignoreLocalVariables" value="false" />
       <option name="ignorePrivateMethodsAndFields" value="false" />
     </inspection_tool>
+    <inspection_tool class="DeconstructionCanBeUsed" enabled="true" level="INFORMATION" enabled_by_default="true" />
     <inspection_tool class="DefaultNotLastCaseInSwitch" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="DesignForExtension" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="DisjointPackage" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -247,6 +250,7 @@
     <inspection_tool class="ExceptionNameDoesntEndWithException" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExceptionPackage" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExpectedExceptionNeverThrown" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ExpectedExceptionNeverThrownTestNG" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsConcreteCollection" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsThread" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsThrowable" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -362,6 +366,7 @@
       <option name="insideTryAllowed" value="false" />
     </inspection_tool>
     <inspection_tool class="JUnit5Converter" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="JUnitTestNG" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="JavaAnnotator" enabled="true" level="ERROR" enabled_by_default="true" />
     <inspection_tool class="JavaLangImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="JavadocHtmlLint" enabled="true" level="ERROR" enabled_by_default="true" />
@@ -514,7 +519,6 @@
     </inspection_tool>
     <inspection_tool class="NonSerializableObjectBoundToHttpSession" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonSerializableObjectPassedToObjectStream" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="NonSerializableWithSerialVersionUIDField" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonSerializableWithSerializationMethods" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonShortCircuitBoolean" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonStaticFinalLogger" enabled="true" level="WARNING" enabled_by_default="true">
@@ -640,6 +644,7 @@
       <option name="ignoreCloneable" value="false" />
     </inspection_tool>
     <inspection_tool class="RedundantModifiersUtilityClassLombok" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="RegExpAnonymousGroup" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ResultOfObjectAllocationIgnored" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ResultSetIndexZero" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ReturnNull" enabled="true" level="WARNING" enabled_by_default="true">
@@ -655,7 +660,6 @@
     <inspection_tool class="SafeLock" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SamePackageImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerialPersistentFieldsWithWrongSignature" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="SerialVersionUIDNotStaticFinal" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableDeserializableClassInSecureContext" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableHasSerialVersionUIDField" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableHasSerializationMethods" enabled="true" level="WARNING" enabled_by_default="true">
@@ -681,7 +685,6 @@
     <inspection_tool class="SingleCharacterStartsWith" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SingleClassImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="Singleton" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="SizeReplaceableByIsEmpty" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SleepWhileHoldingLock" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SocketResource" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="insideTryAllowed" value="false" />
@@ -697,6 +700,7 @@
     <inspection_tool class="StaticInheritance" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticMethodOnlyUsedInOneClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticNonFinalField" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="StaticPseudoFunctionalStyleMethod" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticVariableInitialization" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_ignorePrimitives" value="false" />
     </inspection_tool>
@@ -719,7 +723,6 @@
     <inspection_tool class="StringConcatenationInFormatCall" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringConcatenationInMessageFormatCall" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringConcatenationMissingWhitespace" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="StringEqualsEmptyString" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringReplaceableByStringBuffer" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="onlyWarnOnLoop" value="true" />
     </inspection_tool>
@@ -774,7 +777,6 @@
     <inspection_tool class="ThrowCaughtLocally" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="ignoreRethrownExceptions" value="false" />
     </inspection_tool>
-    <inspection_tool class="ThrowablePrintStackTrace" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ThrownExceptionsPerMethod" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_limit" value="3" />
     </inspection_tool>
@@ -794,6 +796,7 @@
     <inspection_tool class="TypeParameterExtendsFinalClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UncheckedExceptionClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnconditionalWait" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="UndeclaredTests" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnknownGuard" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnnecessarilyQualifiedStaticUsage" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_ignoreStaticFieldAccesses" value="false" />

From f9b151182af1a2e2dc46409333c93aa00d708f4e Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 17:42:33 +0200
Subject: [PATCH 06/89] Select the project JDK

---
 java/java-project-intellij/.idea/misc.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/java/java-project-intellij/.idea/misc.xml b/java/java-project-intellij/.idea/misc.xml
index fa6ef4b..2498d8d 100644
--- a/java/java-project-intellij/.idea/misc.xml
+++ b/java/java-project-intellij/.idea/misc.xml
@@ -1,5 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_20" default="true" project-jdk-name="temurin-20" project-jdk-type="JavaSDK">
+  <!-- TODO: Set project-jdk-name to temurin-21 -->
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="21" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/out" />
   </component>
 </project>
\ No newline at end of file

From c1b176a0f3b2cc6ed2a6247d80b137e298628616 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 17:47:32 +0200
Subject: [PATCH 07/89] Add IntelliJ IDEA inspections

---
 .../.idea/inspectionProfiles/All.xml                | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/java/java-project-maven-intellij/.idea/inspectionProfiles/All.xml b/java/java-project-maven-intellij/.idea/inspectionProfiles/All.xml
index a2b8fc5..bcdaa4a 100644
--- a/java/java-project-maven-intellij/.idea/inspectionProfiles/All.xml
+++ b/java/java-project-maven-intellij/.idea/inspectionProfiles/All.xml
@@ -202,6 +202,8 @@
     </inspection_tool>
     <inspection_tool class="ContinueStatement" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ContinueStatementWithLabel" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ConvertJavadoc" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ConvertOldAnnotations" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CovariantEquals" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CustomClassloader" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CustomSecurityManager" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -215,6 +217,7 @@
       <option name="ignoreLocalVariables" value="false" />
       <option name="ignorePrivateMethodsAndFields" value="false" />
     </inspection_tool>
+    <inspection_tool class="DeconstructionCanBeUsed" enabled="true" level="INFORMATION" enabled_by_default="true" />
     <inspection_tool class="DefaultNotLastCaseInSwitch" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="DesignForExtension" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="DisjointPackage" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -247,6 +250,7 @@
     <inspection_tool class="ExceptionNameDoesntEndWithException" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExceptionPackage" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExpectedExceptionNeverThrown" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ExpectedExceptionNeverThrownTestNG" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsConcreteCollection" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsThread" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsThrowable" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -362,6 +366,7 @@
       <option name="insideTryAllowed" value="false" />
     </inspection_tool>
     <inspection_tool class="JUnit5Converter" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="JUnitTestNG" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="JavaAnnotator" enabled="true" level="ERROR" enabled_by_default="true" />
     <inspection_tool class="JavaLangImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="JavadocHtmlLint" enabled="true" level="ERROR" enabled_by_default="true" />
@@ -514,7 +519,6 @@
     </inspection_tool>
     <inspection_tool class="NonSerializableObjectBoundToHttpSession" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonSerializableObjectPassedToObjectStream" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="NonSerializableWithSerialVersionUIDField" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonSerializableWithSerializationMethods" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonShortCircuitBoolean" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonStaticFinalLogger" enabled="true" level="WARNING" enabled_by_default="true">
@@ -640,6 +644,7 @@
       <option name="ignoreCloneable" value="false" />
     </inspection_tool>
     <inspection_tool class="RedundantModifiersUtilityClassLombok" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="RegExpAnonymousGroup" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ResultOfObjectAllocationIgnored" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ResultSetIndexZero" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ReturnNull" enabled="true" level="WARNING" enabled_by_default="true">
@@ -655,7 +660,6 @@
     <inspection_tool class="SafeLock" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SamePackageImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerialPersistentFieldsWithWrongSignature" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="SerialVersionUIDNotStaticFinal" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableDeserializableClassInSecureContext" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableHasSerialVersionUIDField" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableHasSerializationMethods" enabled="true" level="WARNING" enabled_by_default="true">
@@ -681,7 +685,6 @@
     <inspection_tool class="SingleCharacterStartsWith" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SingleClassImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="Singleton" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="SizeReplaceableByIsEmpty" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SleepWhileHoldingLock" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SocketResource" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="insideTryAllowed" value="false" />
@@ -697,6 +700,7 @@
     <inspection_tool class="StaticInheritance" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticMethodOnlyUsedInOneClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticNonFinalField" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="StaticPseudoFunctionalStyleMethod" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticVariableInitialization" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_ignorePrimitives" value="false" />
     </inspection_tool>
@@ -719,7 +723,6 @@
     <inspection_tool class="StringConcatenationInFormatCall" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringConcatenationInMessageFormatCall" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringConcatenationMissingWhitespace" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="StringEqualsEmptyString" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringReplaceableByStringBuffer" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="onlyWarnOnLoop" value="true" />
     </inspection_tool>
@@ -774,7 +777,6 @@
     <inspection_tool class="ThrowCaughtLocally" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="ignoreRethrownExceptions" value="false" />
     </inspection_tool>
-    <inspection_tool class="ThrowablePrintStackTrace" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ThrownExceptionsPerMethod" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_limit" value="3" />
     </inspection_tool>
@@ -794,6 +796,7 @@
     <inspection_tool class="TypeParameterExtendsFinalClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UncheckedExceptionClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnconditionalWait" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="UndeclaredTests" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnknownGuard" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnnecessarilyQualifiedStaticUsage" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_ignoreStaticFieldAccesses" value="false" />

From 977d622b80c848572e0576c21604d75109d7a0ad Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 17:49:29 +0200
Subject: [PATCH 08/89] Select the project JDK

---
 java/java-project-maven-intellij/.idea/misc.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/java/java-project-maven-intellij/.idea/misc.xml b/java/java-project-maven-intellij/.idea/misc.xml
index f81f24a..41147fb 100644
--- a/java/java-project-maven-intellij/.idea/misc.xml
+++ b/java/java-project-maven-intellij/.idea/misc.xml
@@ -1,3 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ExternalStorageConfigurationManager" enabled="true" />
   <component name="MavenProjectsManager">
@@ -7,5 +8,6 @@
       </list>
     </option>
   </component>
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_20" default="true" project-jdk-name="temurin-20" project-jdk-type="JavaSDK" />
+  <!-- TODO: Set project-jdk-name to temurin-21 -->
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="21" project-jdk-type="JavaSDK" />
 </project>
\ No newline at end of file

From 977aeab4a622dbf11cc282cb1eef141aa619050a Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 17:51:51 +0200
Subject: [PATCH 09/89] Add IntelliJ IDEA inspections

---
 .../.idea/inspectionProfiles/All.xml                | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/java/executable-jar-maven-intellij/.idea/inspectionProfiles/All.xml b/java/executable-jar-maven-intellij/.idea/inspectionProfiles/All.xml
index a2b8fc5..bcdaa4a 100644
--- a/java/executable-jar-maven-intellij/.idea/inspectionProfiles/All.xml
+++ b/java/executable-jar-maven-intellij/.idea/inspectionProfiles/All.xml
@@ -202,6 +202,8 @@
     </inspection_tool>
     <inspection_tool class="ContinueStatement" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ContinueStatementWithLabel" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ConvertJavadoc" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ConvertOldAnnotations" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CovariantEquals" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CustomClassloader" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="CustomSecurityManager" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -215,6 +217,7 @@
       <option name="ignoreLocalVariables" value="false" />
       <option name="ignorePrivateMethodsAndFields" value="false" />
     </inspection_tool>
+    <inspection_tool class="DeconstructionCanBeUsed" enabled="true" level="INFORMATION" enabled_by_default="true" />
     <inspection_tool class="DefaultNotLastCaseInSwitch" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="DesignForExtension" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="DisjointPackage" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -247,6 +250,7 @@
     <inspection_tool class="ExceptionNameDoesntEndWithException" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExceptionPackage" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExpectedExceptionNeverThrown" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="ExpectedExceptionNeverThrownTestNG" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsConcreteCollection" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsThread" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ExtendsThrowable" enabled="true" level="WARNING" enabled_by_default="true" />
@@ -362,6 +366,7 @@
       <option name="insideTryAllowed" value="false" />
     </inspection_tool>
     <inspection_tool class="JUnit5Converter" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="JUnitTestNG" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="JavaAnnotator" enabled="true" level="ERROR" enabled_by_default="true" />
     <inspection_tool class="JavaLangImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="JavadocHtmlLint" enabled="true" level="ERROR" enabled_by_default="true" />
@@ -514,7 +519,6 @@
     </inspection_tool>
     <inspection_tool class="NonSerializableObjectBoundToHttpSession" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonSerializableObjectPassedToObjectStream" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="NonSerializableWithSerialVersionUIDField" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonSerializableWithSerializationMethods" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonShortCircuitBoolean" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="NonStaticFinalLogger" enabled="true" level="WARNING" enabled_by_default="true">
@@ -640,6 +644,7 @@
       <option name="ignoreCloneable" value="false" />
     </inspection_tool>
     <inspection_tool class="RedundantModifiersUtilityClassLombok" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="RegExpAnonymousGroup" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ResultOfObjectAllocationIgnored" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ResultSetIndexZero" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ReturnNull" enabled="true" level="WARNING" enabled_by_default="true">
@@ -655,7 +660,6 @@
     <inspection_tool class="SafeLock" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SamePackageImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerialPersistentFieldsWithWrongSignature" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="SerialVersionUIDNotStaticFinal" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableDeserializableClassInSecureContext" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableHasSerialVersionUIDField" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SerializableHasSerializationMethods" enabled="true" level="WARNING" enabled_by_default="true">
@@ -681,7 +685,6 @@
     <inspection_tool class="SingleCharacterStartsWith" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SingleClassImport" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="Singleton" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="SizeReplaceableByIsEmpty" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SleepWhileHoldingLock" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="SocketResource" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="insideTryAllowed" value="false" />
@@ -697,6 +700,7 @@
     <inspection_tool class="StaticInheritance" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticMethodOnlyUsedInOneClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticNonFinalField" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="StaticPseudoFunctionalStyleMethod" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StaticVariableInitialization" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_ignorePrimitives" value="false" />
     </inspection_tool>
@@ -719,7 +723,6 @@
     <inspection_tool class="StringConcatenationInFormatCall" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringConcatenationInMessageFormatCall" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringConcatenationMissingWhitespace" enabled="true" level="WARNING" enabled_by_default="true" />
-    <inspection_tool class="StringEqualsEmptyString" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="StringReplaceableByStringBuffer" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="onlyWarnOnLoop" value="true" />
     </inspection_tool>
@@ -774,7 +777,6 @@
     <inspection_tool class="ThrowCaughtLocally" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="ignoreRethrownExceptions" value="false" />
     </inspection_tool>
-    <inspection_tool class="ThrowablePrintStackTrace" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="ThrownExceptionsPerMethod" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_limit" value="3" />
     </inspection_tool>
@@ -794,6 +796,7 @@
     <inspection_tool class="TypeParameterExtendsFinalClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UncheckedExceptionClass" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnconditionalWait" enabled="true" level="WARNING" enabled_by_default="true" />
+    <inspection_tool class="UndeclaredTests" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnknownGuard" enabled="true" level="WARNING" enabled_by_default="true" />
     <inspection_tool class="UnnecessarilyQualifiedStaticUsage" enabled="true" level="WARNING" enabled_by_default="true">
       <option name="m_ignoreStaticFieldAccesses" value="false" />

From 5ac5a4261546f48639c226416129950418f745b2 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 17:52:20 +0200
Subject: [PATCH 10/89] Select the project JDK

---
 java/executable-jar-maven-intellij/.idea/misc.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/java/executable-jar-maven-intellij/.idea/misc.xml b/java/executable-jar-maven-intellij/.idea/misc.xml
index f81f24a..41147fb 100644
--- a/java/executable-jar-maven-intellij/.idea/misc.xml
+++ b/java/executable-jar-maven-intellij/.idea/misc.xml
@@ -1,3 +1,4 @@
+<?xml version="1.0" encoding="UTF-8"?>
 <project version="4">
   <component name="ExternalStorageConfigurationManager" enabled="true" />
   <component name="MavenProjectsManager">
@@ -7,5 +8,6 @@
       </list>
     </option>
   </component>
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_20" default="true" project-jdk-name="temurin-20" project-jdk-type="JavaSDK" />
+  <!-- TODO: Set project-jdk-name to temurin-21 -->
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="21" project-jdk-type="JavaSDK" />
 </project>
\ No newline at end of file

From 8be4b565c34d8ab5275e529b991ed8a378c75adc Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 18:05:25 +0200
Subject: [PATCH 11/89] Add to-dos

---
 java/java-project-cli/README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 22e32b2..9803ddd 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -20,6 +20,8 @@ I describe this command-line interface in the [Bash section](../#22-bash) of the
 This project makes use of Java.
 I describe this programming language in the [Java section](../#21-java) of the [Java challenges](..) project.
 
+<!-- TODO: Discuss the installation and configuration of Java. -->
+
 #### 1.1.1 Code
 
 For demonstrative purposes, the current project contains only a single Java file, [Main.java](src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main.java), which comprises a Java class with the corresponding name `Main`.
@@ -168,6 +170,8 @@ While setting up a Java project, several issues may occur.
 I list several such issues, here, including possible solutions.
 In particular, I discuss problems related to [compilation](#21-compilation-issues) and [execution](#22-execution-issues) of Java programs.
 
+<!-- TODO: Discuss installation issues. -->
+
 ### 2.1 Compilation issues
 
 #### 2.1.1 file not found

From fe9c349697cdd79c457612dc8babb1dd4043ce27 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 18:10:51 +0200
Subject: [PATCH 12/89] Add to-dos

---
 java/java-project-intellij/README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 1dc031e..28a17db 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -40,6 +40,8 @@ The used IntelliJ IDEA configuration is described in what follows.
 The [.idea](.idea) folder of this project contains several IntelliJ-IDEA-related configuration files.
 A few of these files are highlighted below.
 
+<!-- TODO: Discuss the project JDK choice. -->
+
 ##### Code styles
 
 First, Unix-style line endings are selected in the file [Project.xml](.idea/codeStyles/Project.xml), which facilitates cross-platform coding.
@@ -77,6 +79,8 @@ A profile in which only the default inspections are selected is stored in [Defau
 
 This project comes with one run configuration for executing the `main` method of the `Main` class.
 
+<!-- TODO: Discuss the execution of the code. -->
+
 ## License
 
 Copyright © 2021–2023 Maurits Silvis

From 87583f6d47ae40791ef77f6b823b63906d10c011 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 9 Oct 2023 18:13:57 +0200
Subject: [PATCH 13/89] Improve grammar

---
 java/java-project-cli/README.md      | 10 +++++-----
 java/java-project-intellij/README.md |  4 ++--
 2 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 9803ddd..7ba8b54 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -70,7 +70,7 @@ java-project-cli
 ```
 
 Here, the `src` folder contains the source file, `Main.java`, stored in a directory structure that matches the package of the class `Main`, i.e., `nl.mauritssilvis.challenges.java.cli.manual.projects.basic`.
-The `out` folder, which is created upon [compilation](#113-compilation), has the same structure as the `src` folder, but is there to contain the compiled bytecode instead of source code.
+The `out` folder, which is created upon [compilation](#113-compilation), has the same structure as the `src` folder but is there to contain the compiled bytecode instead of source code.
 
 #### 1.1.3 Compilation
 
@@ -168,7 +168,7 @@ Hello world!
 
 While setting up a Java project, several issues may occur.
 I list several such issues, here, including possible solutions.
-In particular, I discuss problems related to [compilation](#21-compilation-issues) and [execution](#22-execution-issues) of Java programs.
+In particular, I discuss problems related to the [compilation](#21-compilation-issues) and [execution](#22-execution-issues) of Java programs.
 
 <!-- TODO: Discuss installation issues. -->
 
@@ -197,7 +197,7 @@ To solve this problem, use slashes when a file path to a source file is expected
 javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main.java
 ```
 
-Alternatively, ensure that you called the right tool.
+Alternatively, ensure that you call the right tool.
 You may have wanted to call the Java interpreter instead of the Java compiler.
 In that case, ensure you drop any file extensions, you use the fully qualified class name and you execute the class from the proper location:
 
@@ -240,7 +240,7 @@ In addition, ensure the `.java` file extension is present in paths to source fil
 javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main.java
 ```
 
-Alternatively, ensure that you called the right tool.
+Alternatively, ensure that you call the right tool.
 You may have wanted to call the Java interpreter instead of the Java compiler
 In that case, ensure you use the fully qualified class name and you execute the class from the proper location:
 
@@ -272,7 +272,7 @@ In addition, ensure the `.java` file extension (instead of `.class`) is used in
 javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main.java
 ```
 
-Alternatively, ensure that you called the right tool.
+Alternatively, ensure that you call the right tool.
 You may have wanted to call the Java interpreter instead of the Java compiler.
 In that case, ensure you drop any file extensions, you use the fully qualified class name and you execute the class from the proper location:
 
diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 28a17db..22c2c90 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -33,7 +33,7 @@ public class Main {
 
 This project is set up using IntelliJ IDEA (see, e.g., the [IntelliJ IDEA section](../#23-intellij-idea) of the [Java challenges](..) project).
 
-The used IntelliJ IDEA configuration is described in what follows.
+The IntelliJ IDEA configuration is described in what follows.
 
 #### 1.2.1 Configuration
 
@@ -77,7 +77,7 @@ A profile in which only the default inspections are selected is stored in [Defau
 
 ##### Run configurations
 
-This project comes with one run configuration for executing the `main` method of the `Main` class.
+This project comes with a run configuration for executing the `main` method of the `Main` class.
 
 <!-- TODO: Discuss the execution of the code. -->
 

From 591fcc9f7a72f3234fdc61812b85d9bd6740520c Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 10 Oct 2023 11:28:31 +0200
Subject: [PATCH 14/89] Add slashes to directory-level anchor links

---
 java/README.md                               | 4 ++--
 java/executable-jar-maven-intellij/README.md | 6 +++---
 java/java-project-maven-intellij/README.md   | 4 ++--
 3 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/java/README.md b/java/README.md
index e366868..6c19757 100644
--- a/java/README.md
+++ b/java/README.md
@@ -63,7 +63,7 @@ This IDE supports Java and several other JVM languages and can be extended with
 IntelliJ IDEA has [detailed online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html), and its [community edition](https://www.jetbrains.com/idea/download/) can be downloaded and used for free.
 
 IntelliJ IDEA makes it easy to configure code styles, automatic copyright notices, code inspection profiles, run configurations and more.
-The basic IntelliJ IDEA configuration used in the above-mentioned projects is described in the [IntelliJ IDEA section](java-project-intellij#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](java-project-intellij).
+The basic IntelliJ IDEA configuration used in the above-mentioned projects is described in the [IntelliJ IDEA section](java-project-intellij/#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](java-project-intellij).
 
 ### 2.4 Maven
 
@@ -71,7 +71,7 @@ The basic IntelliJ IDEA configuration used in the above-mentioned projects is de
 The [project object model](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html), a file named `pom.xml`, is central to using Maven.
 In this file, the project properties can be set, build plugins can be configured, project dependencies can be defined, etc.
 
-The basic Maven configuration used in the above-mentioned projects is discussed in the [Maven section](java-project-maven-intellij#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](java-project-maven-intellij).
+The basic Maven configuration used in the above-mentioned projects is discussed in the [Maven section](java-project-maven-intellij/#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](java-project-maven-intellij).
 A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html#create_new_maven_project) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html).
 
 ## License
diff --git a/java/executable-jar-maven-intellij/README.md b/java/executable-jar-maven-intellij/README.md
index f9730f1..e4a4bff 100644
--- a/java/executable-jar-maven-intellij/README.md
+++ b/java/executable-jar-maven-intellij/README.md
@@ -31,7 +31,7 @@ public class Main {
 
 ### 1.2 IntelliJ IDEA
 
-The basic configuration of this project is described in the [IntelliJ IDEA section](../java-project-intellij#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](../java-project-intellij).
+The basic configuration of this project is described in the [IntelliJ IDEA section](../java-project-intellij/#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](../java-project-intellij).
 Additional details regarding the IntelliJ IDEA run configurations of the current project are given in what follows.
 
 #### 1.2.1 Configuration
@@ -44,7 +44,7 @@ The other two run configurations, respectively, create a JAR and execute it.
 
 ### 1.3 Maven
 
-The configuration used in this project extends the [Maven configuration](../java-project-maven-intellij#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](../java-project-maven-intellij).
+The configuration used in this project extends the [Maven configuration](../java-project-maven-intellij/#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](../java-project-maven-intellij).
 Additional details regarding the Maven configuration of the current project are given in what follows.
 
 #### 1.3.1 Configuration
@@ -93,7 +93,7 @@ mvn clean install
 ## 2. Issues and solutions
 
 While setting up and building a Maven project, several issues may occur.
-I partly documented these issues in the [Issues and solutions section](../java-project-maven-intellij#2-issues-and-solutions) of [Setting up a Java project using Maven and IntelliJ IDEA](../java-project-maven-intellij).
+I partly documented these issues in the [Issues and solutions section](../java-project-maven-intellij/#2-issues-and-solutions) of [Setting up a Java project using Maven and IntelliJ IDEA](../java-project-maven-intellij).
 
 Additional problems may occur when trying to execute a JAR created using Maven.
 Below, I describe the issues related to the [Maven JAR plugin](#21-maven-jar-plugin-issues), including possible solutions.
diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index d04d358..d6f0fe2 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -31,7 +31,7 @@ public class Main {
 
 ### 1.2 IntelliJ IDEA
 
-The basic configuration of this project is described in the [IntelliJ IDEA section](../java-project-intellij#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](../java-project-intellij).
+The basic configuration of this project is described in the [IntelliJ IDEA section](../java-project-intellij/#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](../java-project-intellij).
 Additional details regarding the IntelliJ IDEA run configurations of the current project are given in what follows.
 
 #### 1.2.1 Configuration
@@ -504,7 +504,7 @@ When trying to execute a JAR, an error similar to the following may occur:
 no main manifest attribute, in basic-1.0-SNAPSHOT.jar
 ```
 
-To solve this problem, configure the Maven JAR plugin according to the discussion of potential [Maven JAR plugin issues](../executable-jar-maven-intellij#21-maven-jar-plugin-issues) that is part of [Creating an executable JAR using Maven and IntelliJ IDEA](../executable-jar-maven-intellij).
+To solve this problem, configure the Maven JAR plugin according to the discussion of potential [Maven JAR plugin issues](../executable-jar-maven-intellij/#21-maven-jar-plugin-issues) that is part of [Creating an executable JAR using Maven and IntelliJ IDEA](../executable-jar-maven-intellij).
 
 ## License
 

From 47084d8d53d3bff8b1481522ae7ded94a9eddd93 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 10 Oct 2023 21:19:10 +0200
Subject: [PATCH 15/89] Fix a hyphenation error

---
 java/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/README.md b/java/README.md
index 6c19757..d082c42 100644
--- a/java/README.md
+++ b/java/README.md
@@ -52,7 +52,7 @@ These projects require the installation of the Java Development Kit (JDK) 20 or
 
 ### 2.2 Bash
 
-[Bash](https://www.gnu.org/software/bash/) is a commonly-used command-line interface for Unix-like operating systems.
+[Bash](https://www.gnu.org/software/bash/) is a commonly used command-line interface for Unix-like operating systems.
 Bash can execute both user-provided commands and so-called shell scripts.
 Windows users can obtain Bash by installing [Git for Windows](https://git-scm.com/download/win).
 

From 891ae45a32e54d17e738fc8322b5ce667e1c6eae Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 11 Oct 2023 17:22:13 +0200
Subject: [PATCH 16/89] Select the project JDK

---
 java/executable-jar-maven-intellij/.idea/misc.xml | 3 +--
 java/java-project-intellij/.idea/misc.xml         | 4 +---
 java/java-project-maven-intellij/.idea/misc.xml   | 3 +--
 3 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/java/executable-jar-maven-intellij/.idea/misc.xml b/java/executable-jar-maven-intellij/.idea/misc.xml
index 41147fb..b3cf2e0 100644
--- a/java/executable-jar-maven-intellij/.idea/misc.xml
+++ b/java/executable-jar-maven-intellij/.idea/misc.xml
@@ -8,6 +8,5 @@
       </list>
     </option>
   </component>
-  <!-- TODO: Set project-jdk-name to temurin-21 -->
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="21" project-jdk-type="JavaSDK" />
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="temurin-21" project-jdk-type="JavaSDK" />
 </project>
\ No newline at end of file
diff --git a/java/java-project-intellij/.idea/misc.xml b/java/java-project-intellij/.idea/misc.xml
index 2498d8d..b56d0a0 100644
--- a/java/java-project-intellij/.idea/misc.xml
+++ b/java/java-project-intellij/.idea/misc.xml
@@ -1,7 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project version="4">
-  <!-- TODO: Set project-jdk-name to temurin-21 -->
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="21" project-jdk-type="JavaSDK">
+<project version="4">  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="temurin-21" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/out" />
   </component>
 </project>
\ No newline at end of file
diff --git a/java/java-project-maven-intellij/.idea/misc.xml b/java/java-project-maven-intellij/.idea/misc.xml
index 41147fb..b3cf2e0 100644
--- a/java/java-project-maven-intellij/.idea/misc.xml
+++ b/java/java-project-maven-intellij/.idea/misc.xml
@@ -8,6 +8,5 @@
       </list>
     </option>
   </component>
-  <!-- TODO: Set project-jdk-name to temurin-21 -->
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="21" project-jdk-type="JavaSDK" />
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="temurin-21" project-jdk-type="JavaSDK" />
 </project>
\ No newline at end of file

From 7bcea5633437c26377ab2b1ea9dfabbcf9414828 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:28:36 +0200
Subject: [PATCH 17/89] Generalize section preview

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 4f14dd3..0c4ff9c 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,7 @@
 With this educational project, I provide solutions to common programming challenges.
 
 Below, I first describe the [aims](#1-aims) I have with the current project.
-I then [list](#2-overview) the programming languages for which I solved several challenges.
+I then give an [overview](#2-overview) of the challenges I have solved thus far.
 
 The release history of this project is contained in the [changelog](CHANGELOG.md).
 

From 2a4a13ad8ef3500be9ea1ff3d8b09fc27a1e37aa Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:38:57 +0200
Subject: [PATCH 18/89] Refer to background section

---
 java/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/README.md b/java/README.md
index d082c42..e102379 100644
--- a/java/README.md
+++ b/java/README.md
@@ -22,8 +22,8 @@ I solved the challenges in this section using the [command line](#22-bash) but w
 ### 1.2 IntelliJ IDEA projects
 
 I solved the following challenges using [IntelliJ IDEA](#23-intellij-idea).
-For some challenges, I did not use a build tool ([manual](#121-manual)).
-For others, I used [Maven](#122-maven).
+For some challenges, I did not use a build tool (manual).
+For others, I used [Maven](#24-maven).
 
 #### 1.2.1 Manual
 

From dd723a71c10f66576422c095b80ce97a8738af62 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:39:24 +0200
Subject: [PATCH 19/89] Describe the use of Java 21

---
 java/README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/java/README.md b/java/README.md
index e102379..855e9f4 100644
--- a/java/README.md
+++ b/java/README.md
@@ -46,9 +46,9 @@ C and C++ are, however, compiled into platform-specific machine code.
 Instead, Java compiles to platform-independent class files containing so-called bytecode.
 This bytecode can be executed on a platform of choice by a platform-specific Java virtual machine (JVM).
 
-Most of the above-mentioned projects are configured to use the latest version of Java (Java 20 at the time of writing).
-These projects require the installation of the Java Development Kit (JDK) 20 or later (see, e.g., https://adoptium.net/temurin/releases/).
-
+Most of the above-mentioned projects are configured to use Java 21, which is the latest long-term support (LTS) version of Java at the time of writing.
+These projects require the installation of the Java Development Kit (JDK) 21 or later.
+The installation of the latest JDK is described in the [Installation section](java-project-cli/#111-installation) of [Setting up a Java project using the command line](java-project-cli).
 
 ### 2.2 Bash
 

From d0d30238ebd5ee189a3431891543dd0c41e17375 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:39:33 +0200
Subject: [PATCH 20/89] Improve the Bash section

---
 java/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/README.md b/java/README.md
index 855e9f4..86d6cfe 100644
--- a/java/README.md
+++ b/java/README.md
@@ -52,8 +52,8 @@ The installation of the latest JDK is described in the [Installation section](ja
 
 ### 2.2 Bash
 
-[Bash](https://www.gnu.org/software/bash/) is a commonly used command-line interface for Unix-like operating systems.
-Bash can execute both user-provided commands and so-called shell scripts.
+[Bash](https://www.gnu.org/software/bash/) is a commonly used command-line interface for Unix-based operating systems.
+Bash can both execute commands interactively and run so-called shell scripts.
 Windows users can obtain Bash by installing [Git for Windows](https://git-scm.com/download/win).
 
 ### 2.3 IntelliJ IDEA

From bf0873b890857a6b836f77f5b32579484fc3d6da Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:39:59 +0200
Subject: [PATCH 21/89] Improve the IntelliJ IDEA section

---
 java/README.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/java/README.md b/java/README.md
index 86d6cfe..5c3d8fb 100644
--- a/java/README.md
+++ b/java/README.md
@@ -64,6 +64,8 @@ IntelliJ IDEA has [detailed online documentation](https://www.jetbrains.com/help
 
 IntelliJ IDEA makes it easy to configure code styles, automatic copyright notices, code inspection profiles, run configurations and more.
 The basic IntelliJ IDEA configuration used in the above-mentioned projects is described in the [IntelliJ IDEA section](java-project-intellij/#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](java-project-intellij).
+A step-by-step guide for setting up a Java project using IntelliJ IDEA can be found in the [Create a new project section](https://www.jetbrains.com/help/idea/new-project-wizard.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html).
+
 
 ### 2.4 Maven
 

From 1d6cf0fd2e19b92bbfb86145ed6b8e9d18300ff9 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:40:10 +0200
Subject: [PATCH 22/89] Drop a superfluous anchor

---
 java/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/README.md b/java/README.md
index 5c3d8fb..bd3ee0e 100644
--- a/java/README.md
+++ b/java/README.md
@@ -74,7 +74,7 @@ The [project object model](https://maven.apache.org/guides/introduction/introduc
 In this file, the project properties can be set, build plugins can be configured, project dependencies can be defined, etc.
 
 The basic Maven configuration used in the above-mentioned projects is discussed in the [Maven section](java-project-maven-intellij/#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](java-project-maven-intellij).
-A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html#create_new_maven_project) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html).
+A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html).
 
 ## License
 

From 47ed234978d5800ba53050192f5210fae44088ae Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:51:16 +0200
Subject: [PATCH 23/89] Describe availability of Bash

---
 java/README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/java/README.md b/java/README.md
index bd3ee0e..8c1cd3a 100644
--- a/java/README.md
+++ b/java/README.md
@@ -54,6 +54,7 @@ The installation of the latest JDK is described in the [Installation section](ja
 
 [Bash](https://www.gnu.org/software/bash/) is a commonly used command-line interface for Unix-based operating systems.
 Bash can both execute commands interactively and run so-called shell scripts.
+MacOS and most Linux distributions come with Bash or a Bash-like shell.
 Windows users can obtain Bash by installing [Git for Windows](https://git-scm.com/download/win).
 
 ### 2.3 IntelliJ IDEA

From 577b8e375489a5519e2b4ca7176cdb88ce0415da Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:57:23 +0200
Subject: [PATCH 24/89] Adapt Bash description

---
 java/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/README.md b/java/README.md
index 8c1cd3a..20ec131 100644
--- a/java/README.md
+++ b/java/README.md
@@ -53,7 +53,7 @@ The installation of the latest JDK is described in the [Installation section](ja
 ### 2.2 Bash
 
 [Bash](https://www.gnu.org/software/bash/) is a commonly used command-line interface for Unix-based operating systems.
-Bash can both execute commands interactively and run so-called shell scripts.
+Bash can both interactively execute commands and run so-called shell scripts.
 MacOS and most Linux distributions come with Bash or a Bash-like shell.
 Windows users can obtain Bash by installing [Git for Windows](https://git-scm.com/download/win).
 

From 2f3295ad330efbe8c5a0c4d34fffe95150bb993d Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 11:59:40 +0200
Subject: [PATCH 25/89] Add Maven installation notice

---
 java/README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/java/README.md b/java/README.md
index 20ec131..936a648 100644
--- a/java/README.md
+++ b/java/README.md
@@ -76,6 +76,7 @@ In this file, the project properties can be set, build plugins can be configured
 
 The basic Maven configuration used in the above-mentioned projects is discussed in the [Maven section](java-project-maven-intellij/#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](java-project-maven-intellij).
 A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html).
+Maven does not need to be installed separately when used with IntelliJ IDEA.
 
 ## License
 

From 7bc1663f759a4a42250f2a920940a14e9935c7d6 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 12:06:03 +0200
Subject: [PATCH 26/89] Drop reference to IntelliJ IDEA documentation subtopic

---
 java/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/README.md b/java/README.md
index 936a648..d027758 100644
--- a/java/README.md
+++ b/java/README.md
@@ -65,7 +65,7 @@ IntelliJ IDEA has [detailed online documentation](https://www.jetbrains.com/help
 
 IntelliJ IDEA makes it easy to configure code styles, automatic copyright notices, code inspection profiles, run configurations and more.
 The basic IntelliJ IDEA configuration used in the above-mentioned projects is described in the [IntelliJ IDEA section](java-project-intellij/#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](java-project-intellij).
-A step-by-step guide for setting up a Java project using IntelliJ IDEA can be found in the [Create a new project section](https://www.jetbrains.com/help/idea/new-project-wizard.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html).
+A step-by-step guide for setting up a Java project using IntelliJ IDEA can be found in the [Create a new project section](https://www.jetbrains.com/help/idea/new-project-wizard.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/).
 
 
 ### 2.4 Maven
@@ -75,7 +75,7 @@ The [project object model](https://maven.apache.org/guides/introduction/introduc
 In this file, the project properties can be set, build plugins can be configured, project dependencies can be defined, etc.
 
 The basic Maven configuration used in the above-mentioned projects is discussed in the [Maven section](java-project-maven-intellij/#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](java-project-maven-intellij).
-A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html).
+A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/).
 Maven does not need to be installed separately when used with IntelliJ IDEA.
 
 ## License

From 2f7a1b3ad12dbf58c706748e21c15eb74c63916c Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 12:13:34 +0200
Subject: [PATCH 27/89] Drop comma

---
 java/java-project-cli/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 7ba8b54..27df978 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -4,7 +4,7 @@
 
 ## Introduction
 
-With this part of the [Java challenges](..) project, I provide the code and settings for a Java project, set up using the command line.
+With this part of the [Java challenges](..) project, I provide the code and settings for a Java project set up using the command line.
 
 Below, I give detailed [background information](#1-background) on the project's [code](#11-java).
 In addition, I list several [issues](#2-issues-and-solutions) that can occur when setting up a Java project.

From 7301957f4429aec1ad2fa0ca1e4c3dbe27f73b9d Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 12:21:02 +0200
Subject: [PATCH 28/89] Introduce a section on Java's installation

---
 java/java-project-cli/README.md | 16 +++++++++-------
 1 file changed, 9 insertions(+), 7 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 27df978..742e377 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -20,9 +20,11 @@ I describe this command-line interface in the [Bash section](../#22-bash) of the
 This project makes use of Java.
 I describe this programming language in the [Java section](../#21-java) of the [Java challenges](..) project.
 
+#### 1.1.1 Installation
+
 <!-- TODO: Discuss the installation and configuration of Java. -->
 
-#### 1.1.1 Code
+#### 1.1.2 Code
 
 For demonstrative purposes, the current project contains only a single Java file, [Main.java](src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main.java), which comprises a Java class with the corresponding name `Main`.
 This class contains a `main` method outputting a well-known message:
@@ -37,7 +39,7 @@ public class Main {
 }
 ```
 
-#### 1.1.2 Directory structure
+#### 1.1.3 Directory structure
 
 The directory structure of this project is as follows:
 
@@ -70,9 +72,9 @@ java-project-cli
 ```
 
 Here, the `src` folder contains the source file, `Main.java`, stored in a directory structure that matches the package of the class `Main`, i.e., `nl.mauritssilvis.challenges.java.cli.manual.projects.basic`.
-The `out` folder, which is created upon [compilation](#113-compilation), has the same structure as the `src` folder but is there to contain the compiled bytecode instead of source code.
+The `out` folder, which is created upon [compilation](#114-compilation), has the same structure as the `src` folder but is there to contain the compiled bytecode instead of source code.
 
-#### 1.1.3 Compilation
+#### 1.1.4 Compilation
 
 The most basic way to compile the Java source code in `Main.java` consists in navigating to the directory of this file and calling the Java compiler:
 
@@ -91,9 +93,9 @@ Therefore, it is more convenient to compile the source file from the project roo
 javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main.java
 ```
 
-#### 1.1.4 Execution
+#### 1.1.5 Execution
 
-After [compilation](#113-compilation), the Java class file, `Main.class`, that is buried in the `out` folder can be executed in several ways.
+After [compilation](#114-compilation), the Java class file, `Main.class`, that is buried in the `out` folder can be executed in several ways.
 
 A convenient way to execute this class is given by:
 
@@ -142,7 +144,7 @@ More specifically, the folder from which a class is executed should contain a di
 Therefore, the Java class file `Main.class` cannot be executed from any other folder than the `out` folder.
 In particular, this class file cannot be executed from its containing parent folder.
 
-#### 1.1.5 Direct execution
+#### 1.1.6 Direct execution
 
 Since Java 11, programs consisting of only a single source file can be executed directly, without the need for an explicit compilation step.
 For the current project, the following command directly executes the source file `Main.java` from its containing folder:

From 711dd79c48608df09a8b002551b2caa3fb1f3ad5 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 12:38:30 +0200
Subject: [PATCH 29/89] Describe the installation of the JDK

---
 java/java-project-cli/README.md | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 742e377..c3d3c27 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -22,7 +22,19 @@ I describe this programming language in the [Java section](../#21-java) of the [
 
 #### 1.1.1 Installation
 
-<!-- TODO: Discuss the installation and configuration of Java. -->
+To work with Java code, you have to install the Java Development Kit (JDK).
+You can install the latest version of the JDK as follows:
+
+- Go to https://adoptium.net/temurin/releases/.
+- Select the latest long-term support (LTS) version of Java (Java 21 at the time of writing).
+- Download the archive or installer matching your system.
+- Extract or install the files in a convenient location.
+- Add the full path of the created `jdk-X+Y/bin` folder to your `PATH` environment variable. Here, `X` and `Y` are placeholders for version numbers.
+
+You can verify your Java installation using the following steps:
+
+- Run the command `java --version`.
+- Verify that the output matches the desired version of the JDK.
 
 #### 1.1.2 Code
 

From b33ae3a9eccc632eb03b45531b415c7d7d35afc6 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 12:47:15 +0200
Subject: [PATCH 30/89] Shorten text

---
 java/java-project-cli/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index c3d3c27..e4c19fe 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -34,7 +34,7 @@ You can install the latest version of the JDK as follows:
 You can verify your Java installation using the following steps:
 
 - Run the command `java --version`.
-- Verify that the output matches the desired version of the JDK.
+- Verify that the output matches the desired JDK version.
 
 #### 1.1.2 Code
 

From b2b459190acf75f974da84308b24526a3731a074 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 12:54:42 +0200
Subject: [PATCH 31/89] Polish documentation

---
 java/java-project-cli/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index e4c19fe..b78d302 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -107,7 +107,7 @@ javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
 
 #### 1.1.5 Execution
 
-After [compilation](#114-compilation), the Java class file, `Main.class`, that is buried in the `out` folder can be executed in several ways.
+After [compilation](#114-compilation), the Java class file, `Main.class`, which is buried in the `out` folder, can be executed in several ways.
 
 A convenient way to execute this class is given by:
 
@@ -125,7 +125,7 @@ cd out
 java nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 ```
 
-Rather than manually navigating to a folder containing class files, it is more common to execute a Java class relative to a so-called class path.
+Rather than manually navigating to a folder containing (a hierarchy of directories with) class files, it is more common to execute a Java class relative to a so-called class path.
 For the current project, the following command involving the `-cp` option executes the previously compiled class from the class path `out`:
 
 ```shell

From 9580ea7f9bc40c83d41c5b41f3dba44cab14f157 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 12:59:02 +0200
Subject: [PATCH 32/89] Introduce a section with installation issues

---
 java/java-project-cli/README.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index b78d302..b789095 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -182,13 +182,13 @@ Hello world!
 
 While setting up a Java project, several issues may occur.
 I list several such issues, here, including possible solutions.
-In particular, I discuss problems related to the [compilation](#21-compilation-issues) and [execution](#22-execution-issues) of Java programs.
+In particular, I discuss problems related to the [installation](#21-installation-issues) of Java and the [compilation](#22-compilation-issues) and [execution](#23-execution-issues) of Java programs.
 
-<!-- TODO: Discuss installation issues. -->
+### 2.1 Installation issues
 
-### 2.1 Compilation issues
+### 2.2 Compilation issues
 
-#### 2.1.1 file not found
+#### 2.2.1 file not found
 
 Since the Java interpreter accepts class names with slashes and dots, one may be tempted to use dots in paths to Java source files in calls to the Java compiler:
 
@@ -219,7 +219,7 @@ In that case, ensure you drop any file extensions, you use the fully qualified c
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 ```
 
-#### 2.1.2 Class names are only accepted if annotation processing is explicitly requested
+#### 2.2.2 Class names are only accepted if annotation processing is explicitly requested
 
 When working with Java, you may encounter errors of the following form:
 
@@ -262,7 +262,7 @@ In that case, ensure you use the fully qualified class name and you execute the
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 ```
 
-#### 2.1.3 invalid flag
+#### 2.2.3 invalid flag
 
 When working with Java, you may encounter an error of the following form:
 
@@ -294,9 +294,9 @@ In that case, ensure you drop any file extensions, you use the fully qualified c
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 ```
 
-### 2.2 Execution issues
+### 2.3 Execution issues
 
-#### 2.2.1 Could not find or load main class / java.lang.ClassNotFoundException
+#### 2.3.1 Could not find or load main class / java.lang.ClassNotFoundException
 
 When trying to execute Java programs, you may encounter errors of the following form:
 
@@ -327,7 +327,7 @@ As noted before, a more common way of writing this command is given by:
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 ```
 
-#### 2.2.2 Could not find or load main class / java.lang.NoClassDefFoundError
+#### 2.3.2 Could not find or load main class / java.lang.NoClassDefFoundError
 
 When trying to execute Java programs, you may encounter errors of the following form:
 

From 72afaf55ea9e29cce0bf94c75c10bf0061bb9c0b Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 13:04:04 +0200
Subject: [PATCH 33/89] Simplify directives

---
 java/java-project-cli/README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index b789095..edb8f6d 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -213,7 +213,7 @@ javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
 
 Alternatively, ensure that you call the right tool.
 You may have wanted to call the Java interpreter instead of the Java compiler.
-In that case, ensure you drop any file extensions, you use the fully qualified class name and you execute the class from the proper location:
+In that case, ensure you drop any file extensions, use the fully qualified class name and execute the class from the proper location:
 
 ```shell
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
@@ -256,7 +256,7 @@ javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
 
 Alternatively, ensure that you call the right tool.
 You may have wanted to call the Java interpreter instead of the Java compiler
-In that case, ensure you use the fully qualified class name and you execute the class from the proper location:
+In that case, ensure you use the fully qualified class name and execute the class from the proper location:
 
 ```shell
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
@@ -288,7 +288,7 @@ javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
 
 Alternatively, ensure that you call the right tool.
 You may have wanted to call the Java interpreter instead of the Java compiler.
-In that case, ensure you drop any file extensions, you use the fully qualified class name and you execute the class from the proper location:
+In that case, ensure you drop any file extensions, use the fully qualified class name and execute the class from the proper location:
 
 ```shell
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main

From 457425c39506365af81614e3bf8023dc6b296ef5 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 13:15:41 +0200
Subject: [PATCH 34/89] Add to-dos

---
 java/java-project-cli/README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index edb8f6d..6d03833 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -186,6 +186,8 @@ In particular, I discuss problems related to the [installation](#21-installation
 
 ### 2.1 Installation issues
 
+<!-- TODO: Describe problems with a missing java command, a mismatch in output version and a mismatch in class version (Java is not up-to-date / java.lang.UnsupportedClassVersionError). -->
+
 ### 2.2 Compilation issues
 
 #### 2.2.1 file not found
@@ -366,6 +368,8 @@ As noted before, a more common way of writing this command is given by:
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 ```
 
+<!-- TODO: Describe problems with a mismatch in class version: Java is not up-to-date / java.lang.UnsupportedClassVersionError -->
+
 ## License
 
 Copyright © 2021–2023 Maurits Silvis

From cb52a088efe36590264af79db45b92e56aeca448 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 13:54:08 +0200
Subject: [PATCH 35/89] Name the Java commands

---
 java/java-project-cli/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 6d03833..2f51933 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -88,7 +88,7 @@ The `out` folder, which is created upon [compilation](#114-compilation), has the
 
 #### 1.1.4 Compilation
 
-The most basic way to compile the Java source code in `Main.java` consists in navigating to the directory of this file and calling the Java compiler:
+The most basic way to compile the Java source code in `Main.java` consists in navigating to the directory of this file and calling the Java compiler, `javac`:
 
 ```shell
 cd src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic
@@ -109,7 +109,7 @@ javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
 
 After [compilation](#114-compilation), the Java class file, `Main.class`, which is buried in the `out` folder, can be executed in several ways.
 
-A convenient way to execute this class is given by:
+A convenient way to execute this class is given by the following commands involving the Java interpreter, `java`:
 
 ```shell
 cd out

From 641c547712b68786edc1d80ebf706725e949b0bf Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 14:29:45 +0200
Subject: [PATCH 36/89] Describe issues with the JDK installation

---
 java/java-project-cli/README.md | 52 +++++++++++++++++++++++++++++++--
 1 file changed, 50 insertions(+), 2 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 2f51933..82a7f42 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -186,7 +186,42 @@ In particular, I discuss problems related to the [installation](#21-installation
 
 ### 2.1 Installation issues
 
-<!-- TODO: Describe problems with a missing java command, a mismatch in output version and a mismatch in class version (Java is not up-to-date / java.lang.UnsupportedClassVersionError). -->
+#### 2.1.1 The `java` command was not found / The `javac` command was not found
+
+While trying to invoke the Java interpreter, `java`, or the Java compiler, `javac`, you may encounter errors of the following form:
+
+```text
+java: command not found
+```
+
+```text
+'java' is not recognized as an internal or external command, operable program
+or batch file.
+```
+
+```text
+java : The term 'java' is not recognized as the name of a cmdlet, function,
+script file, or operable program.
+```
+
+These errors indicate Java was not installed or the Java installation was not found.
+
+To solve these problems, install the JDK according to the [installation instructions](#111-installation) given above.
+In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
+
+#### 2.1.2 The Java version does not match
+
+When checking the Java version using `java --version`, you may encounter unexpected output.
+For example, the output may show a lower version than expected:
+
+```text
+openjdk 20.0.2 2023-07-18
+OpenJDK Runtime Environment Temurin-20.0.2+9 (build 20.0.2+9)
+OpenJDK 64-Bit Server VM Temurin-20.0.2+9 (build 20.0.2+9, mixed mode, sharing)
+```
+
+To solve this problem, install the JDK according to the [installation instructions](#111-installation) given above.
+In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 ### 2.2 Compilation issues
 
@@ -368,7 +403,20 @@ As noted before, a more common way of writing this command is given by:
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 ```
 
-<!-- TODO: Describe problems with a mismatch in class version: Java is not up-to-date / java.lang.UnsupportedClassVersionError -->
+#### 2.3.3 Java is not up-to-date / java.lang.UnsupportedClassVersionError
+
+When trying to execute Java programs, you may encounter errors of the following form:
+
+```text
+Error: LinkageError occurred while loading main class nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
+        java.lang.UnsupportedClassVersionError: nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
+        has been compiled by a more recent version of the Java Runtime (class
+        file version ...), this version of the Java Runtime only recognizes
+        class file versions up to ...
+```
+
+To solve this problem, install the JDK according to the [installation instructions](#111-installation) given above.
+In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 ## License
 

From 9c5ec7888e3858aacddf7fef7202305ef6c751fa Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 14:49:36 +0200
Subject: [PATCH 37/89] Generalize statement

---
 java/java-project-cli/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 82a7f42..8ce7f4c 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -23,7 +23,7 @@ I describe this programming language in the [Java section](../#21-java) of the [
 #### 1.1.1 Installation
 
 To work with Java code, you have to install the Java Development Kit (JDK).
-You can install the latest version of the JDK as follows:
+You can install the JDK as follows:
 
 - Go to https://adoptium.net/temurin/releases/.
 - Select the latest long-term support (LTS) version of Java (Java 21 at the time of writing).

From de7dfabb7efdebafe66b75990c9f536b7611bc5f Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Mon, 16 Oct 2023 14:49:44 +0200
Subject: [PATCH 38/89] Add to-dos

---
 java/java-project-intellij/README.md       | 6 ++++--
 java/java-project-maven-intellij/README.md | 2 ++
 2 files changed, 6 insertions(+), 2 deletions(-)

diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 22c2c90..92f9134 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -40,8 +40,6 @@ The IntelliJ IDEA configuration is described in what follows.
 The [.idea](.idea) folder of this project contains several IntelliJ-IDEA-related configuration files.
 A few of these files are highlighted below.
 
-<!-- TODO: Discuss the project JDK choice. -->
-
 ##### Code styles
 
 First, Unix-style line endings are selected in the file [Project.xml](.idea/codeStyles/Project.xml), which facilitates cross-platform coding.
@@ -81,6 +79,10 @@ This project comes with a run configuration for executing the `main` method of t
 
 <!-- TODO: Discuss the execution of the code. -->
 
+<!-- TODO: Discuss the project JDK choice. -->
+
+<!-- TODO: Discuss problems with a non-existing JDK. -->
+
 ## License
 
 Copyright © 2021–2023 Maurits Silvis
diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index d6f0fe2..7eaa59b 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -117,6 +117,8 @@ While setting up and building a Maven project, several issues may occur.
 I list several such issues below, including possible solutions.
 Specifically, I discuss problems related to the [project object model](#21-project-object-model-issues), the [Maven resources plugin](#22-maven-resources-plugin-issues), the [Maven compiler plugin](#23-maven-compiler-plugin-issues) and the [Maven JAR plugin](#24-maven-jar-plugin-issues).
 
+<!-- TODO: Describe what happens when the required Java version is not installed. -->
+
 ### 2.1 Project object model issues
 
 Several issues may arise concerning the [project object model](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).

From 277e9116c53a27cbbce3fefdedc6cc37f2d21b8f Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 11:18:09 +0200
Subject: [PATCH 39/89] Improve solution instructions

---
 java/java-project-cli/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 8ce7f4c..2567812 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -220,7 +220,7 @@ OpenJDK Runtime Environment Temurin-20.0.2+9 (build 20.0.2+9)
 OpenJDK 64-Bit Server VM Temurin-20.0.2+9 (build 20.0.2+9, mixed mode, sharing)
 ```
 
-To solve this problem, install the JDK according to the [installation instructions](#111-installation) given above.
+To solve this problem, install the desired JDK according to the [installation instructions](#111-installation) given above.
 In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 ### 2.2 Compilation issues
@@ -415,7 +415,7 @@ Error: LinkageError occurred while loading main class nl.mauritssilvis.challenge
         class file versions up to ...
 ```
 
-To solve this problem, install the JDK according to the [installation instructions](#111-installation) given above.
+To solve this problem, install the latest JDK according to the [installation instructions](#111-installation) given above.
 In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 ## License

From 8bfb7083ef9486f5888aca6dea495134b2b0579c Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 11:22:09 +0200
Subject: [PATCH 40/89] Improve grammar

---
 java/java-project-cli/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 2567812..30f8428 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -84,7 +84,7 @@ java-project-cli
 ```
 
 Here, the `src` folder contains the source file, `Main.java`, stored in a directory structure that matches the package of the class `Main`, i.e., `nl.mauritssilvis.challenges.java.cli.manual.projects.basic`.
-The `out` folder, which is created upon [compilation](#114-compilation), has the same structure as the `src` folder but is there to contain the compiled bytecode instead of source code.
+The `out` folder, which is created upon [compilation](#114-compilation), has the same structure as the `src` folder but is there to contain compiled bytecode instead of source code.
 
 #### 1.1.4 Compilation
 
@@ -211,7 +211,7 @@ In the process, ensure the `PATH` environment variable contains a reference to t
 
 #### 2.1.2 The Java version does not match
 
-When checking the Java version using `java --version`, you may encounter unexpected output.
+When checking the Java version using the command `java --version`, you may encounter unexpected output.
 For example, the output may show a lower version than expected:
 
 ```text

From 22ce41ae4209b5741b5f08b8a32695697d2d7aa6 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 11:28:07 +0200
Subject: [PATCH 41/89] Store IntelliJ IDEA project file

---
 java/java-project-intellij/.idea/misc.xml | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/java/java-project-intellij/.idea/misc.xml b/java/java-project-intellij/.idea/misc.xml
index b56d0a0..8780e86 100644
--- a/java/java-project-intellij/.idea/misc.xml
+++ b/java/java-project-intellij/.idea/misc.xml
@@ -1,5 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<project version="4">  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="temurin-21" project-jdk-type="JavaSDK">
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="temurin-21" project-jdk-type="JavaSDK">
     <output url="file://$PROJECT_DIR$/out" />
   </component>
 </project>
\ No newline at end of file

From fb3199bff8e4bd651f7c84cefdc0e32b83681a3d Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 11:44:26 +0200
Subject: [PATCH 42/89] Clarify the JDK choice

---
 java/java-project-cli/README.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 30f8428..9667627 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -23,7 +23,7 @@ I describe this programming language in the [Java section](../#21-java) of the [
 #### 1.1.1 Installation
 
 To work with Java code, you have to install the Java Development Kit (JDK).
-You can install the JDK as follows:
+You can install the Adoptium distribution of the JDK as follows:
 
 - Go to https://adoptium.net/temurin/releases/.
 - Select the latest long-term support (LTS) version of Java (Java 21 at the time of writing).
@@ -206,7 +206,7 @@ script file, or operable program.
 
 These errors indicate Java was not installed or the Java installation was not found.
 
-To solve these problems, install the JDK according to the [installation instructions](#111-installation) given above.
+To solve these problems, install the JDK, for example, according to the [installation instructions](#111-installation) given above.
 In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 #### 2.1.2 The Java version does not match
@@ -220,7 +220,7 @@ OpenJDK Runtime Environment Temurin-20.0.2+9 (build 20.0.2+9)
 OpenJDK 64-Bit Server VM Temurin-20.0.2+9 (build 20.0.2+9, mixed mode, sharing)
 ```
 
-To solve this problem, install the desired JDK according to the [installation instructions](#111-installation) given above.
+To solve this problem, install the desired JDK, for example, according to the [installation instructions](#111-installation) given above.
 In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 ### 2.2 Compilation issues
@@ -415,7 +415,7 @@ Error: LinkageError occurred while loading main class nl.mauritssilvis.challenge
         class file versions up to ...
 ```
 
-To solve this problem, install the latest JDK according to the [installation instructions](#111-installation) given above.
+To solve this problem, install the latest JDK, for example, according to the [installation instructions](#111-installation) given above.
 In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 ## License

From 108c8561c2f7a81c06001971db73d7b3352cdb79 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 11:53:20 +0200
Subject: [PATCH 43/89] Bump the Java version

---
 java/java-project-intellij/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 92f9134..0b27487 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -69,7 +69,7 @@ Automatic copyright messages, including the current year and an [SPDX license id
 
 ##### Inspection profiles
 
-A code inspection profile in which all Java-20-compatible IntelliJ IDEA inspections are turned on is provided in [All.xml](.idea/inspectionProfiles/All.xml).
+A code inspection profile in which all Java-21-compatible IntelliJ IDEA inspections are turned on is provided in [All.xml](.idea/inspectionProfiles/All.xml).
 This profile facilitates learning about possible code improvements and optimizations.
 A profile in which only the default inspections are selected is stored in [Default.xml](.idea/inspectionProfiles/Default.xml).
 

From c19666dfe37cb92bd903bbed98016c064c002700 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 12:17:37 +0200
Subject: [PATCH 44/89] Describe the JDK configuration

---
 java/java-project-intellij/README.md | 21 ++++++++++++++++++---
 1 file changed, 18 insertions(+), 3 deletions(-)

diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 0b27487..0e9a9ba 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -77,11 +77,26 @@ A profile in which only the default inspections are selected is stored in [Defau
 
 This project comes with a run configuration for executing the `main` method of the `Main` class.
 
-<!-- TODO: Discuss the execution of the code. -->
+##### Java Development Kit
 
-<!-- TODO: Discuss the project JDK choice. -->
+This project is configured to run with the Adoptium distribution of the Java Development Kit (JDK) 21.
+This setting can be reviewed in IntelliJ IDEA's project settings or the file [misc.xml](.idea/misc.xml):
 
-<!-- TODO: Discuss problems with a non-existing JDK. -->
+```xml
+<project version="4">
+  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="temurin-21" project-jdk-type="JavaSDK">
+    <output url="file://$PROJECT_DIR$/out" />
+  </component>
+</project>
+```
+
+## 2. Issues and solutions
+
+### 2.1 Configuration issues
+
+#### 2.1.1 Project JDK is not defined / JDK "temurin-21" is missing
+
+<!-- TODO: Discuss problem with a non-existing JDK. -->
 
 ## License
 

From 7b2cd8cff663fde783eac80528e5444216e0aa47 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 12:17:52 +0200
Subject: [PATCH 45/89] Remove the XML preview

---
 java/java-project-intellij/README.md | 10 +---------
 1 file changed, 1 insertion(+), 9 deletions(-)

diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 0e9a9ba..5f5f7f0 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -80,15 +80,7 @@ This project comes with a run configuration for executing the `main` method of t
 ##### Java Development Kit
 
 This project is configured to run with the Adoptium distribution of the Java Development Kit (JDK) 21.
-This setting can be reviewed in IntelliJ IDEA's project settings or the file [misc.xml](.idea/misc.xml):
-
-```xml
-<project version="4">
-  <component name="ProjectRootManager" version="2" languageLevel="JDK_21" default="true" project-jdk-name="temurin-21" project-jdk-type="JavaSDK">
-    <output url="file://$PROJECT_DIR$/out" />
-  </component>
-</project>
-```
+This setting can be reviewed in IntelliJ IDEA's project settings or the file [misc.xml](.idea/misc.xml).
 
 ## 2. Issues and solutions
 

From 49f1b2170f2653f777945524c45879c63ea1fed4 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 12:37:49 +0200
Subject: [PATCH 46/89] Describe IntelliJ IDEA configuration issues

---
 java/java-project-intellij/README.md | 17 ++++++++++++++++-
 1 file changed, 16 insertions(+), 1 deletion(-)

diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 5f5f7f0..df870d8 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -7,6 +7,7 @@
 With this part of the [Java challenges](..) project, I provide the code and settings for a Java project set up using IntelliJ IDEA.
 
 Below, I give [background information](#1-background) on the project's [code](#11-java) and [IntelliJ IDEA's configuration](#12-intellij-idea).
+I also discuss [issues](#2-issues-and-solutions) that can occur when setting up a Java project using IntelliJ IDEA.
 
 ## 1. Background
 
@@ -84,11 +85,25 @@ This setting can be reviewed in IntelliJ IDEA's project settings or the file [mi
 
 ## 2. Issues and solutions
 
+While setting up and executing a Java project using IntelliJ IDEA, you may encounter several issues.
+Below, I discuss problems related to the [configuration](#21-configuration-issues) of IntelliJ IDEA.
+
 ### 2.1 Configuration issues
 
 #### 2.1.1 Project JDK is not defined / JDK "temurin-21" is missing
 
-<!-- TODO: Discuss problem with a non-existing JDK. -->
+When you open this project, IntelliJ IDEA may show one or more of the following warnings:
+
+```text
+Project JDK is not defined
+```
+
+```text
+JDK "temurin-21" is missing
+```
+
+To solve these warnings and be able to execute the project's code, configure the project JDK in IntelliJ IDEA's project settings.
+You can either select one of the listed JDKs or go for the Adoptium distribution of the Java Development Kit (JDK) by following the [Installation section](../java-project-cli/#111-installation) of [Setting up a Java project using the command line](../java-project-cli) and selecting that JDK.
 
 ## License
 

From 34f05989a698ffda6cfbe2558534ef4cd4d927be Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 12:42:17 +0200
Subject: [PATCH 47/89] Document changes

---
 CHANGELOG.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0d48119..780bbc9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,6 +5,11 @@ All notable changes to the [Challenges](https://github.com/mauritssilvis/challen
 The file format is based on [keep a changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+
+- Improve the project documentation.
+- Update the Java version from 20 to 21.
+
 ## [0.3.1] - 2023-09-16
 
 ### Changed

From 517f7f48c9a01eb75823ae22ae0c197811b96dd2 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 13:57:07 +0200
Subject: [PATCH 48/89] Extend the description of installing Java

---
 java/java-project-cli/README.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 9667627..fb6c9fc 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -23,15 +23,19 @@ I describe this programming language in the [Java section](../#21-java) of the [
 #### 1.1.1 Installation
 
 To work with Java code, you have to install the Java Development Kit (JDK).
-You can install the Adoptium distribution of the JDK as follows:
+
+You can install the [Adoptium](https://adoptium.net/) distribution of the JDK as follows:
 
 - Go to https://adoptium.net/temurin/releases/.
 - Select the latest long-term support (LTS) version of Java (Java 21 at the time of writing).
 - Download the archive or installer matching your system.
 - Extract or install the files in a convenient location.
+
+If you want to work with Java from the command line, as is done in this project, you have to add the Java executables to your path:
+
 - Add the full path of the created `jdk-X+Y/bin` folder to your `PATH` environment variable. Here, `X` and `Y` are placeholders for version numbers.
 
-You can verify your Java installation using the following steps:
+You can then verify your Java installation using the following steps:
 
 - Run the command `java --version`.
 - Verify that the output matches the desired JDK version.

From 57c8baf6e17c37adf629d83153a55a20ea64a2b0 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 14:03:49 +0200
Subject: [PATCH 49/89] Polish documentation

---
 java/java-project-cli/README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index fb6c9fc..badf49d 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -185,7 +185,7 @@ Hello world!
 ## 2. Issues and solutions
 
 While setting up a Java project, several issues may occur.
-I list several such issues, here, including possible solutions.
+I list several such issues here, including possible solutions.
 In particular, I discuss problems related to the [installation](#21-installation-issues) of Java and the [compilation](#22-compilation-issues) and [execution](#23-execution-issues) of Java programs.
 
 ### 2.1 Installation issues
@@ -216,7 +216,7 @@ In the process, ensure the `PATH` environment variable contains a reference to t
 #### 2.1.2 The Java version does not match
 
 When checking the Java version using the command `java --version`, you may encounter unexpected output.
-For example, the output may show a lower version than expected:
+For example, the output may show a lower version of Java than expected:
 
 ```text
 openjdk 20.0.2 2023-07-18
@@ -409,7 +409,7 @@ java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 
 #### 2.3.3 Java is not up-to-date / java.lang.UnsupportedClassVersionError
 
-When trying to execute Java programs, you may encounter errors of the following form:
+When trying to execute Java programs, you may encounter an error of the following form:
 
 ```text
 Error: LinkageError occurred while loading main class nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main

From 41396e63c751fe2affd62a1b457c6daaea1d3d46 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 17 Oct 2023 14:09:13 +0200
Subject: [PATCH 50/89] Polish documentation

---
 java/java-project-intellij/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index df870d8..2b2e9bf 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -80,7 +80,7 @@ This project comes with a run configuration for executing the `main` method of t
 
 ##### Java Development Kit
 
-This project is configured to run with the Adoptium distribution of the Java Development Kit (JDK) 21.
+This project is configured to run with the [Adoptium](https://adoptium.net/) distribution of the Java Development Kit (JDK) 21.
 This setting can be reviewed in IntelliJ IDEA's project settings or the file [misc.xml](.idea/misc.xml).
 
 ## 2. Issues and solutions
@@ -103,7 +103,7 @@ JDK "temurin-21" is missing
 ```
 
 To solve these warnings and be able to execute the project's code, configure the project JDK in IntelliJ IDEA's project settings.
-You can either select one of the listed JDKs or go for the Adoptium distribution of the Java Development Kit (JDK) by following the [Installation section](../java-project-cli/#111-installation) of [Setting up a Java project using the command line](../java-project-cli) and selecting that JDK.
+You can either select one of the listed JDKs or opt for the Adoptium distribution of the Java Development Kit (JDK) by following the [Installation section](../java-project-cli/#111-installation) of [Setting up a Java project using the command line](../java-project-cli) and selecting that JDK.
 
 ## License
 

From 30b7722d09ee50af442869ac1e7a96eed4cb37b1 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 18 Oct 2023 11:31:19 +0200
Subject: [PATCH 51/89] Drop reference to IntelliJ IDEA documentation subtopic

---
 java/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/README.md b/java/README.md
index d027758..3f7484f 100644
--- a/java/README.md
+++ b/java/README.md
@@ -61,7 +61,7 @@ Windows users can obtain Bash by installing [Git for Windows](https://git-scm.co
 
 [IntelliJ IDEA](https://www.jetbrains.com/idea/) is an integrated development environment (IDE) developed by [JetBrains](https://www.jetbrains.com/).
 This IDE supports Java and several other JVM languages and can be extended with plugins to retrieve support for other programming languages.
-IntelliJ IDEA has [detailed online documentation](https://www.jetbrains.com/help/idea/discover-intellij-idea.html), and its [community edition](https://www.jetbrains.com/idea/download/) can be downloaded and used for free.
+IntelliJ IDEA has [detailed online documentation](https://www.jetbrains.com/help/idea/), and its [community edition](https://www.jetbrains.com/idea/download/) can be downloaded and used for free.
 
 IntelliJ IDEA makes it easy to configure code styles, automatic copyright notices, code inspection profiles, run configurations and more.
 The basic IntelliJ IDEA configuration used in the above-mentioned projects is described in the [IntelliJ IDEA section](java-project-intellij/#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](java-project-intellij).

From 63cbb0394e34b6c0d261d646e0422304ea7905d3 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 18 Oct 2023 11:31:43 +0200
Subject: [PATCH 52/89] Clarify choice of pwd

---
 java/java-project-cli/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index badf49d..db0ebf6 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -10,7 +10,7 @@ Below, I give detailed [background information](#1-background) on the project's
 In addition, I list several [issues](#2-issues-and-solutions) that can occur when setting up a Java project.
 I also describe solutions to these issues.
 
-Listed commands can, for example, be executed using Bash.
+The listed commands assume the working directory corresponds to this project's main folder and can, for example, be executed using Bash.
 I describe this command-line interface in the [Bash section](../#22-bash) of the [Java challenges](..) project.
 
 ## 1. Background

From 85b94378cfb5a2d3da3516083e7feb2a315fa675 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 18 Oct 2023 11:42:56 +0200
Subject: [PATCH 53/89] Use standard Java code indentation

---
 java/executable-jar-maven-intellij/README.md | 14 +++++++-------
 java/java-project-cli/README.md              |  6 +++---
 java/java-project-intellij/README.md         |  6 +++---
 java/java-project-maven-intellij/README.md   |  6 +++---
 4 files changed, 16 insertions(+), 16 deletions(-)

diff --git a/java/executable-jar-maven-intellij/README.md b/java/executable-jar-maven-intellij/README.md
index e4a4bff..043e8f2 100644
--- a/java/executable-jar-maven-intellij/README.md
+++ b/java/executable-jar-maven-intellij/README.md
@@ -23,9 +23,9 @@ For demonstrative purposes, the current project contains only a single Java clas
 package nl.mauritssilvis.challenges.java.intellij.maven.jars.executable.standalone;
 
 public class Main {
-  public static void main(String[] args) {
-    System.out.println("Hello world!");
-  }
+    public static void main(String[] args) {
+        System.out.println("Hello world!");
+    }
 }
 ```
 
@@ -205,7 +205,7 @@ To solve this problem, ensure that your project's main class contains a method w
 
 ```java
 public static void main(String[] args) {
-  // ...
+    // ...
 }
 ```
 
@@ -246,9 +246,9 @@ This main class contains a main method with a recognized signature:
 package nl.mauritssilvis.challenges.java.intellij.maven.jars.executable.standalone;
 
 public class Main {
-  public static void main(String[] args) {
-    System.out.println("Hello world!");
-  }
+    public static void main(String[] args) {
+        System.out.println("Hello world!");
+    }
 }
 ```
 
diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index db0ebf6..f74e4d2 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -49,9 +49,9 @@ This class contains a `main` method outputting a well-known message:
 package nl.mauritssilvis.challenges.java.cli.manual.projects.basic;
 
 public class Main {
-  public static void main(String[] args) {
-    System.out.println("Hello world!");
-  }
+    public static void main(String[] args) {
+        System.out.println("Hello world!");
+    }
 }
 ```
 
diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 2b2e9bf..7d45111 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -24,9 +24,9 @@ For demonstrative purposes, the current project contains only a single Java clas
 package nl.mauritssilvis.challenges.java.intellij.manual.projects.basic;
 
 public class Main {
-  public static void main(String[] args) {
-    System.out.println("Hello world!");
-  }
+    public static void main(String[] args) {
+        System.out.println("Hello world!");
+    }
 }
 ```
 
diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 7eaa59b..bbe79af 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -23,9 +23,9 @@ For demonstrative purposes, the current project contains only a single Java clas
 package nl.mauritssilvis.challenges.java.intellij.maven.projects.basic;
 
 public class Main {
-  public static void main(String[] args) {
-    System.out.println("Hello world!");
-  }
+    public static void main(String[] args) {
+        System.out.println("Hello world!");
+    }
 }
 ```
 

From cd704bb52d990422f02a4322fa4338d653e5420a Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 18 Oct 2023 11:57:16 +0200
Subject: [PATCH 54/89] Manually wrap text output

---
 java/java-project-cli/README.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index f74e4d2..78e34b0 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -270,7 +270,8 @@ error: Class names, 'Main', are only accepted if annotation processing is explic
 ```
 
 ```text
-error: Class names, 'nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main', are only accepted if annotation processing is explicitly requested
+error: Class names, 'nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main',
+are only accepted if annotation processing is explicitly requested
 1 error
 ```
 

From 80779137f8784feecc8401bb4c28a6b4ab4b95dc Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 18 Oct 2023 11:57:22 +0200
Subject: [PATCH 55/89] Add missing period

---
 java/java-project-cli/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 78e34b0..08e54e5 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -297,7 +297,7 @@ javac -d out src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
 ```
 
 Alternatively, ensure that you call the right tool.
-You may have wanted to call the Java interpreter instead of the Java compiler
+You may have wanted to call the Java interpreter instead of the Java compiler.
 In that case, ensure you use the fully qualified class name and execute the class from the proper location:
 
 ```shell

From 9da1bcf504ba4f0c2b0847e8d7a22f17a2012271 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 18 Oct 2023 12:00:18 +0200
Subject: [PATCH 56/89] Manually wrap text output

---
 java/java-project-cli/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 08e54e5..9345ee4 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -271,7 +271,7 @@ error: Class names, 'Main', are only accepted if annotation processing is explic
 
 ```text
 error: Class names, 'nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main',
-are only accepted if annotation processing is explicitly requested
+    are only accepted if annotation processing is explicitly requested
 1 error
 ```
 

From 2e78e482c6085d19b7c40b1e6eace3eaa535615f Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 18 Oct 2023 12:10:11 +0200
Subject: [PATCH 57/89] Manually wrap text output

---
 java/java-project-cli/README.md | 6 ++++--
 1 file changed, 4 insertions(+), 2 deletions(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 9345ee4..b92fc5f 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -375,12 +375,14 @@ When trying to execute Java programs, you may encounter errors of the following
 
 ```text
 Error: Could not find or load main class Main
-Caused by: java.lang.NoClassDefFoundError: nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main (wrong name: Main)
+Caused by: java.lang.NoClassDefFoundError: nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
+    (wrong name: Main)
 ```
 
 ```text
 Error: Could not find or load main class out.nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
-Caused by: java.lang.NoClassDefFoundError: nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main (wrong name: out/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main)
+Caused by: java.lang.NoClassDefFoundError: nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
+    (wrong name: out/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main)
 ```
 
 Such errors result from calling the Java interpreter using commands of the form:

From ccb865ca5070b1e1e54bb0bb6a0880fd43189483 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Wed, 18 Oct 2023 13:02:16 +0200
Subject: [PATCH 58/89] Add to-dos

---
 java/executable-jar-maven-intellij/pom.xml | 1 +
 java/java-project-maven-intellij/pom.xml   | 1 +
 2 files changed, 2 insertions(+)

diff --git a/java/executable-jar-maven-intellij/pom.xml b/java/executable-jar-maven-intellij/pom.xml
index d89110b..04db888 100644
--- a/java/executable-jar-maven-intellij/pom.xml
+++ b/java/executable-jar-maven-intellij/pom.xml
@@ -11,6 +11,7 @@
     <modelVersion>4.0.0</modelVersion>
 
     <groupId>nl.mauritssilvis.challenges.java.intellij.maven.jars.executable</groupId>
+    <!-- TODO: Use the folder name as the artifact ID. -->
     <artifactId>standalone</artifactId>
     <version>1.0-SNAPSHOT</version>
 
diff --git a/java/java-project-maven-intellij/pom.xml b/java/java-project-maven-intellij/pom.xml
index e514dad..4ff7284 100644
--- a/java/java-project-maven-intellij/pom.xml
+++ b/java/java-project-maven-intellij/pom.xml
@@ -15,6 +15,7 @@
 
     <!-- Set the project coordinates -->
     <groupId>nl.mauritssilvis.challenges.java.intellij.maven.projects</groupId>
+    <!-- TODO: Use the folder name as the artifact ID. -->
     <artifactId>basic</artifactId>
     <version>1.0-SNAPSHOT</version>
 

From 5c8ab795117b6fd33e765bb1e40c1c6af658b616 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 19 Oct 2023 11:15:57 +0200
Subject: [PATCH 59/89] Improve Maven plugin version notices

---
 java/java-project-maven-intellij/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index bbe79af..2038ab6 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -97,7 +97,7 @@ Finally, the [Maven compiler plugin](https://maven.apache.org/plugins/maven-comp
 </project>
 ```
 
-Here, the latest version of the [Maven compiler plugin](https://maven.apache.org/plugins/maven-compiler-plugin/) (3.11.0 at the time of writing) is selected.
+Here, version 3.11.0 of the [Maven compiler plugin](https://maven.apache.org/plugins/maven-compiler-plugin/) is selected, which is the latest version at the time of writing.
 Additionally, the latest version of Java (Java 20 at the time of writing) is selected, which requires the corresponding version of the Java Development Kit (JDK) (see, e.g., https://adoptium.net/temurin/releases/).
 
 #### 1.3.2 Build
@@ -256,7 +256,7 @@ For example, for the Maven compiler plugin, extend the `build` section of `pom.x
 </project>
 ```
 
-Here, the latest version of the [Maven compiler plugin](https://maven.apache.org/plugins/maven-compiler-plugin/) (3.11.0 at the time of writing) is selected.
+Here, version 3.11.0 of the [Maven compiler plugin](https://maven.apache.org/plugins/maven-compiler-plugin/) is selected, which is the latest version at the time of writing.
 
 ### 2.2 Maven resources plugin issues
 

From cae57f8fa5f5356adfaac9f97390ed0c5b64bc82 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 19 Oct 2023 11:51:08 +0200
Subject: [PATCH 60/89] Change the Maven project ID

---
 .../.idea/runConfigurations/Main.xml                     | 2 +-
 .../.idea/runConfigurations/basic_1_0_SNAPSHOT_jar.xml   | 9 ---------
 .../java_project_maven_intellij_1_0_SNAPSHOT_jar.xml     | 9 +++++++++
 ...l_.xml => java_project_maven_intellij__clean____.xml} | 6 +++++-
 java/java-project-maven-intellij/README.md               | 4 ++--
 java/java-project-maven-intellij/pom.xml                 | 3 +--
 6 files changed, 18 insertions(+), 15 deletions(-)
 delete mode 100644 java/java-project-maven-intellij/.idea/runConfigurations/basic_1_0_SNAPSHOT_jar.xml
 create mode 100644 java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij_1_0_SNAPSHOT_jar.xml
 rename java/java-project-maven-intellij/.idea/runConfigurations/{basic__clean_install_.xml => java_project_maven_intellij__clean____.xml} (74%)

diff --git a/java/java-project-maven-intellij/.idea/runConfigurations/Main.xml b/java/java-project-maven-intellij/.idea/runConfigurations/Main.xml
index 6cba21a..161534a 100644
--- a/java/java-project-maven-intellij/.idea/runConfigurations/Main.xml
+++ b/java/java-project-maven-intellij/.idea/runConfigurations/Main.xml
@@ -1,7 +1,7 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="Main" type="Application" factoryName="Application" nameIsGenerated="true">
     <option name="MAIN_CLASS_NAME" value="nl.mauritssilvis.challenges.java.intellij.maven.projects.basic.Main" />
-    <module name="basic" />
+    <module name="java-project-maven-intellij" />
     <extension name="coverage">
       <pattern>
         <option name="PATTERN" value="nl.mauritssilvis.challenges.java.intellij.maven.projects.basic.*" />
diff --git a/java/java-project-maven-intellij/.idea/runConfigurations/basic_1_0_SNAPSHOT_jar.xml b/java/java-project-maven-intellij/.idea/runConfigurations/basic_1_0_SNAPSHOT_jar.xml
deleted file mode 100644
index d07b4bf..0000000
--- a/java/java-project-maven-intellij/.idea/runConfigurations/basic_1_0_SNAPSHOT_jar.xml
+++ /dev/null
@@ -1,9 +0,0 @@
-<component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="basic-1.0-SNAPSHOT.jar" type="JarApplication">
-    <option name="JAR_PATH" value="$PROJECT_DIR$/target/basic-1.0-SNAPSHOT.jar" />
-    <option name="ALTERNATIVE_JRE_PATH" />
-    <method v="2">
-      <option name="RunConfigurationTask" enabled="true" run_configuration_name="basic [clean,install]" run_configuration_type="MavenRunConfiguration" />
-    </method>
-  </configuration>
-</component>
\ No newline at end of file
diff --git a/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij_1_0_SNAPSHOT_jar.xml b/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij_1_0_SNAPSHOT_jar.xml
new file mode 100644
index 0000000..336901a
--- /dev/null
+++ b/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij_1_0_SNAPSHOT_jar.xml
@@ -0,0 +1,9 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="java-project-maven-intellij-1.0-SNAPSHOT.jar" type="JarApplication">
+    <option name="JAR_PATH" value="$PROJECT_DIR$/target/java-project-maven-intellij-1.0-SNAPSHOT.jar" />
+    <option name="ALTERNATIVE_JRE_PATH" />
+    <method v="2">
+      <option name="RunConfigurationTask" enabled="true" run_configuration_name="java-project-maven-intellij [clean...]" run_configuration_type="MavenRunConfiguration" />
+    </method>
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/java/java-project-maven-intellij/.idea/runConfigurations/basic__clean_install_.xml b/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij__clean____.xml
similarity index 74%
rename from java/java-project-maven-intellij/.idea/runConfigurations/basic__clean_install_.xml
rename to java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij__clean____.xml
index 0dcd8c5..c013f0f 100644
--- a/java/java-project-maven-intellij/.idea/runConfigurations/basic__clean_install_.xml
+++ b/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij__clean____.xml
@@ -1,10 +1,11 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="basic [clean,install]" type="MavenRunConfiguration" factoryName="Maven" nameIsGenerated="true">
+  <configuration default="false" name="java-project-maven-intellij [clean...]" type="MavenRunConfiguration" factoryName="Maven" nameIsGenerated="true">
     <MavenSettings>
       <option name="myGeneralSettings" />
       <option name="myRunnerSettings" />
       <option name="myRunnerParameters">
         <MavenRunnerParameters>
+          <option name="cmdOptions" />
           <option name="profiles">
             <set />
           </option>
@@ -18,6 +19,9 @@
           <option name="profilesMap">
             <map />
           </option>
+          <option name="projectsCmdOptionValues">
+            <list />
+          </option>
           <option name="resolveToWorkspace" value="false" />
           <option name="workingDirPath" value="$PROJECT_DIR$" />
         </MavenRunnerParameters>
diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 2038ab6..bc376c4 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -58,7 +58,7 @@ In the project object model of the current project, [pom.xml](pom.xml), the so-c
 ```xml
 <project>
   <groupId>nl.mauritssilvis.challenges.java.intellij.maven.projects</groupId>
-  <artifactId>basic</artifactId>
+  <artifactId>java-project-maven-intellij</artifactId>
   <version>1.0-SNAPSHOT</version>
 </project>
 ```
@@ -194,7 +194,7 @@ For the current project, these coordinates are defined by the following elements
 ```xml
 <project>
   <groupId>nl.mauritssilvis.challenges.java.intellij.maven.projects</groupId>
-  <artifactId>basic</artifactId>
+  <artifactId>java-project-maven-intellij</artifactId>
   <version>1.0-SNAPSHOT</version>
 </project>
 ```
diff --git a/java/java-project-maven-intellij/pom.xml b/java/java-project-maven-intellij/pom.xml
index 4ff7284..cafbf2f 100644
--- a/java/java-project-maven-intellij/pom.xml
+++ b/java/java-project-maven-intellij/pom.xml
@@ -15,8 +15,7 @@
 
     <!-- Set the project coordinates -->
     <groupId>nl.mauritssilvis.challenges.java.intellij.maven.projects</groupId>
-    <!-- TODO: Use the folder name as the artifact ID. -->
-    <artifactId>basic</artifactId>
+    <artifactId>java-project-maven-intellij</artifactId>
     <version>1.0-SNAPSHOT</version>
 
     <properties>

From 603f655cfd9c704388c853bee10e2b327d4ed3a9 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 19 Oct 2023 11:53:36 +0200
Subject: [PATCH 61/89] Change final Maven stage

---
 .../java_project_maven_intellij__clean____.xml                  | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij__clean____.xml b/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij__clean____.xml
index c013f0f..f98d477 100644
--- a/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij__clean____.xml
+++ b/java/java-project-maven-intellij/.idea/runConfigurations/java_project_maven_intellij__clean____.xml
@@ -12,7 +12,7 @@
           <option name="goals">
             <list>
               <option value="clean" />
-              <option value="install" />
+              <option value="package" />
             </list>
           </option>
           <option name="pomFileName" />

From 95a690532439c2c237c263851c2583a1c98b16f7 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 19 Oct 2023 12:06:09 +0200
Subject: [PATCH 62/89] Update the Java version to 21

---
 java/java-project-maven-intellij/README.md | 32 +++++++++++-----------
 java/java-project-maven-intellij/pom.xml   |  4 +--
 2 files changed, 18 insertions(+), 18 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index bc376c4..61e4ee2 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -88,8 +88,8 @@ Finally, the [Maven compiler plugin](https://maven.apache.org/plugins/maven-comp
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.11.0</version>
         <configuration>
-          <source>20</source>
-          <target>20</target>
+          <source>21</source>
+          <target>21</target>
         </configuration>
       </plugin>
     </plugins>
@@ -98,7 +98,7 @@ Finally, the [Maven compiler plugin](https://maven.apache.org/plugins/maven-comp
 ```
 
 Here, version 3.11.0 of the [Maven compiler plugin](https://maven.apache.org/plugins/maven-compiler-plugin/) is selected, which is the latest version at the time of writing.
-Additionally, the latest version of Java (Java 20 at the time of writing) is selected, which requires the corresponding version of the Java Development Kit (JDK) (see, e.g., https://adoptium.net/temurin/releases/).
+Additionally, Java 21 is selected, which is the latest long-term support (LTS) version of Java at the time of writing.
 
 #### 1.3.2 Build
 
@@ -324,12 +324,12 @@ The Maven compiler plugin may halt with one of the following errors:
 
 To solve these problems, explicitly set the Java source version in the project object model, `pom.xml`.
 
-The source version can be set to Java 20 by extending the `properties` section of `pom.xml` with the following line:
+The source version can be set to Java 21 by extending the `properties` section of `pom.xml` with the following line:
 
 ```xml
 <project>
   <properties>
-    <maven.compiler.source>20</maven.compiler.source>
+    <maven.compiler.source>21</maven.compiler.source>
   </properties>
 </project>
 ```
@@ -361,7 +361,7 @@ Alternatively, configure both the Java source and Maven compiler plugin versions
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.11.0</version>
         <configuration>
-          <source>20</source>
+          <source>21</source>
         </configuration>
       </plugin>
     </plugins>
@@ -387,12 +387,12 @@ The Maven compiler plugin may halt with one of the following errors:
 
 To solve these problems, explicitly set the Java target version in the project object model, `pom.xml`.
 
-The target version can be set to Java 20 by extending the `properties` section of `pom.xml` with the following line:
+The target version can be set to Java 21 by extending the `properties` section of `pom.xml` with the following line:
 
 ```xml
 <project>
   <properties>
-    <maven.compiler.target>20</maven.compiler.target>
+    <maven.compiler.target>21</maven.compiler.target>
   </properties>
 </project>
 ```
@@ -424,7 +424,7 @@ Alternatively, configure both the Java target and Maven compiler plugin versions
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.11.0</version>
         <configuration>
-          <target>20</target>
+          <target>21</target>
         </configuration>
       </plugin>
     </plugins>
@@ -432,7 +432,7 @@ Alternatively, configure both the Java target and Maven compiler plugin versions
 </project>
 ```
 
-#### 2.3.4 Failure executing javac, but could not parse the error / Source release 20 requires target release 20
+#### 2.3.4 Failure executing javac, but could not parse the error / Source release 21 requires target release 21
 
 The Maven compiler plugin may encounter either of the following errors while compiling:
 
@@ -441,19 +441,19 @@ The Maven compiler plugin may encounter either of the following errors while com
 ```
 
 ```text
-source release 20 requires target release 20
+source release 21 requires target release 21
 ```
 
 To solve these problems, ensure the Java source and target versions are set in the project object model, `pom.xml`.
 Additionally, ensure that the target version is not smaller than the source version.
 
-Java 20 can be selected by extending the `properties` section of `pom.xml` with the following lines:
+Java 21 can be selected by extending the `properties` section of `pom.xml` with the following lines:
 
 ```xml
 <project>
   <properties>
-    <maven.compiler.source>20</maven.compiler.source>
-    <maven.compiler.target>20</maven.compiler.target>
+    <maven.compiler.source>21</maven.compiler.source>
+    <maven.compiler.target>21</maven.compiler.target>
   </properties>
 </project>
 ```
@@ -485,8 +485,8 @@ Alternatively, configure the Java target, source and Maven compiler plugin versi
         <artifactId>maven-compiler-plugin</artifactId>
         <version>3.11.0</version>
         <configuration>
-          <source>20</source>
-          <target>20</target>
+          <source>21</source>
+          <target>21</target>
         </configuration>
       </plugin>
     </plugins>
diff --git a/java/java-project-maven-intellij/pom.xml b/java/java-project-maven-intellij/pom.xml
index cafbf2f..a3ea5b9 100644
--- a/java/java-project-maven-intellij/pom.xml
+++ b/java/java-project-maven-intellij/pom.xml
@@ -33,9 +33,9 @@
                 <version>3.11.0</version>
                 <configuration>
                     <!-- Set the Java source version >= 7 -->
-                    <source>20</source>
+                    <source>21</source>
                     <!-- Set the Java target version >= 7 -->
-                    <target>20</target>
+                    <target>21</target>
                 </configuration>
             </plugin>
         </plugins>

From 6585e4c751218432d9d15a7b67ee2617269c4c1e Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 19 Oct 2023 12:09:32 +0200
Subject: [PATCH 63/89] Use uniform code type

---
 java/java-project-cli/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index b92fc5f..afb05ff 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -172,7 +172,7 @@ java Main.java
 
 Alternatively, direct execution from the main project folder is possible:
 
-```bash
+```shell
 java src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main.java
 ```
 

From 5d4808b9b589a2c9a359c6ed8081e81ce3faa79a Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 19 Oct 2023 12:13:01 +0200
Subject: [PATCH 64/89] Extend the description of building

---
 java/java-project-maven-intellij/README.md | 14 +++++++++++---
 1 file changed, 11 insertions(+), 3 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 61e4ee2..0a46899 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -102,14 +102,22 @@ Additionally, Java 21 is selected, which is the latest long-term support (LTS) v
 
 #### 1.3.2 Build
 
-The project can be built using the following command:
+The project can, for example, be built using the following command:
+
+```shell
+mvn clean package
+```
+
+Execution of this command will compile the above-mentioned Java class file and package it as a JAR file.
+
+Alternatively, execute the following command:
 
 ```shell
 mvn clean install
 ```
 
-Execution of this command will compile the above-mentioned Java class file, package it as a JAR file and make this JAR available in your local Maven repository.
-Note that this JAR will [not be executable](#24-maven-jar-plugin-issues).
+In addition to the previous command, this command will make the JAR available in your local Maven repository.
+Note that the JAR will [not be executable](#24-maven-jar-plugin-issues).
 
 ## 2. Issues and solutions
 

From 2d666999140bc6c0f69088ce57352b7118d2419f Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 19 Oct 2023 12:14:45 +0200
Subject: [PATCH 65/89] Enhance the description of building

---
 java/java-project-maven-intellij/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 0a46899..c51b3c3 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -102,13 +102,13 @@ Additionally, Java 21 is selected, which is the latest long-term support (LTS) v
 
 #### 1.3.2 Build
 
-The project can, for example, be built using the following command:
+The project can be built using the following command:
 
 ```shell
 mvn clean package
 ```
 
-Execution of this command will compile the above-mentioned Java class file and package it as a JAR file.
+Execution of this command will clean the build folder, compile the above-mentioned Java class file and package it as a JAR file.
 
 Alternatively, execute the following command:
 

From 9c663df8b1c1470551c8ddc9544783b5de61fb3a Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 19 Oct 2023 13:06:22 +0200
Subject: [PATCH 66/89] Update Maven POM issue section

---
 java/java-project-maven-intellij/README.md | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index c51b3c3..7b1e4fd 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -136,7 +136,7 @@ Several issues may arise concerning the [project object model](https://maven.apa
 When executing Maven goals, the following error may occur:
 
 ```text
-[ERROR] The goal you specified requires a project to execute but there is no POM in this directory. Please verify you invoked Maven from the correct directory.
+[ERROR] The goal you specified requires a project to execute but there is no POM in this directory ... Please verify you invoked Maven from the correct directory.
 ```
 
 To solve this problem, ensure the project's top-level directory contains a project object model file called `pom.xml` and that Maven is run in this directory.
@@ -147,7 +147,7 @@ When executing Maven goals, the following error may occur:
 
 ```text
 [ERROR] Some problems were encountered while processing the POMs:
-[FATAL] Non-readable POM: input contained no data
+[FATAL] Non-readable POM ...: input contained no data
 ```
 
 To solve this problem, ensure the project object model, `pom.xml`, contains at least the `project` root element.
@@ -173,7 +173,7 @@ When executing Maven goals, the following error may occur:
 
 ```text
 [ERROR] Some problems were encountered while processing the POMs:
-[ERROR] 'modelVersion' is missing. @ line 1, column 9
+[ERROR] 'modelVersion' is missing. @ line 1, column 10
 ```
 
 To solve this problem, set the model version in the project object model, `pom.xml`:
@@ -190,9 +190,9 @@ When executing Maven goals, one or more of the following errors may occur:
 
 ```text
 [ERROR] Some problems were encountered while processing the POMs:
-[FATAL] 'groupId' is missing. @ line 1, column 9
-[FATAL] 'artifactId' is missing. @ line 1, column 9
-[FATAL] 'version' is missing. @ line 1, column 9
+[FATAL] 'groupId' is missing. @ line 1, column 10
+[FATAL] 'artifactId' is missing. @ line 1, column 10
+[FATAL] 'version' is missing. @ line 1, column 10
 ```
 
 To solve these problems, include the project coordinates, i.e., the group ID, the ID and the version of the artifact, in the project object model, `pom.xml`.
@@ -213,7 +213,7 @@ When executing Maven goals, the following error may occur:
 
 ```text
 [ERROR] Some problems were encountered while processing the POMs:
-[FATAL] 'build.plugins.plugin.(groupId:artifactId)' artifactId of a plugin must be defined.  @ line 21, column 21
+[FATAL] 'build.plugins.plugin.(groupId:artifactId)' artifactId of a plugin must be defined.  @ line 10, column 21
 ```
 
 To solve this problem, ensure all desired Maven plugins are identified using their artifact ID.
@@ -238,8 +238,8 @@ For example, the Maven compiler plugin can be selected with the following `build
 When using Maven plugins, a warning may be shown that is similar to the following:
 
 ```text
-[WARNING] Some problems were encountered while building the effective model for nl.mauritssilvis.challenges.java.intellij.maven.projects:basic:jar:1.0-SNAPSHOT
-[WARNING] 'build.plugins.plugin.version' for org.apache.maven.plugins:maven-compiler-plugin is missing. @ line 23, column 21
+[WARNING] Some problems were encountered while building the effective model for nl.mauritssilvis.challenges.java.intellij.maven.projects:java-project-maven-intellij:jar:1.0-SNAPSHOT
+[WARNING] 'build.plugins.plugin.version' for org.apache.maven.plugins:maven-compiler-plugin is missing. @ line 9, column 21
 [WARNING]
 [WARNING] It is highly recommended to fix these problems because they threaten the stability of your build.
 [WARNING]

From 8a48833c7188f4647effbd75f3f0652192645010 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 24 Oct 2023 11:54:00 +0200
Subject: [PATCH 67/89] Describe implicit Java version warnings

---
 java/java-project-maven-intellij/README.md | 66 +++++++++++++++++++++-
 1 file changed, 63 insertions(+), 3 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 7b1e4fd..c78a6da 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -314,7 +314,67 @@ To set the file encoding to UTF-8, include the following line in the `properties
 </project>
 ```
 
-#### 2.3.2 Source option is no longer supported. Use 7 or later.
+#### 2.3.2 Bootstrap class path not set in conjunction with -source 8 / Source value 8 is obsolete and will be removed in a future release / Target value 8 is obsolete and will be removed in a future release
+
+The Maven compiler plugin may return the following warnings:
+
+```text
+[WARNING] bootstrap class path not set in conjunction with -source 8
+[WARNING] source value 8 is obsolete and will be removed in a future release
+[WARNING] target value 8 is obsolete and will be removed in a future release
+```
+
+To solve these warnings, ensure the Java source and target versions are explicitly set in the project object model, `pom.xml`, and are higher than 8.
+Additionally, ensure that the target version is not smaller than the source version.
+
+Java 21 can be selected by extending the `properties` section of `pom.xml` with the following lines:
+
+```xml
+<project>
+  <properties>
+    <maven.compiler.source>21</maven.compiler.source>
+    <maven.compiler.target>21</maven.compiler.target>
+  </properties>
+</project>
+```
+
+In addition, select the latest version of the [Maven compiler plugin](https://maven.apache.org/plugins/maven-compiler-plugin/) (3.11.0 at the time of writing) in the `build` section of `pom.xml`:
+
+```xml
+<project>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.11.0</version>
+      </plugin>
+    </plugins>
+  </build>
+</project>
+```
+
+Alternatively, configure the Java target, source and Maven compiler plugin versions in the `build` section:
+
+```xml
+<project>
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.11.0</version>
+        <configuration>
+          <source>21</source>
+          <target>21</target>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+</project>
+```
+
+#### 2.3.3 Source option is no longer supported. Use 7 or later.
 
 The Maven compiler plugin may halt with one of the following errors:
 
@@ -377,7 +437,7 @@ Alternatively, configure both the Java source and Maven compiler plugin versions
 </project>
 ```
 
-#### 2.3.3 Target option is no longer supported. Use 7 or later.
+#### 2.3.4 Target option is no longer supported. Use 7 or later.
 
 The Maven compiler plugin may halt with one of the following errors:
 
@@ -440,7 +500,7 @@ Alternatively, configure both the Java target and Maven compiler plugin versions
 </project>
 ```
 
-#### 2.3.4 Failure executing javac, but could not parse the error / Source release 21 requires target release 21
+#### 2.3.5 Failure executing javac, but could not parse the error / Source release 21 requires target release 21
 
 The Maven compiler plugin may encounter either of the following errors while compiling:
 

From c81c9f7678f407b3535350360ac57a6496aaaff0 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 24 Oct 2023 12:12:43 +0200
Subject: [PATCH 68/89] Update required version

---
 java/java-project-maven-intellij/pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-maven-intellij/pom.xml b/java/java-project-maven-intellij/pom.xml
index a3ea5b9..68af83b 100644
--- a/java/java-project-maven-intellij/pom.xml
+++ b/java/java-project-maven-intellij/pom.xml
@@ -32,9 +32,9 @@
                 <!-- Set the latest version of the Maven compiler plugin -->
                 <version>3.11.0</version>
                 <configuration>
-                    <!-- Set the Java source version >= 7 -->
+                    <!-- Set the Java source version >= 9 -->
                     <source>21</source>
-                    <!-- Set the Java target version >= 7 -->
+                    <!-- Set the Java target version >= 9 -->
                     <target>21</target>
                 </configuration>
             </plugin>

From 5faa4b4eeda60d53bc186b92cb4d35c191e82964 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Tue, 24 Oct 2023 12:25:43 +0200
Subject: [PATCH 69/89] Remove unrelated issue

---
 java/java-project-maven-intellij/README.md | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index c78a6da..e9b8ffe 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -314,12 +314,11 @@ To set the file encoding to UTF-8, include the following line in the `properties
 </project>
 ```
 
-#### 2.3.2 Bootstrap class path not set in conjunction with -source 8 / Source value 8 is obsolete and will be removed in a future release / Target value 8 is obsolete and will be removed in a future release
+#### 2.3.2 Source value 8 is obsolete and will be removed in a future release / Target value 8 is obsolete and will be removed in a future release
 
 The Maven compiler plugin may return the following warnings:
 
 ```text
-[WARNING] bootstrap class path not set in conjunction with -source 8
 [WARNING] source value 8 is obsolete and will be removed in a future release
 [WARNING] target value 8 is obsolete and will be removed in a future release
 ```

From 9c16f8a54ddca155702403a121403979e1000927 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 26 Oct 2023 13:49:19 +0200
Subject: [PATCH 70/89] Lower the minimal Java version

---
 java/java-project-maven-intellij/pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/java-project-maven-intellij/pom.xml b/java/java-project-maven-intellij/pom.xml
index 68af83b..47c521e 100644
--- a/java/java-project-maven-intellij/pom.xml
+++ b/java/java-project-maven-intellij/pom.xml
@@ -32,9 +32,9 @@
                 <!-- Set the latest version of the Maven compiler plugin -->
                 <version>3.11.0</version>
                 <configuration>
-                    <!-- Set the Java source version >= 9 -->
+                    <!-- Set the Java source version >= 8 -->
                     <source>21</source>
-                    <!-- Set the Java target version >= 9 -->
+                    <!-- Set the Java target version >= 8 -->
                     <target>21</target>
                 </configuration>
             </plugin>

From 358dee686b946925a5322a79b2b0af291dcd2fff Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 9 Nov 2023 17:23:10 +0100
Subject: [PATCH 71/89] Add license to changelog

---
 CHANGELOG.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 780bbc9..f5d361f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -35,3 +35,9 @@ and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0
 - Add a Java project set up using IntelliJ IDEA.
 - Add a Java project set up using Maven and IntelliJ IDEA.
 - Add a project that can create an executable JAR using Maven and IntelliJ IDEA.
+
+## License
+
+Copyright © 2023 Maurits Silvis
+
+This source code package is subject to the terms and conditions defined in the [GNU General Public License v3.0](LICENSE.md) or later.

From 0a03fce10b9d0fc81c56c150a0628a2e20bd136f Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Thu, 9 Nov 2023 17:26:41 +0100
Subject: [PATCH 72/89] Add a section header

---
 CHANGELOG.md | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index f5d361f..4f9f50e 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,6 +7,8 @@ and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
 - Improve the project documentation.
 - Update the Java version from 20 to 21.
 

From f6dc69db8e9242464a1161575f6b59eb4f6ca505 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 14:01:16 +0100
Subject: [PATCH 73/89] Add standard Git attribute file

---
 .gitattributes                                | 90 ++++++++++++++++++-
 .../.gitattributes                            | 42 +++++++++
 java/java-project-cli/.gitattributes          | 42 +++++++++
 java/java-project-intellij/.gitattributes     | 42 +++++++++
 .../.gitattributes                            | 42 +++++++++
 5 files changed, 255 insertions(+), 3 deletions(-)
 create mode 100644 java/executable-jar-maven-intellij/.gitattributes
 create mode 100644 java/java-project-cli/.gitattributes
 create mode 100644 java/java-project-intellij/.gitattributes
 create mode 100644 java/java-project-maven-intellij/.gitattributes

diff --git a/.gitattributes b/.gitattributes
index 0a0f148..126aa7e 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1,4 +1,88 @@
-# https://help.github.com/articles/dealing-with-line-endings/
-* text eol=lf
+# Created by https://gitattributes.io/api/common
+# Adapted according to https://stackoverflow.com/a/42135910/12911324
 
-*.bat text eol=crlf
+# Common settings that generally should always be used with your language specific settings
+
+# Auto detect text files and perform LF normalization
+*          text=auto eol=lf
+
+#
+# The above will handle all files NOT found below
+#
+
+# Documents
+*.bibtex   text diff=bibtex
+*.doc      diff=astextplain
+*.DOC      diff=astextplain
+*.docx     diff=astextplain
+*.DOCX     diff=astextplain
+*.dot      diff=astextplain
+*.DOT      diff=astextplain
+*.pdf      diff=astextplain
+*.PDF      diff=astextplain
+*.rtf      diff=astextplain
+*.RTF      diff=astextplain
+*.md       text diff=markdown
+*.mdx      text diff=markdown
+*.tex      text diff=tex
+*.adoc     text
+*.textile  text
+*.mustache text
+*.csv      text eol=crlf
+*.tab      text
+*.tsv      text
+*.txt      text
+*.sql      text
+*.epub     diff=astextplain
+
+# Graphics
+*.png      binary
+*.jpg      binary
+*.jpeg     binary
+*.gif      binary
+*.tif      binary
+*.tiff     binary
+*.ico      binary
+# SVG treated as text by default.
+*.svg      text
+# If you want to treat it as binary,
+# use the following line instead.
+# *.svg    binary
+*.eps      binary
+
+# Scripts
+*.bash     text eol=lf
+*.fish     text eol=lf
+*.sh       text eol=lf
+*.zsh      text eol=lf
+# These are explicitly windows files and should use crlf
+*.bat      text eol=crlf
+*.cmd      text eol=crlf
+*.ps1      text eol=crlf
+
+# Serialisation
+*.json     text
+*.toml     text
+*.xml      text
+*.yaml     text
+*.yml      text
+
+# Archives
+*.7z       binary
+*.gz       binary
+*.tar      binary
+*.tgz      binary
+*.zip      binary
+
+# Text files where line endings should be preserved
+*.patch    -text
+
+#
+# Exclude files from exporting
+#
+
+.gitattributes export-ignore
+.gitignore     export-ignore
+.gitkeep       export-ignore
+
+# End of https://gitattributes.io/api/common
diff --git a/java/executable-jar-maven-intellij/.gitattributes b/java/executable-jar-maven-intellij/.gitattributes
new file mode 100644
index 0000000..b767c26
--- /dev/null
+++ b/java/executable-jar-maven-intellij/.gitattributes
@@ -0,0 +1,42 @@
+# Created by https://gitattributes.io/api/java
+
+# Java sources
+*.java          text diff=java
+*.kt            text diff=kotlin
+*.groovy        text diff=java
+*.scala         text diff=java
+*.gradle        text diff=java
+*.gradle.kts    text diff=kotlin
+
+# These files are text and should be normalized (Convert crlf => lf)
+*.css           text diff=css
+*.scss          text diff=css
+*.sass          text
+*.df            text
+*.htm           text diff=html
+*.html          text diff=html
+*.js            text
+*.jsp           text
+*.jspf          text
+*.jspx          text
+*.properties    text
+*.tld           text
+*.tag           text
+*.tagx          text
+*.xml           text
+
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.class         binary
+*.dll           binary
+*.ear           binary
+*.jar           binary
+*.so            binary
+*.war           binary
+*.jks           binary
+
+# Common build-tool wrapper scripts ('.cmd' versions are handled by 'Common.gitattributes')
+mvnw            text eol=lf
+gradlew         text eol=lf
+
+# End of https://gitattributes.io/api/java
diff --git a/java/java-project-cli/.gitattributes b/java/java-project-cli/.gitattributes
new file mode 100644
index 0000000..b767c26
--- /dev/null
+++ b/java/java-project-cli/.gitattributes
@@ -0,0 +1,42 @@
+# Created by https://gitattributes.io/api/java
+
+# Java sources
+*.java          text diff=java
+*.kt            text diff=kotlin
+*.groovy        text diff=java
+*.scala         text diff=java
+*.gradle        text diff=java
+*.gradle.kts    text diff=kotlin
+
+# These files are text and should be normalized (Convert crlf => lf)
+*.css           text diff=css
+*.scss          text diff=css
+*.sass          text
+*.df            text
+*.htm           text diff=html
+*.html          text diff=html
+*.js            text
+*.jsp           text
+*.jspf          text
+*.jspx          text
+*.properties    text
+*.tld           text
+*.tag           text
+*.tagx          text
+*.xml           text
+
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.class         binary
+*.dll           binary
+*.ear           binary
+*.jar           binary
+*.so            binary
+*.war           binary
+*.jks           binary
+
+# Common build-tool wrapper scripts ('.cmd' versions are handled by 'Common.gitattributes')
+mvnw            text eol=lf
+gradlew         text eol=lf
+
+# End of https://gitattributes.io/api/java
diff --git a/java/java-project-intellij/.gitattributes b/java/java-project-intellij/.gitattributes
new file mode 100644
index 0000000..b767c26
--- /dev/null
+++ b/java/java-project-intellij/.gitattributes
@@ -0,0 +1,42 @@
+# Created by https://gitattributes.io/api/java
+
+# Java sources
+*.java          text diff=java
+*.kt            text diff=kotlin
+*.groovy        text diff=java
+*.scala         text diff=java
+*.gradle        text diff=java
+*.gradle.kts    text diff=kotlin
+
+# These files are text and should be normalized (Convert crlf => lf)
+*.css           text diff=css
+*.scss          text diff=css
+*.sass          text
+*.df            text
+*.htm           text diff=html
+*.html          text diff=html
+*.js            text
+*.jsp           text
+*.jspf          text
+*.jspx          text
+*.properties    text
+*.tld           text
+*.tag           text
+*.tagx          text
+*.xml           text
+
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.class         binary
+*.dll           binary
+*.ear           binary
+*.jar           binary
+*.so            binary
+*.war           binary
+*.jks           binary
+
+# Common build-tool wrapper scripts ('.cmd' versions are handled by 'Common.gitattributes')
+mvnw            text eol=lf
+gradlew         text eol=lf
+
+# End of https://gitattributes.io/api/java
diff --git a/java/java-project-maven-intellij/.gitattributes b/java/java-project-maven-intellij/.gitattributes
new file mode 100644
index 0000000..b767c26
--- /dev/null
+++ b/java/java-project-maven-intellij/.gitattributes
@@ -0,0 +1,42 @@
+# Created by https://gitattributes.io/api/java
+
+# Java sources
+*.java          text diff=java
+*.kt            text diff=kotlin
+*.groovy        text diff=java
+*.scala         text diff=java
+*.gradle        text diff=java
+*.gradle.kts    text diff=kotlin
+
+# These files are text and should be normalized (Convert crlf => lf)
+*.css           text diff=css
+*.scss          text diff=css
+*.sass          text
+*.df            text
+*.htm           text diff=html
+*.html          text diff=html
+*.js            text
+*.jsp           text
+*.jspf          text
+*.jspx          text
+*.properties    text
+*.tld           text
+*.tag           text
+*.tagx          text
+*.xml           text
+
+# These files are binary and should be left untouched
+# (binary is a macro for -text -diff)
+*.class         binary
+*.dll           binary
+*.ear           binary
+*.jar           binary
+*.so            binary
+*.war           binary
+*.jks           binary
+
+# Common build-tool wrapper scripts ('.cmd' versions are handled by 'Common.gitattributes')
+mvnw            text eol=lf
+gradlew         text eol=lf
+
+# End of https://gitattributes.io/api/java

From 41d9f2d2ddfcd6f005a1d4779dc22c3e68e3e679 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:00:42 +0100
Subject: [PATCH 74/89] Describe changes in detail

---
 CHANGELOG.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 4f9f50e..b0aaa2c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,7 +9,10 @@ and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- Improve the project documentation.
+- Improve and extend the general project documentation.
+- Improve and extend the documentation of the command-line Java project.
+- Improve and extend the documentation of the IntelliJ Java project.
+- Improve and extend the documentation of the Maven Java project.
 - Update the Java version from 20 to 21.
 
 ## [0.3.1] - 2023-09-16

From af5bb2e34e26a0813bef1e8374ca60686974c099 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:11:35 +0100
Subject: [PATCH 75/89] Set the latest Java version

---
 java/executable-jar-maven-intellij/pom.xml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/executable-jar-maven-intellij/pom.xml b/java/executable-jar-maven-intellij/pom.xml
index 04db888..8762f5a 100644
--- a/java/executable-jar-maven-intellij/pom.xml
+++ b/java/executable-jar-maven-intellij/pom.xml
@@ -26,8 +26,8 @@
                 <artifactId>maven-compiler-plugin</artifactId>
                 <version>3.11.0</version>
                 <configuration>
-                    <source>20</source>
-                    <target>20</target>
+                    <source>21</source>
+                    <target>21</target>
                 </configuration>
             </plugin>
 

From 6d269bef473743d006829fb37513d7f8aa71ba9a Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:16:06 +0100
Subject: [PATCH 76/89] Use a more descriptive artifact ID

---
 java/executable-jar-maven-intellij/pom.xml | 5 ++---
 1 file changed, 2 insertions(+), 3 deletions(-)

diff --git a/java/executable-jar-maven-intellij/pom.xml b/java/executable-jar-maven-intellij/pom.xml
index 8762f5a..c85a5a5 100644
--- a/java/executable-jar-maven-intellij/pom.xml
+++ b/java/executable-jar-maven-intellij/pom.xml
@@ -10,9 +10,8 @@
          xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
     <modelVersion>4.0.0</modelVersion>
 
-    <groupId>nl.mauritssilvis.challenges.java.intellij.maven.jars.executable</groupId>
-    <!-- TODO: Use the folder name as the artifact ID. -->
-    <artifactId>standalone</artifactId>
+    <groupId>nl.mauritssilvis.challenges.java.intellij.maven.jars</groupId>
+    <artifactId>executable-jar-maven-intellij</artifactId>
     <version>1.0-SNAPSHOT</version>
 
     <properties>

From d938740dc02c859a5047f0962c920742ce9d69c9 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:17:11 +0100
Subject: [PATCH 77/89] Update the module name

---
 .../.idea/runConfigurations/Main.xml                            | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/executable-jar-maven-intellij/.idea/runConfigurations/Main.xml b/java/executable-jar-maven-intellij/.idea/runConfigurations/Main.xml
index 330c19e..c830b58 100644
--- a/java/executable-jar-maven-intellij/.idea/runConfigurations/Main.xml
+++ b/java/executable-jar-maven-intellij/.idea/runConfigurations/Main.xml
@@ -1,7 +1,7 @@
 <component name="ProjectRunConfigurationManager">
   <configuration default="false" name="Main" type="Application" factoryName="Application" nameIsGenerated="true">
     <option name="MAIN_CLASS_NAME" value="nl.mauritssilvis.challenges.java.intellij.maven.jars.executable.standalone.Main" />
-    <module name="standalone" />
+    <module name="executable-jar-maven-intellij" />
     <extension name="coverage">
       <pattern>
         <option name="PATTERN" value="nl.mauritssilvis.challenges.java.intellij.maven.jars.executable.standalone.*" />

From 510742d5508527f42682e332bf5918f3f741bcf1 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:28:14 +0100
Subject: [PATCH 78/89] Update run configurations according to project name

---
 .../executable_jar_maven_intellij_1_0_SNAPSHOT_jar.xml   | 9 +++++++++
 ....xml => executable_jar_maven_intellij__clean____.xml} | 8 ++++++--
 .../runConfigurations/standalone_1_0_SNAPSHOT_jar.xml    | 9 ---------
 3 files changed, 15 insertions(+), 11 deletions(-)
 create mode 100644 java/executable-jar-maven-intellij/.idea/runConfigurations/executable_jar_maven_intellij_1_0_SNAPSHOT_jar.xml
 rename java/executable-jar-maven-intellij/.idea/runConfigurations/{standalone__clean_install_.xml => executable_jar_maven_intellij__clean____.xml} (71%)
 delete mode 100644 java/executable-jar-maven-intellij/.idea/runConfigurations/standalone_1_0_SNAPSHOT_jar.xml

diff --git a/java/executable-jar-maven-intellij/.idea/runConfigurations/executable_jar_maven_intellij_1_0_SNAPSHOT_jar.xml b/java/executable-jar-maven-intellij/.idea/runConfigurations/executable_jar_maven_intellij_1_0_SNAPSHOT_jar.xml
new file mode 100644
index 0000000..7c0b994
--- /dev/null
+++ b/java/executable-jar-maven-intellij/.idea/runConfigurations/executable_jar_maven_intellij_1_0_SNAPSHOT_jar.xml
@@ -0,0 +1,9 @@
+<component name="ProjectRunConfigurationManager">
+  <configuration default="false" name="executable-jar-maven-intellij-1.0-SNAPSHOT.jar" type="JarApplication">
+    <option name="JAR_PATH" value="$PROJECT_DIR$/target/executable-jar-maven-intellij-1.0-SNAPSHOT.jar" />
+    <option name="ALTERNATIVE_JRE_PATH" />
+    <method v="2">
+      <option name="RunConfigurationTask" enabled="true" run_configuration_name="executable-jar-maven-intellij [clean...]" run_configuration_type="MavenRunConfiguration" />
+    </method>
+  </configuration>
+</component>
\ No newline at end of file
diff --git a/java/executable-jar-maven-intellij/.idea/runConfigurations/standalone__clean_install_.xml b/java/executable-jar-maven-intellij/.idea/runConfigurations/executable_jar_maven_intellij__clean____.xml
similarity index 71%
rename from java/executable-jar-maven-intellij/.idea/runConfigurations/standalone__clean_install_.xml
rename to java/executable-jar-maven-intellij/.idea/runConfigurations/executable_jar_maven_intellij__clean____.xml
index ff75bee..861b3a6 100644
--- a/java/executable-jar-maven-intellij/.idea/runConfigurations/standalone__clean_install_.xml
+++ b/java/executable-jar-maven-intellij/.idea/runConfigurations/executable_jar_maven_intellij__clean____.xml
@@ -1,23 +1,27 @@
 <component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="standalone [clean,install]" type="MavenRunConfiguration" factoryName="Maven" nameIsGenerated="true">
+  <configuration default="false" name="executable-jar-maven-intellij [clean...]" type="MavenRunConfiguration" factoryName="Maven" nameIsGenerated="true">
     <MavenSettings>
       <option name="myGeneralSettings" />
       <option name="myRunnerSettings" />
       <option name="myRunnerParameters">
         <MavenRunnerParameters>
+          <option name="cmdOptions" />
           <option name="profiles">
             <set />
           </option>
           <option name="goals">
             <list>
               <option value="clean" />
-              <option value="install" />
+              <option value="package" />
             </list>
           </option>
           <option name="pomFileName" />
           <option name="profilesMap">
             <map />
           </option>
+          <option name="projectsCmdOptionValues">
+            <list />
+          </option>
           <option name="resolveToWorkspace" value="false" />
           <option name="workingDirPath" value="$PROJECT_DIR$" />
         </MavenRunnerParameters>
diff --git a/java/executable-jar-maven-intellij/.idea/runConfigurations/standalone_1_0_SNAPSHOT_jar.xml b/java/executable-jar-maven-intellij/.idea/runConfigurations/standalone_1_0_SNAPSHOT_jar.xml
deleted file mode 100644
index 9756a43..0000000
--- a/java/executable-jar-maven-intellij/.idea/runConfigurations/standalone_1_0_SNAPSHOT_jar.xml
+++ /dev/null
@@ -1,9 +0,0 @@
-<component name="ProjectRunConfigurationManager">
-  <configuration default="false" name="standalone-1.0-SNAPSHOT.jar" type="JarApplication">
-    <option name="JAR_PATH" value="$PROJECT_DIR$/target/standalone-1.0-SNAPSHOT.jar" />
-    <option name="ALTERNATIVE_JRE_PATH" />
-    <method v="2">
-      <option name="RunConfigurationTask" enabled="true" run_configuration_name="standalone [clean,install]" run_configuration_type="MavenRunConfiguration" />
-    </method>
-  </configuration>
-</component>
\ No newline at end of file

From 5f75a996e434d5d4abc6895ef7746c54e07acd69 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:51:15 +0100
Subject: [PATCH 79/89] Update JAR names

---
 java/executable-jar-maven-intellij/README.md | 4 ++--
 java/java-project-maven-intellij/README.md   | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/java/executable-jar-maven-intellij/README.md b/java/executable-jar-maven-intellij/README.md
index 043e8f2..a64f17d 100644
--- a/java/executable-jar-maven-intellij/README.md
+++ b/java/executable-jar-maven-intellij/README.md
@@ -102,12 +102,12 @@ Below, I describe the issues related to the [Maven JAR plugin](#21-maven-jar-plu
 
 Several issues may arise with the [Maven JAR plugin](https://maven.apache.org/plugins/maven-jar-plugin/).
 
-#### 2.1.1 no main manifest attribute, in standalone-1.0-SNAPSHOT.jar
+#### 2.1.1 no main manifest attribute, in executable-jar-maven-intellij-1.0-SNAPSHOT.jar
 
 When trying to execute a JAR, an error similar to the following may occur:
 
 ```text
-no main manifest attribute, in standalone-1.0-SNAPSHOT.jar
+no main manifest attribute, in executable-jar-maven-intellij-1.0-SNAPSHOT.jar
 ```
 
 To solve this problem, use the `build` section of the project object model, `pom.xml`, to configure the Maven JAR plugin.
diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index e9b8ffe..59e61fb 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -565,12 +565,12 @@ Alternatively, configure the Java target, source and Maven compiler plugin versi
 
 At least one issue may arise with the [Maven JAR plugin](https://maven.apache.org/plugins/maven-jar-plugin/).
 
-#### 2.4.1 no main manifest attribute, in basic-1.0-SNAPSHOT.jar
+#### 2.4.1 no main manifest attribute, in java-project-maven-intellij-1.0-SNAPSHOT.jar
 
 When trying to execute a JAR, an error similar to the following may occur:
 
 ```text
-no main manifest attribute, in basic-1.0-SNAPSHOT.jar
+no main manifest attribute, in java-project-maven-intellij-1.0-SNAPSHOT.jar
 ```
 
 To solve this problem, configure the Maven JAR plugin according to the discussion of potential [Maven JAR plugin issues](../executable-jar-maven-intellij/#21-maven-jar-plugin-issues) that is part of [Creating an executable JAR using Maven and IntelliJ IDEA](../executable-jar-maven-intellij).

From 4984e72ad2bc0372cf1a272bfbe99df51a8b53f2 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:51:37 +0100
Subject: [PATCH 80/89] Remove unrecognized error

---
 java/java-project-maven-intellij/README.md | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 59e61fb..635fe16 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -499,13 +499,9 @@ Alternatively, configure both the Java target and Maven compiler plugin versions
 </project>
 ```
 
-#### 2.3.5 Failure executing javac, but could not parse the error / Source release 21 requires target release 21
+#### 2.3.5 Source release 21 requires target release 21
 
-The Maven compiler plugin may encounter either of the following errors while compiling:
-
-```text
-[ERROR] Failure executing javac, but could not parse the error
-```
+The Maven compiler plugin may encounter the following error while compiling:
 
 ```text
 source release 21 requires target release 21

From af94a43ffef7cbd176e85cdb3d3ab5e4b1326f4e Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:51:49 +0100
Subject: [PATCH 81/89] Update the required Java version to 8

---
 java/java-project-maven-intellij/README.md | 24 +++++++++++-----------
 1 file changed, 12 insertions(+), 12 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 635fe16..9b1a449 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -314,16 +314,16 @@ To set the file encoding to UTF-8, include the following line in the `properties
 </project>
 ```
 
-#### 2.3.2 Source value 8 is obsolete and will be removed in a future release / Target value 8 is obsolete and will be removed in a future release
+#### 2.3.2 Source value 7 is obsolete and will be removed in a future release / Target value 7 is obsolete and will be removed in a future release
 
 The Maven compiler plugin may return the following warnings:
 
 ```text
-[WARNING] source value 8 is obsolete and will be removed in a future release
-[WARNING] target value 8 is obsolete and will be removed in a future release
+[WARNING] source value 7 is obsolete and will be removed in a future release
+[WARNING] target value 7 is obsolete and will be removed in a future release
 ```
 
-To solve these warnings, ensure the Java source and target versions are explicitly set in the project object model, `pom.xml`, and are higher than 8.
+To solve these warnings, ensure the Java source and target versions are explicitly set in the project object model, `pom.xml`, and are higher than 7.
 Additionally, ensure that the target version is not smaller than the source version.
 
 Java 21 can be selected by extending the `properties` section of `pom.xml` with the following lines:
@@ -373,20 +373,20 @@ Alternatively, configure the Java target, source and Maven compiler plugin versi
 </project>
 ```
 
-#### 2.3.3 Source option is no longer supported. Use 7 or later.
+#### 2.3.3 Source option is no longer supported. Use 8 or later.
 
 The Maven compiler plugin may halt with one of the following errors:
 
 ```text
-[ERROR] Source option 1.3 is no longer supported. Use 7 or later.
+[ERROR] Source option 1.3 is no longer supported. Use 8 or later.
 ```
 
 ```text
-[ERROR] Source option 5 is no longer supported. Use 7 or later.
+[ERROR] Source option 5 is no longer supported. Use 8 or later.
 ```
 
 ```text
-[ERROR] Source option 6 is no longer supported. Use 7 or later.
+[ERROR] Source option 6 is no longer supported. Use 8 or later.
 ```
 
 To solve these problems, explicitly set the Java source version in the project object model, `pom.xml`.
@@ -436,20 +436,20 @@ Alternatively, configure both the Java source and Maven compiler plugin versions
 </project>
 ```
 
-#### 2.3.4 Target option is no longer supported. Use 7 or later.
+#### 2.3.4 Target option is no longer supported. Use 8 or later.
 
 The Maven compiler plugin may halt with one of the following errors:
 
 ```text
-[ERROR] Target option 1.1 is no longer supported. Use 7 or later.
+[ERROR] Target option 1.1 is no longer supported. Use 8 or later.
 ```
 
 ```text
-[ERROR] Target option 5 is no longer supported. Use 7 or later.
+[ERROR] Target option 5 is no longer supported. Use 8 or later.
 ```
 
 ```text
-[ERROR] Target option 6 is no longer supported. Use 7 or later.
+[ERROR] Target option 6 is no longer supported. Use 8 or later.
 ```
 
 To solve these problems, explicitly set the Java target version in the project object model, `pom.xml`.

From c1c16081c6eed3d7943111ea3ca08b203cafd580 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 15:57:19 +0100
Subject: [PATCH 82/89] Add log level

---
 java/java-project-maven-intellij/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 9b1a449..a44ebd9 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -504,7 +504,7 @@ Alternatively, configure both the Java target and Maven compiler plugin versions
 The Maven compiler plugin may encounter the following error while compiling:
 
 ```text
-source release 21 requires target release 21
+[ERROR] source release 21 requires target release 21
 ```
 
 To solve these problems, ensure the Java source and target versions are set in the project object model, `pom.xml`.

From fb468573037b797a414e67d64d78a4e60666054e Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 16:31:27 +0100
Subject: [PATCH 83/89] Use curly single quotes

---
 java/README.md                               | 4 ++--
 java/executable-jar-maven-intellij/README.md | 4 ++--
 java/java-project-cli/README.md              | 4 ++--
 java/java-project-intellij/README.md         | 6 +++---
 java/java-project-maven-intellij/README.md   | 4 ++--
 5 files changed, 11 insertions(+), 11 deletions(-)

diff --git a/java/README.md b/java/README.md
index 3f7484f..f3657b8 100644
--- a/java/README.md
+++ b/java/README.md
@@ -65,7 +65,7 @@ IntelliJ IDEA has [detailed online documentation](https://www.jetbrains.com/help
 
 IntelliJ IDEA makes it easy to configure code styles, automatic copyright notices, code inspection profiles, run configurations and more.
 The basic IntelliJ IDEA configuration used in the above-mentioned projects is described in the [IntelliJ IDEA section](java-project-intellij/#12-intellij-idea) of [Setting up a Java project using IntelliJ IDEA](java-project-intellij).
-A step-by-step guide for setting up a Java project using IntelliJ IDEA can be found in the [Create a new project section](https://www.jetbrains.com/help/idea/new-project-wizard.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/).
+A step-by-step guide for setting up a Java project using IntelliJ IDEA can be found in the [Create a new project section](https://www.jetbrains.com/help/idea/new-project-wizard.html) of IntelliJ IDEA’s [online documentation](https://www.jetbrains.com/help/idea/).
 
 
 ### 2.4 Maven
@@ -75,7 +75,7 @@ The [project object model](https://maven.apache.org/guides/introduction/introduc
 In this file, the project properties can be set, build plugins can be configured, project dependencies can be defined, etc.
 
 The basic Maven configuration used in the above-mentioned projects is discussed in the [Maven section](java-project-maven-intellij/#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](java-project-maven-intellij).
-A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html) of IntelliJ IDEA's [online documentation](https://www.jetbrains.com/help/idea/).
+A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html) of IntelliJ IDEA’s [online documentation](https://www.jetbrains.com/help/idea/).
 Maven does not need to be installed separately when used with IntelliJ IDEA.
 
 ## License
diff --git a/java/executable-jar-maven-intellij/README.md b/java/executable-jar-maven-intellij/README.md
index a64f17d..979e7c9 100644
--- a/java/executable-jar-maven-intellij/README.md
+++ b/java/executable-jar-maven-intellij/README.md
@@ -6,7 +6,7 @@
 
 With this part of the [Java challenges](..) project, I provide the code and settings for a project that can create an executable JAR using Maven and IntelliJ IDEA.
 
-Below, I give [background information](#1-background) on the project's [code](#11-java), [IntelliJ IDEA's configuration](#12-intellij-idea) and the used [Maven configuration](#13-maven).
+Below, I give [background information](#1-background) on the project’s [code](#11-java), [IntelliJ IDEA’s configuration](#12-intellij-idea) and the used [Maven configuration](#13-maven).
 I also detail some [issues](#2-issues-and-solutions) that can occur when creating an executable JAR using Maven, for which I provide possible solutions.
 
 This project builds on [Setting up a Java project using IntelliJ IDEA](../java-project-intellij) and [Setting up a Java project using Maven and IntelliJ IDEA](../java-project-maven-intellij).
@@ -201,7 +201,7 @@ or a JavaFX application class must extend javafx.application.Application
 
 This error arises when the main class of your project does not contain a proper main method.
 
-To solve this problem, ensure that your project's main class contains a method with the following signature:
+To solve this problem, ensure that your project’s main class contains a method with the following signature:
 
 ```java
 public static void main(String[] args) {
diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index afb05ff..4f3765b 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -6,11 +6,11 @@
 
 With this part of the [Java challenges](..) project, I provide the code and settings for a Java project set up using the command line.
 
-Below, I give detailed [background information](#1-background) on the project's [code](#11-java).
+Below, I give detailed [background information](#1-background) on the project’s [code](#11-java).
 In addition, I list several [issues](#2-issues-and-solutions) that can occur when setting up a Java project.
 I also describe solutions to these issues.
 
-The listed commands assume the working directory corresponds to this project's main folder and can, for example, be executed using Bash.
+The listed commands assume the working directory corresponds to this project’s main folder and can, for example, be executed using Bash.
 I describe this command-line interface in the [Bash section](../#22-bash) of the [Java challenges](..) project.
 
 ## 1. Background
diff --git a/java/java-project-intellij/README.md b/java/java-project-intellij/README.md
index 7d45111..26c4547 100644
--- a/java/java-project-intellij/README.md
+++ b/java/java-project-intellij/README.md
@@ -6,7 +6,7 @@
 
 With this part of the [Java challenges](..) project, I provide the code and settings for a Java project set up using IntelliJ IDEA.
 
-Below, I give [background information](#1-background) on the project's [code](#11-java) and [IntelliJ IDEA's configuration](#12-intellij-idea).
+Below, I give [background information](#1-background) on the project’s [code](#11-java) and [IntelliJ IDEA’s configuration](#12-intellij-idea).
 I also discuss [issues](#2-issues-and-solutions) that can occur when setting up a Java project using IntelliJ IDEA.
 
 ## 1. Background
@@ -81,7 +81,7 @@ This project comes with a run configuration for executing the `main` method of t
 ##### Java Development Kit
 
 This project is configured to run with the [Adoptium](https://adoptium.net/) distribution of the Java Development Kit (JDK) 21.
-This setting can be reviewed in IntelliJ IDEA's project settings or the file [misc.xml](.idea/misc.xml).
+This setting can be reviewed in IntelliJ IDEA’s project settings or the file [misc.xml](.idea/misc.xml).
 
 ## 2. Issues and solutions
 
@@ -102,7 +102,7 @@ Project JDK is not defined
 JDK "temurin-21" is missing
 ```
 
-To solve these warnings and be able to execute the project's code, configure the project JDK in IntelliJ IDEA's project settings.
+To solve these warnings and be able to execute the project’s code, configure the project JDK in IntelliJ IDEA’s project settings.
 You can either select one of the listed JDKs or opt for the Adoptium distribution of the Java Development Kit (JDK) by following the [Installation section](../java-project-cli/#111-installation) of [Setting up a Java project using the command line](../java-project-cli) and selecting that JDK.
 
 ## License
diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index a44ebd9..e67dd94 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -6,7 +6,7 @@
 
 With this part of the [Java challenges](..) project, I provide the code and settings for a Java project set up using Maven and IntelliJ IDEA.
 
-Below, I give detailed [background information](#1-background) on the project's [code](#11-java), [IntelliJ IDEA's configuration](#12-intellij-idea) and the used [Maven configuration](#13-maven).
+Below, I give detailed [background information](#1-background) on the project’s [code](#11-java), [IntelliJ IDEA’s configuration](#12-intellij-idea) and the used [Maven configuration](#13-maven).
 I also describe several [issues](#2-issues-and-solutions) that can occur when setting up a Maven project, for which I provide possible solutions.
 
 This project builds on [Setting up a Java project using IntelliJ IDEA](../java-project-intellij).
@@ -139,7 +139,7 @@ When executing Maven goals, the following error may occur:
 [ERROR] The goal you specified requires a project to execute but there is no POM in this directory ... Please verify you invoked Maven from the correct directory.
 ```
 
-To solve this problem, ensure the project's top-level directory contains a project object model file called `pom.xml` and that Maven is run in this directory.
+To solve this problem, ensure the project’s top-level directory contains a project object model file called `pom.xml` and that Maven is run in this directory.
 
 #### 2.1.2 Non-readable POM: input contained no data
 

From 36ec9794743e0ec43c073be6a1a33ed523e64363 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 16:34:32 +0100
Subject: [PATCH 84/89] Clarify configuration

---
 java/executable-jar-maven-intellij/README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/java/executable-jar-maven-intellij/README.md b/java/executable-jar-maven-intellij/README.md
index 979e7c9..45bddea 100644
--- a/java/executable-jar-maven-intellij/README.md
+++ b/java/executable-jar-maven-intellij/README.md
@@ -76,7 +76,7 @@ To ensure that the JAR created by Maven is executable, the project object model
 </project>
 ```
 
-Here, the latest version of the [Maven JAR plugin](https://maven.apache.org/plugins/maven-jar-plugin/) (3.3.0 at the time of writing) is selected, and the main class is defined as follows:
+Here, the latest version of the [Maven JAR plugin](https://maven.apache.org/plugins/maven-jar-plugin/) (3.3.0 at the time of writing) is selected, and the main class is configured to be:
 
 ```text
 nl.mauritssilvis.challenges.java.intellij.maven.jars.executable.standalone.Main
@@ -234,7 +234,7 @@ For the current project, the configuration of the Maven JAR plugin that is part
 </project>
 ```
 
-Here, the latest version of the [Maven JAR plugin](https://maven.apache.org/plugins/maven-jar-plugin/) (3.3.0 at the time of writing) is selected, and the main class is defined as follows:
+Here, the latest version of the [Maven JAR plugin](https://maven.apache.org/plugins/maven-jar-plugin/) (3.3.0 at the time of writing) is selected, and the main class is configured to be:
 
 ```text
 nl.mauritssilvis.challenges.java.intellij.maven.jars.executable.standalone.Main

From 8b89dae02f97a5a160babb543c02754a2e75c527 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 16:59:42 +0100
Subject: [PATCH 85/89] Polish documentation

---
 java/README.md                             |  2 +-
 java/java-project-cli/README.md            | 18 +++++++++---------
 java/java-project-maven-intellij/README.md |  8 ++++----
 3 files changed, 14 insertions(+), 14 deletions(-)

diff --git a/java/README.md b/java/README.md
index f3657b8..6adb12d 100644
--- a/java/README.md
+++ b/java/README.md
@@ -76,7 +76,7 @@ In this file, the project properties can be set, build plugins can be configured
 
 The basic Maven configuration used in the above-mentioned projects is discussed in the [Maven section](java-project-maven-intellij/#13-maven) of [Setting up a Java project using Maven and IntelliJ IDEA](java-project-maven-intellij).
 A step-by-step guide for setting up a Maven project using IntelliJ IDEA can be found in the [Maven section](https://www.jetbrains.com/help/idea/maven-support.html) of IntelliJ IDEA’s [online documentation](https://www.jetbrains.com/help/idea/).
-Maven does not need to be installed separately when used with IntelliJ IDEA.
+Maven does not need to be installed when used with IntelliJ IDEA.
 
 ## License
 
diff --git a/java/java-project-cli/README.md b/java/java-project-cli/README.md
index 4f3765b..d89704f 100644
--- a/java/java-project-cli/README.md
+++ b/java/java-project-cli/README.md
@@ -99,7 +99,7 @@ cd src/nl/mauritssilvis/challenges/java/cli/manual/projects/basic
 javac Main.java
 ```
 
-These commands will compile the Java code of `Main.java` into bytecode, which is then stored in the class file `Main.class` in the directory where the source code is located.
+These commands compile the Java code of `Main.java` into bytecode, which is then stored in the class file `Main.class` in the directory where the source code is located.
 
 As we will see, the class file, `Main.class`, cannot be executed from the folder in which it is stored.
 Moreover, Java source and class files are generally stored in different locations.
@@ -120,7 +120,7 @@ cd out
 java nl/mauritssilvis/challenges/java/cli/manual/projects/basic/Main
 ```
 
-As is explained below, the `.class` extension of the class file should not be included.
+As explained below, the `.class` extension of the class file should not be included.
 
 Equivalently, one could execute the following commands:
 
@@ -136,13 +136,13 @@ For the current project, the following command involving the `-cp` option execut
 java -cp out nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main
 ```
 
-All above commands will result in the following output:
+All the above commands result in the following output:
 
 ```text
 Hello world!
 ```
 
-Note that Java executes classes by their class name, not by their file name.
+Note that Java executes classes by their class name, not their file name.
 Therefore, the above commands should not include the `.class` extension of the Java class file name `Main.class`.
 
 Moreover, for classes that are part of a package, the supplied class name should be the so-called fully qualified name, which includes both the package and the class name.
@@ -162,7 +162,7 @@ In particular, this class file cannot be executed from its containing parent fol
 
 #### 1.1.6 Direct execution
 
-Since Java 11, programs consisting of only a single source file can be executed directly, without the need for an explicit compilation step.
+Since Java 11, programs consisting of only a single source file can be executed directly without an explicit compilation step.
 For the current project, the following command directly executes the source file `Main.java` from its containing folder:
 
 ```shell
@@ -210,7 +210,7 @@ script file, or operable program.
 
 These errors indicate Java was not installed or the Java installation was not found.
 
-To solve these problems, install the JDK, for example, according to the [installation instructions](#111-installation) given above.
+To solve these problems, install the JDK, for example, according to the [installation instructions](#111-installation).
 In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 #### 2.1.2 The Java version does not match
@@ -224,7 +224,7 @@ OpenJDK Runtime Environment Temurin-20.0.2+9 (build 20.0.2+9)
 OpenJDK 64-Bit Server VM Temurin-20.0.2+9 (build 20.0.2+9, mixed mode, sharing)
 ```
 
-To solve this problem, install the desired JDK, for example, according to the [installation instructions](#111-installation) given above.
+To solve this problem, install the desired JDK, for example, according to the [installation instructions](#111-installation).
 In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 ### 2.2 Compilation issues
@@ -238,7 +238,7 @@ cd src
 javac nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main.java
 ```
 
-Such commands will, however, result in an error of the form:
+Such commands, however, result in an error of the form:
 
 ```text
 error: file not found: nl.mauritssilvis.challenges.java.cli.manual.projects.basic.Main.java
@@ -422,7 +422,7 @@ Error: LinkageError occurred while loading main class nl.mauritssilvis.challenge
         class file versions up to ...
 ```
 
-To solve this problem, install the latest JDK, for example, according to the [installation instructions](#111-installation) given above.
+To solve this problem, install the latest JDK, for example, according to the [installation instructions](#111-installation).
 In the process, ensure the `PATH` environment variable contains a reference to the proper JDK folder.
 
 ## License
diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index e67dd94..49ae85e 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -41,7 +41,7 @@ Additional details regarding the IntelliJ IDEA run configurations of the current
 This project comes with three run configurations.
 This first run configuration is called `Main` and directly executes the `main` method of the `Main` class.
 The other two run configurations, respectively, create a JAR and execute it.
-Note that execution of the JAR will [fail](#24-maven-jar-plugin-issues).
+Note that execution of the JAR [fails](#24-maven-jar-plugin-issues).
 
 ### 1.3 Maven
 
@@ -108,7 +108,7 @@ The project can be built using the following command:
 mvn clean package
 ```
 
-Execution of this command will clean the build folder, compile the above-mentioned Java class file and package it as a JAR file.
+Execution of this command cleans the build folder, compiles the above-mentioned Java class file and packages it as a JAR file.
 
 Alternatively, execute the following command:
 
@@ -116,8 +116,8 @@ Alternatively, execute the following command:
 mvn clean install
 ```
 
-In addition to the previous command, this command will make the JAR available in your local Maven repository.
-Note that the JAR will [not be executable](#24-maven-jar-plugin-issues).
+In addition to the previous command, this command makes the JAR available in your local Maven repository.
+Note that the JAR is [not executable](#24-maven-jar-plugin-issues).
 
 ## 2. Issues and solutions
 

From f48cbefe252480fd5e23b9500592a249685fb183 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 17:12:39 +0100
Subject: [PATCH 86/89] Remove to-do

---
 java/java-project-maven-intellij/README.md | 2 --
 1 file changed, 2 deletions(-)

diff --git a/java/java-project-maven-intellij/README.md b/java/java-project-maven-intellij/README.md
index 49ae85e..74a5535 100644
--- a/java/java-project-maven-intellij/README.md
+++ b/java/java-project-maven-intellij/README.md
@@ -125,8 +125,6 @@ While setting up and building a Maven project, several issues may occur.
 I list several such issues below, including possible solutions.
 Specifically, I discuss problems related to the [project object model](#21-project-object-model-issues), the [Maven resources plugin](#22-maven-resources-plugin-issues), the [Maven compiler plugin](#23-maven-compiler-plugin-issues) and the [Maven JAR plugin](#24-maven-jar-plugin-issues).
 
-<!-- TODO: Describe what happens when the required Java version is not installed. -->
-
 ### 2.1 Project object model issues
 
 Several issues may arise concerning the [project object model](https://maven.apache.org/guides/introduction/introduction-to-the-pom.html).

From f29238e87886e826281c5b566b060d147a290646 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 17:13:14 +0100
Subject: [PATCH 87/89] Document changes

---
 CHANGELOG.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index b0aaa2c..baabbef 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,10 +9,11 @@ and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
-- Improve and extend the general project documentation.
-- Improve and extend the documentation of the command-line Java project.
-- Improve and extend the documentation of the IntelliJ Java project.
-- Improve and extend the documentation of the Maven Java project.
+- Extend and improve the general documentation.
+- Extend and improve the documentation of the command-line Java project.
+- Extend and improve the documentation of the IntelliJ Java project.
+- Extend and improve the documentation of the Maven Java project.
+- Improve the documentation of the executable JAR project.
 - Update the Java version from 20 to 21.
 
 ## [0.3.1] - 2023-09-16

From e6e3c1cc2928d0b97e297ede484c5f47913e561f Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 17:25:54 +0100
Subject: [PATCH 88/89] Reorder entries

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index baabbef..298a54c 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -9,12 +9,12 @@ and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0
 
 ### Changed
 
+- Update the Java version from 20 to 21.
 - Extend and improve the general documentation.
 - Extend and improve the documentation of the command-line Java project.
 - Extend and improve the documentation of the IntelliJ Java project.
 - Extend and improve the documentation of the Maven Java project.
 - Improve the documentation of the executable JAR project.
-- Update the Java version from 20 to 21.
 
 ## [0.3.1] - 2023-09-16
 

From 25dd4248cc91995a8653b7adb8e7c75d065215f0 Mon Sep 17 00:00:00 2001
From: Maurits Silvis <mauritssilvis@gmail.com>
Date: Fri, 1 Dec 2023 17:26:21 +0100
Subject: [PATCH 89/89] Set the latest release version

---
 CHANGELOG.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 298a54c..059b9c3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -5,7 +5,7 @@ All notable changes to the [Challenges](https://github.com/mauritssilvis/challen
 The file format is based on [keep a changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [semantic versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.4.0] - 2023-12-01
 
 ### Changed