Merge pull request #3129 from jatcwang/doc-list-jvm

Doc: Tips on how to list available JVMs using coursier

Author: tgodzik

modules/cli/src/main/scala/scala/cli/commands/shared/SharedJvmOptions.scala

@@ -18,7 +18,8 @@ final case class SharedJvmOptions(
     javaHome: Option[String] = None,
 
   @Group(HelpGroup.Java.toString)
-  @HelpMessage("Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`")
+  @HelpMessage("Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. " +
+  "scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.")
   @ValueDescription("jvm-name")
   @Tag(tags.should)
   @Name("j")

modules/directives/src/main/scala/scala/build/preprocessing/directives/Jvm.scala

@@ -14,7 +14,10 @@ import scala.cli.commands.SpecificationLevel
   "//> using jvm _value_",
   "`//> using jvm` _value_"
 )
-@DirectiveDescription("Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`")
+@DirectiveDescription(
+  "Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. " +
+    "scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs."
+)
 @DirectiveLevel(SpecificationLevel.SHOULD)
 // format: off
 final case class Jvm(

website/docs/reference/cli-options.md

@@ -639,7 +639,7 @@ Set the Java home directory
 
 Aliases: `-j`
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 ### `--jvm-index`
 

website/docs/reference/directives.md

@@ -127,7 +127,7 @@ Exclude sources from the project
 
 ### JVM version
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 `//> using jvm` _value_
 

website/docs/reference/scala-command/cli-options.md

@@ -570,7 +570,7 @@ Aliases: `-j`
 
 `SHOULD have` per Scala Runner specification
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 ### `--jvm-index`
 

website/docs/reference/scala-command/directives.md

@@ -151,7 +151,7 @@ Exclude sources from the project
 
 ### JVM version
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 `//> using jvm` _value_
 

website/docs/reference/scala-command/runner-specification.md

@@ -238,7 +238,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -706,7 +706,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -1019,7 +1019,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -1602,7 +1602,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -2217,7 +2217,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -2845,7 +2845,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -3449,7 +3449,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -4090,7 +4090,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -4782,7 +4782,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`
 
@@ -5715,7 +5715,7 @@ Set the Java home directory
 
 **--jvm**
 
-Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`
+Use a specific JVM, such as `14`, `adopt:11`, or `graalvm:21`, or `system`. scala-cli uses [coursier](https://get-coursier.io/) to fetch JVMs, so you can use `cs java --available` to list the available JVMs.
 
 Aliases: `-j`