NIT changes

modules/build/src/test/scala/scala/build/tests/TestInputs.scala

@@ -5,6 +5,7 @@ import scala.build.blooprifle.BloopRifleConfig
 import scala.build.{Build, BuildThreads, Directories, Inputs}
 import scala.build.compiler.{BloopCompilerMaker, SimpleScalaCompilerMaker}
 import scala.build.errors.BuildException
+import scala.build.internal.Util
 import scala.build.options.BuildOptions
 import scala.util.control.NonFatal
 import scala.util.Try
@@ -44,7 +45,9 @@ final case class TestInputs(
         forcedWorkspace = forcedWorkspaceOpt.map(_.resolveFrom(tmpDir))
       )
       res match {
-        case Left(err)     => sys.error(err)
+        case Left(err) =>
+          Util.printException(err)
+          sys.error(err.getMessage)
         case Right(inputs) => f(tmpDir, inputs)
       }
     }

modules/directives/src/main/scala/scala/build/errors/WrongSourcePathError.scala

@@ -2,7 +2,8 @@ package scala.build.errors
 
 class WrongSourcePathError(exceptionMessage: String, cause: Throwable)
     extends BuildException(
-      message = s"""The file path argument in the using directives at could not be found!
-                   |$exceptionMessage""".stripMargin,
+      message =
+        s"""The file path argument in the using directives at could not be found!
+           |""".stripMargin + exceptionMessage,
       cause = cause
     )

website/docs/commands/run.md

@@ -66,7 +66,7 @@ swiftly.)
 
 ## Define source files in using directives
 
-You can also add sources files with using directive `//> using file`:
+You can also add source files with the using directive `//> using file`:
 
 ```scala title=Main.scala
 //> using file "Utils.scala" 
@@ -81,22 +81,23 @@ object Utils {
 }
 ```
 
-`scala-cli` compiles and adds to the class path source `Utils.scala`
+`scala-cli` takes into account and compiles `Utils.scala`.
 
 ```bash
 scala-cli Main.scala
+# Hello World
 ```
 
 <!-- Expected:
 Hello World
 -->
 
-It is also possible to pass multiple paths to source files in one using directive:
+It is also possible to pass multiple paths to source files in a single using directive:
  ```
  //> using files "Utils.scala" "Helper.scala"
  ```
 
- Note that `//> using file` using directive supports only `Java`, `Scala`, `ScalaScripts` files or directory. 
+ Note that the `//> using file` using directive only supports `.java`, `.scala`, `.sc` files or a directory. 
 
 ## Watch mode
 

website/docs/guides/scripts.md

@@ -163,6 +163,32 @@ world
 
 </ChainedSnippets>
 
+### Define source files in using directives
+
+You can also add source files with the using directive `//> using file` in Scala scripts:
+
+```scala title=main.sc
+//> using file "Utils.scala" 
+
+println(Utils.message)
+```
+```scala title=Utils.scala
+object Utils {
+  val message = "Hello World"
+}
+```
+
+`scala-cli` takes into account and compiles `Utils.scala`.
+
+```bash
+scala-cli main.sc
+# Hello World
+```
+
+<!-- Expected:
+Hello World
+-->
+
 ### Difference with Ammonite scripts
 
 [Ammonite](http://ammonite.io) is a popular REPL for Scala that can also compile and run `.sc` files.