There are two ways to generate API documentation in HTML from your Scala code. Those options are:
- use sbt to do it,
- use the scaladoc command-line tool.
Using sbt
The easiest and most commonly used way to generate API documentation from your Scala code is with the build tool sbt.
In the sbt shell, generate Scaladoc by running doc
:
> doc
[info] Main Scala API documentation to target/scala-2.12/api...
[info] model contains 1 documentable templates
[info] Main Scala API documentation successful.
[success] Total time: 20 s
The HTML documentation will show up in the respective target/
directory (or directories for builds with multiple projects) that sbt prints to the console output.
For more information on using sbt on your system, see the download instructions for getting started with Scala and sbt on the command line.
For additional information about configuring Scaladoc in sbt, see the Generate API documentation section of the sbt reference manual.
Using scaladoc command
If you use Scala commands directly to start a console with scala
or compile with scalac
, then you should have a scaladoc
command-line utility, as well. This is a more advanced and less commonly used method of generating Scaladoc.
$ scaladoc src/main/scala/App.scala
model contains 1 documentable templates
This will put the HTML in the current directory. This is probably not what you want. It’s preferable to output to a subdirectory. To specify a different target directory, use the -d
command-line option:
$ scaladoc -d build/ src/main/scala/App.scala
For more information on the scaladoc
command and what other command-line options it supports, see the scaladoc --help
.
This command is harder to operate with more complex projects containing both multiple Scala source files and library dependencies. This is why using sbt (see above) is easier and better suited for generating Scaladoc.
The Scaladoc command exists because it preceded the development of sbt, but also because it is useful to the Scala development team with studying bug reports for Scaladoc.
More information on directly using the Scala commands, like scaladoc
, is discussed at your first lines of Scala.