From 42bc4d1b28fe421949b95c57223ff4a7479c08cd Mon Sep 17 00:00:00 2001 From: Tobias Roeser Date: Thu, 25 Apr 2019 14:58:20 +0200 Subject: Fixed location of bloop module docs, again --- docs/pages/9 - Contrib Modules.md | 115 +++++++++++++++++++------------------- 1 file changed, 58 insertions(+), 57 deletions(-) (limited to 'docs') diff --git a/docs/pages/9 - Contrib Modules.md b/docs/pages/9 - Contrib Modules.md index be14103e..2f9085db 100644 --- a/docs/pages/9 - Contrib Modules.md +++ b/docs/pages/9 - Contrib Modules.md @@ -4,6 +4,64 @@ The plugins in this section are developed/maintained in the mill git tree. [comment]: # (Please keep list of plugins in alphabetical order) +### Bloop + +This plugin generates [bloop](https://scalacenter.github.io/bloop/) configuration +from your build file, which lets you use the bloop CLI for compiling, and makes +your scala code editable in [Metals](https://scalameta.org/metals/) + + +#### Quickstart: +```scala +// build.sc (or any other .sc file it depends on, including predef) +// Don't forget to replace VERSION +import $ivy.`com.lihaoyi::mill-contrib-bloop:VERSION` +``` + +Then in your terminal : + +``` +> mill mill.contrib.Bloop/install +``` + +#### Mix-in + +You can mix-in the `Bloop.Module` trait with any JavaModule to quickly access +the deserialised configuration for that particular module: + +```scala +// build.sc +import mill._ +import mill.scalalib._ +import mill.contrib.Bloop + +object MyModule extends ScalaModule with Bloop.Module { + def myTask = T { bloop.config() } +} +``` + +#### Note regarding metals: + +Generating the bloop config should be enough for metals to pick it up and for +features to start working in vscode (or the bunch of other editors metals supports). +However, note that this applies only to your project sources. Your mill/ammonite related +`.sc` files are not yet supported by metals. + +The generated bloop config references the semanticDB compiler plugin required by +metals to function. If need be, the version of semanticDB can be overriden by +extending `mill.contrib.bloop.BloopImpl` in your own space. + +#### Note regarding current mill support in bloop + +The mill-bloop integration currently present in the [bloop codebase](https://github.com/scalacenter/bloop/blob/master/integrations/mill-bloop/src/main/scala/bloop/integrations/mill/MillBloop.scala#L10) +will be deprecated in favour of this implementation. + +#### Caveats: + +At this time, only Java/ScalaModule are processed correctly. ScalaJS/ScalaNative integration will +be added in a near future. + + ### BuildInfo Generate scala code from your buildfile. @@ -677,63 +735,6 @@ If you develop or maintain a mill plugin, please create a [pull request](https:/ [comment]: # (Please keep list of plugins in alphabetical order) -### Bloop - -This plugin generates [bloop](https://scalacenter.github.io/bloop/) configuration -from your build file, which lets you use the bloop CLI for compiling, and makes -your scala code editable in [Metals](https://scalameta.org/metals/) - - -#### Quickstart: -```scala -// build.sc (or any other .sc file it depends on, including predef) -// Don't forget to replace VERSION -import $ivy.`com.lihaoyi::mill-contrib-bloop:VERSION` -``` - -Then in your terminal : - -``` -> mill mill.contrib.Bloop/install -``` - -#### Mix-in - -You can mix-in the `Bloop.Module` trait with any JavaModule to quickly access -the deserialised configuration for that particular module: - -```scala -// build.sc -import mill._ -import mill.scalalib._ -import mill.contrib.Bloop - -object MyModule extends ScalaModule with Bloop.Module { - def myTask = T { bloop.config() } -} -``` - -#### Note regarding metals: - -Generating the bloop config should be enough for metals to pick it up and for -features to start working in vscode (or the bunch of other editors metals supports). -However, note that this applies only to your project sources. Your mill/ammonite related -`.sc` files are not yet supported by metals. - -The generated bloop config references the semanticDB compiler plugin required by -metals to function. If need be, the version of semanticDB can be overriden by -extending `mill.contrib.bloop.BloopImpl` in your own space. - -#### Note regarding current mill support in bloop - -The mill-bloop integration currently present in the [bloop codebase](https://github.com/scalacenter/bloop/blob/master/integrations/mill-bloop/src/main/scala/bloop/integrations/mill/MillBloop.scala#L10) -will be deprecated in favour of this implementation. - -#### Caveats: - -At this time, only Java/ScalaModule are processed correctly. ScalaJS/ScalaNative integration will -be added in a near future. - ### DGraph -- cgit v1.2.3