Add missing reference docs for *.option directives

Author: Gedochao

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

@@ -16,21 +16,33 @@ import scala.cli.commands.SpecificationLevel
 
 @DirectiveGroupName("Compiler options")
 @DirectiveExamples("//> using option -Xasync")
-@DirectiveExamples("//> using test.option -Xasync")
 @DirectiveExamples("//> using options -Xasync -Xfatal-warnings")
+@DirectiveExamples("//> using test.option -Xasync")
+@DirectiveExamples("//> using test.options -Xasync -Xfatal-warnings")
 @DirectiveUsage(
   "using option _option_ | using options _option1_ _option2_ …",
-  """`//> using option` _option_
+  """`//> using scalacOption` _option_
+    |`//> using option` _option_
+    |`//> using scalacOptions` _option1_ _option2_ …
+    |`//> using options` _option1_ _option2_ …
+    |
+    |`//> using test.scalacOption` _option_
+    |`//> using test.option` _option_
+    |`//> using test.scalacOptions` _option1_ _option2_ …
+    |`//> using test.options` _option1_ _option2_ …
     |
-    |`//> using options` _option1_ _option2_ …""".stripMargin
+    |""".stripMargin
 )
 @DirectiveDescription("Add Scala compiler options")
 @DirectiveLevel(SpecificationLevel.MUST)
 final case class ScalacOptions(
   @DirectiveName("option")
+  @DirectiveName("scalacOption")
+  @DirectiveName("scalacOptions")
   options: List[Positioned[String]] = Nil,
   @DirectiveName("test.option")
   @DirectiveName("test.options")
+  @DirectiveName("test.scalacOption")
   @DirectiveName("test.scalacOptions")
   testOptions: List[Positioned[String]] = Nil
 ) extends HasBuildOptionsWithRequirements {

website/docs/reference/directives.md

@@ -29,16 +29,26 @@ Generate BuildInfo for project
 
 Add Scala compiler options
 
+`//> using scalacOption` _option_
 `//> using option` _option_
-
+`//> using scalacOptions` _option1_ _option2_ …
 `//> using options` _option1_ _option2_ …
 
+`//> using test.scalacOption` _option_
+`//> using test.option` _option_
+`//> using test.scalacOptions` _option1_ _option2_ …
+`//> using test.options` _option1_ _option2_ …
+
+
+
 #### Examples
 `//> using option -Xasync`
 
+`//> using options -Xasync -Xfatal-warnings`
+
 `//> using test.option -Xasync`
 
-`//> using options -Xasync -Xfatal-warnings`
+`//> using test.options -Xasync -Xfatal-warnings`
 
 ### Compiler plugins
 

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

@@ -15,16 +15,26 @@ Documentation is split into sections in the spirit of RFC keywords (`MUST`, `SHO
 
 Add Scala compiler options
 
+`//> using scalacOption` _option_
 `//> using option` _option_
-
+`//> using scalacOptions` _option1_ _option2_ …
 `//> using options` _option1_ _option2_ …
 
+`//> using test.scalacOption` _option_
+`//> using test.option` _option_
+`//> using test.scalacOptions` _option1_ _option2_ …
+`//> using test.options` _option1_ _option2_ …
+
+
+
 #### Examples
 `//> using option -Xasync`
 
+`//> using options -Xasync -Xfatal-warnings`
+
 `//> using test.option -Xasync`
 
-`//> using options -Xasync -Xfatal-warnings`
+`//> using test.options -Xasync -Xfatal-warnings`
 
 ### Compiler plugins