From 38e9fbf11a8d9815ccc095eb4448b78d151900eb Mon Sep 17 00:00:00 2001
From: John Freeman <john.freeman.opensource@gmail.com>
Date: Sun, 21 Aug 2022 09:45:50 +0100
Subject: [PATCH] Added documentation for Java 17

For dealing with illegal access error.
---
 .github/workflows/maven-build.yml |  1 +
 .mvn/jvm.config                   |  1 +
 README.md                         | 16 ++++++++++++++++
 src/it/check/.mvn/jvm.config      |  1 +
 src/it/checkstyle/.mvn/jvm.config |  1 +
 src/it/format/.mvn/jvm.config     |  1 +
 src/it/report/.mvn/jvm.config     |  1 +
 7 files changed, 22 insertions(+)
 create mode 100644 .mvn/jvm.config
 create mode 100644 src/it/check/.mvn/jvm.config
 create mode 100644 src/it/checkstyle/.mvn/jvm.config
 create mode 100644 src/it/format/.mvn/jvm.config
 create mode 100644 src/it/report/.mvn/jvm.config

diff --git a/.github/workflows/maven-build.yml b/.github/workflows/maven-build.yml
index abcec091..9933e1a7 100644
--- a/.github/workflows/maven-build.yml
+++ b/.github/workflows/maven-build.yml
@@ -5,6 +5,7 @@ env:
   JAVA_TOOL_OPTIONS: >-
     -XX:TieredStopAtLevel=1
     -XX:+UseParallelGC
+    --illegal-access=deny
 
 jobs:
   build:
diff --git a/.mvn/jvm.config b/.mvn/jvm.config
new file mode 100644
index 00000000..c155c15e
--- /dev/null
+++ b/.mvn/jvm.config
@@ -0,0 +1 @@
+--add-opens java.base/java.lang=ALL-UNNAMED
diff --git a/README.md b/README.md
index c3a73ab0..6c1c3814 100644
--- a/README.md
+++ b/README.md
@@ -9,6 +9,22 @@ This plugin provides the ability to use
 [ktlint](https://github.com/pinterest/ktlint) to format and check your source
 code against the ktlint anti-bikeshedding code style.
 
+## Using Java 17 and later
+
+Java 17 is the first LTS release to enforce strong encapsulation. For `ktlint`
+to work we need to add `--add-opens java.base/java.lang=ALL-UNNAMED` to the JVM
+arguments.
+
+I recommend you add this to the `.mvn/jvm.config` in the root of any project
+using this plugin.
+
+```
+--add-opens java.base/java.lang=ALL-UNNAMED
+```
+
+I also recommend adding this to any project using this plugin and building with
+Java 11, as it'll suppress an illegal-access warning during the build.
+
 ## Goals Overview
 
   * [ktlint:format](http://gantsign.com/ktlint-maven-plugin/format-mojo.html)
diff --git a/src/it/check/.mvn/jvm.config b/src/it/check/.mvn/jvm.config
new file mode 100644
index 00000000..c155c15e
--- /dev/null
+++ b/src/it/check/.mvn/jvm.config
@@ -0,0 +1 @@
+--add-opens java.base/java.lang=ALL-UNNAMED
diff --git a/src/it/checkstyle/.mvn/jvm.config b/src/it/checkstyle/.mvn/jvm.config
new file mode 100644
index 00000000..c155c15e
--- /dev/null
+++ b/src/it/checkstyle/.mvn/jvm.config
@@ -0,0 +1 @@
+--add-opens java.base/java.lang=ALL-UNNAMED
diff --git a/src/it/format/.mvn/jvm.config b/src/it/format/.mvn/jvm.config
new file mode 100644
index 00000000..c155c15e
--- /dev/null
+++ b/src/it/format/.mvn/jvm.config
@@ -0,0 +1 @@
+--add-opens java.base/java.lang=ALL-UNNAMED
diff --git a/src/it/report/.mvn/jvm.config b/src/it/report/.mvn/jvm.config
new file mode 100644
index 00000000..c155c15e
--- /dev/null
+++ b/src/it/report/.mvn/jvm.config
@@ -0,0 +1 @@
+--add-opens java.base/java.lang=ALL-UNNAMED