Fix formatting in directives' reference docs (#3611)

Author: Gedochao

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

@@ -26,15 +26,19 @@ import scala.util.{Failure, Success, Try}
 @DirectiveUsage(
   "`//> using jar `_path_ | `//> using jars `_path1_ _path2_ …",
   """`//> using jar` _path_
+    |
     |`//> using jars` _path1_ _path2_ …
     |
     |`//> using test.jar` _path_
+    |
     |`//> using test.jars` _path1_ _path2_ …
     |
     |`//> using source.jar` _path_
+    |
     |`//> using source.jars` _path1_ _path2_ …
     |
     |`//> using test.source.jar` _path_
+    |
     |`//> using test.source.jars` _path1_ _path2_ …
     |""".stripMargin
 )

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

@@ -33,19 +33,27 @@ import scala.cli.commands.SpecificationLevel
 @DirectiveUsage(
   "//> using dep org:name:ver | //> using deps org:name:ver org2:name2:ver2",
   """`//> using dep` _org_`:`name`:`ver
+    |
     |`//> using deps` _org_`:`name`:`ver _org_`:`name`:`ver
+    |
     |`//> using dependencies` _org_`:`name`:`ver _org_`:`name`:`ver
     |
     |`//> using test.dep` _org_`:`name`:`ver
+    |
     |`//> using test.deps` _org_`:`name`:`ver _org_`:`name`:`ver
+    |
     |`//> using test.dependencies` _org_`:`name`:`ver _org_`:`name`:`ver
     |
     |`//> using compileOnly.dep` _org_`:`name`:`ver
+    |
     |`//> using compileOnly.deps` _org_`:`name`:`ver _org_`:`name`:`ver
+    |
     |`//> using compileOnly.dependencies` _org_`:`name`:`ver _org_`:`name`:`ver
     |
     |`//> using scalafix.dep` _org_`:`name`:`ver
+    |
     |`//> using scalafix.deps` _org_`:`name`:`ver _org_`:`name`:`ver
+    |
     |`//> using scalafix.dependencies` _org_`:`name`:`ver _org_`:`name`:`ver
     |""".stripMargin
 )

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

@@ -14,9 +14,11 @@ import scala.cli.commands.SpecificationLevel
 @DirectiveUsage(
   "//> using javaProp _key=val_",
   """`//> using javaProp` _key=value_
+    |
     |`//> using javaProp` _key_
     |
     |`//> using test.javaProp` _key=value_
+    |
     |`//> using test.javaProp` _key_
     |""".stripMargin
 )

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

@@ -13,9 +13,11 @@ import scala.cli.commands.SpecificationLevel
 @DirectiveUsage(
   "//> using javacOpt _options_",
   """`//> using javacOpt` _options_
+    |
     |`//> using javacOptions` _options_
     |
     |`//> using test.javacOpt` _options_
+    |
     |`//> using test.javacOptions` _options_
     |""".stripMargin
 )

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

@@ -25,6 +25,7 @@ import scala.cli.commands.SpecificationLevel
 @DirectiveUsage(
   "//> using platform (jvm|scala-js|js|scala-native|native)+",
   """`//> using platform` (`jvm`|`scala-js`|`js`|`scala-native`|`native`)+
+    |
     |`//> using platforms` (`jvm`|`scala-js`|`js`|`scala-native`|`native`)+
     |""".stripMargin
 )

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

@@ -43,12 +43,15 @@ import scala.cli.commands.SpecificationLevel
     |`//> using publish.license` value
     |
     |`//> using publish.vcs` value
+    |
     |`//> using publish.scm` value
+    |
     |`//> using publish.versionControl` value
     |
     |`//> using publish.description` value
     |
     |`//> using publish.developer` value
+    |
     |`//> using publish.developers` value1 value2
     |
     |`//> using publish.scalaVersionSuffix` value

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

@@ -15,9 +15,11 @@ import scala.cli.commands.SpecificationLevel
     |
     |//> using resourceDirs _path1_ _path2_ …""".stripMargin,
   """`//> using resourceDir` _path_
+    |
     |`//> using resourceDirs` _path1_ _path2_ …
     |
     |`//> using test.resourceDir` _path_
+    |
     |`//> using test.resourceDirs` _path1_ _path2_ …
     |
     |""".stripMargin

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

@@ -37,39 +37,47 @@ import scala.util.Try
     |`//> using jsMode` _value_
     |
     |`//> using jsNoOpt` _true|false_
+    |
     |`//> using jsNoOpt`
     |
     |`//> using jsModuleKind` _value_
     |
     |`//> using jsCheckIr` _true|false_
+    |
     |`//> using jsCheckIr`
     |
     |`//> using jsEmitSourceMaps` _true|false_
+    |
     |`//> using jsEmitSourceMaps`
     |
     |`//> using jsEsModuleImportMap` _value_
     |
     |`//> using jsSmallModuleForPackage` _value1_ _value2_ …
     |
     |`//> using jsDom` _true|false_
+    |
     |`//> using jsDom`
     |
     |`//> using jsHeader` _value_
     |
     |`//> using jsAllowBigIntsForLongs` _true|false_
+    |
     |`//> using jsAllowBigIntsForLongs`
     |
     |`//> using jsAvoidClasses` _true|false_
+    |
     |`//> using jsAvoidClasses`
     |
     |`//> using jsAvoidLetsAndConsts` _true|false_
+    |
     |`//> using jsAvoidLetsAndConsts`
     |
     |`//> using jsModuleSplitStyleStr` _value_
     |
     |`//> using jsEsVersionStr` _value_
     |    
     |`//> using jsEmitWasm` _true|false_
+    |
     |`//> using jsEmitWasm`
     |""".stripMargin
 )

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

@@ -38,14 +38,17 @@ import scala.cli.commands.SpecificationLevel
     |`//> using nativeClang` _value_
     |
     |`//> using nativeClangPP` _value_
+    |
     |`//> using nativeClangPp` _value_
     |
     |`//> using nativeEmbedResources` _true|false_
+    |
     |`//> using nativeEmbedResources`
     |
     |`//> using nativeTarget` _application|library-dynamic|library-static_
     |
     |`//> using nativeMultithreading` _true|false_
+    |
     |`//> using nativeMultithreading`
     """.stripMargin.trim
 )

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

@@ -22,13 +22,19 @@ import scala.cli.commands.SpecificationLevel
 @DirectiveUsage(
   "using option _option_ | using options _option1_ _option2_ …",
   """`//> 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_ …
     |
     |""".stripMargin