From dfee85208c938462651eca5bd04fd034a33ef2c7 Mon Sep 17 00:00:00 2001
From: Riccardo Strina <riccardo.strina@icloud.com>
Date: Mon, 11 May 2026 23:14:20 +0200
Subject: [PATCH 1/2] Add Java runtime Gradle and Maven configuration guidance

- Document Gradle behavior with JDKs lower than 17
- Add instructions for configuring Maven
  settings.xml to resolve dependencies from custom or internal
  repositories.
---
 README.md | 38 +++++++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index c524b9a..0ed2ddd 100644
--- a/README.md
+++ b/README.md
@@ -221,6 +221,30 @@ JDTLS will automatically pick the appropriate runtime based on your project's so
 >
 > **Windows paths** typically look like `C:\Program Files\Java\jdk-17`
 
+> **Important:** If your default runtime is below Java 17 and you're working with Gradle projects, the Gradle daemon will fail to start because modern Gradle requires JVM 17+. In this case, set `java.import.gradle.java.home` to a JDK 17+ path so that the Gradle daemon uses a compatible JVM independently of your project's compilation runtime. See the [Advanced Configuration](#advanced-configurationjdtls-initialization-options) section below for details.
+
+## Maven Configuration
+
+If your project uses custom or internal Maven repositories, you should point JDTLS at your Maven `settings.xml` so it can resolve dependencies:
+
+```jsonc
+"initialization_options": {
+  "settings": {
+    "java": {
+      "configuration": {
+        "maven": {
+          "userSettings": "~/.m2/settings.xml",
+          // Optional: global settings for system-wide configuration
+          "globalSettings": "/path/to/global/settings.xml"
+        }
+      }
+    }
+  }
+}
+```
+
+Without this, JDTLS's embedded Maven will only resolve artifacts from Maven Central, which will cause unresolved dependency errors for projects using internal or private repositories.
+
 ## Advanced Configuration/JDTLS initialization Options
 
 JDTLS provides many configuration options that can be passed via the `initialize` LSP-request. The extension will pass the JSON-object from `lsp.jdtls.initialization_options` in your settings on to JDTLS. Please refer to the [JDTLS Configuration Wiki Page](https://github.com/eclipse-jdtls/eclipse.jdt.ls/wiki/Running-the-JAVA-LS-server-from-the-command-line#initialize-request) for the available options and values.
@@ -244,7 +268,11 @@ Below is an opinionated example configuration for JDTLS with most options enable
         "java": {
           "configuration": {
             "updateBuildConfiguration": "automatic",
-            "runtimes": []
+            "runtimes": [],
+            // Path to your Maven settings.xml (for custom/internal repositories)
+            "maven": {
+              "userSettings": "~/.m2/settings.xml"
+            }
           },
           "saveActions": {
             "organizeImports": true
@@ -308,6 +336,14 @@ Below is an opinionated example configuration for JDTLS with most options enable
               "enabled": true,
               "wrapper": {
                 "enabled": true
+              },
+              // JVM used by the Gradle daemon (must be JVM 17+ for modern Gradle).
+              // Set this if your default runtime is a lower version.
+              "java": {
+                "home": "/path/to/your/JDK17+"
+              },
+              "annotationProcessing": {
+                "enabled": true
               }
             },
             "maven": {

From 448dfcb259e7981cd844418f27f4c601cc1da8a3 Mon Sep 17 00:00:00 2001
From: Riccardo Strina <riccardo.strina@icloud.com>
Date: Tue, 12 May 2026 22:26:42 +0200
Subject: [PATCH 2/2] Add documentation comments to JDTLS config options

Add inline comments explaining each language support and compiler option
in the example JDTLS configuration, including Kotlin, Scala, AspectJ,
Android, and javac support.
---
 README.md | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/README.md b/README.md
index 0ed2ddd..259e3d4 100644
--- a/README.md
+++ b/README.md
@@ -288,11 +288,34 @@ Below is an opinionated example configuration for JDTLS with most options enable
           },
           "jdt": {
             "ls": {
+              // Enables Protocol Buffer support for .proto files in the project
               "protobufSupport": {
                 "enabled": true
               },
+              // Enables Groovy support for mixed Java/Groovy projects
               "groovySupport": {
                 "enabled": true
+              },
+              // Enables Kotlin support so JDTLS can resolve Kotlin classes from Java code
+              // in mixed Kotlin/Java projects
+              "kotlinSupport": {
+                "enabled": true
+              },
+              // Enables Scala support for mixed Java/Scala projects
+              "scalaSupport": {
+                "enabled": true
+              },
+              // Enables AspectJ support for projects using aspect-oriented programming
+              "aspectjSupport": {
+                "enabled": true
+              },
+              // Enables Android project support
+              "androidSupport": {
+                "enabled": true
+              },
+              // Enables the javac-based compilation engine instead of the ECJ compiler
+              "javac": {
+                "enabled": true
               }
             }
           },