CLI: Add documentation for -J argument in kotlinc -help

compiler/cli/src/org/jetbrains/kotlin/cli/common/Usage.java

@@ -53,6 +53,7 @@ public class Usage {
             appendln(sb, "Advanced options are non-standard and may be changed or removed without any notice.");
         }
         else {
+            renderOptionJUsage(sb);
             renderArgfileUsage(sb);
         }
 
@@ -103,6 +104,15 @@ public class Usage {
         appendln(sb, argument.description().replace("\n", "\n" + StringsKt.repeat(" ", OPTION_NAME_PADDING_WIDTH)));
     }
 
+    private static void renderOptionJUsage(@NotNull StringBuilder sb) {
+        int descriptionStart = sb.length() + OPTION_NAME_PADDING_WIDTH;
+        sb.append("  -J<option>");
+        while (sb.length() < descriptionStart) {
+            sb.append(" ");
+        }
+        appendln(sb, "Pass an option directly to JVM");
+    }
+
     private static void renderArgfileUsage(@NotNull StringBuilder sb) {
         int descriptionStart = sb.length() + OPTION_NAME_PADDING_WIDTH;
         sb.append("  ");

compiler/testData/cli/js-dce/dceHelp.out

@@ -10,5 +10,6 @@ where possible options include:
   -nowarn                    Generate no warnings
   -verbose                   Enable verbose logging output
   -version                   Display compiler version
+  -J<option>                 Pass an option directly to JVM
   @<argfile>                 Read compiler arguments and file paths from the given file
 OK

compiler/testData/cli/js/jsHelp.out

@@ -32,6 +32,7 @@ where possible options include:
   -nowarn                    Generate no warnings
   -verbose                   Enable verbose logging output
   -version                   Display compiler version
+  -J<option>                 Pass an option directly to JVM
   @<argfile>                 Read compiler arguments and file paths from the given file
 
 For details, see https://kotl.in/cli

compiler/testData/cli/jvm/help.out

@@ -30,6 +30,7 @@ where possible options include:
   -nowarn                    Generate no warnings
   -verbose                   Enable verbose logging output
   -version                   Display compiler version
+  -J<option>                 Pass an option directly to JVM
   @<argfile>                 Read compiler arguments and file paths from the given file
 
 For details, see https://kotl.in/cli