summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorLi Haoyi <haoyi.sg@gmail.com>2018-02-02 21:48:35 -0800
committerLi Haoyi <haoyi.sg@gmail.com>2018-02-02 21:48:35 -0800
commit80c8ad730132145fc33b790657b14669f282d5b0 (patch)
treefa9d39763756cc07a3e9524cf146186cb2979516 /docs
parent27273750636acbbff1b37cf53bba76684f0b96bb (diff)
downloadmill-80c8ad730132145fc33b790657b14669f282d5b0.tar.gz
mill-80c8ad730132145fc33b790657b14669f282d5b0.tar.bz2
mill-80c8ad730132145fc33b790657b14669f282d5b0.zip
- Rename `basePath` -> `millSourcePath`
- Make `T.worker`s not flush out their directories between instantiations
Diffstat (limited to 'docs')
-rw-r--r--docs/cross.md2
-rw-r--r--docs/modules.md28
2 files changed, 15 insertions, 15 deletions
diff --git a/docs/cross.md b/docs/cross.md
index 25ae4a8a..fe14a23e 100644
--- a/docs/cross.md
+++ b/docs/cross.md
@@ -25,7 +25,7 @@ mill --show foo[2.12].suffix
mill --show foo[2.12].bigSuffix
```
-The modules each also have a `basePath` of
+The modules each also have a `millSourcePath` of
```text
foo/2.10
diff --git a/docs/modules.md b/docs/modules.md
index 86f807de..b92ab684 100644
--- a/docs/modules.md
+++ b/docs/modules.md
@@ -76,9 +76,9 @@ You can override targets and commands to customize them or change what they do.
The overriden version is available via `super`. You can omit the `override`
keyword in Mill builds.
-## basePath
+## millSourcePath
-Each Module has a `basePath` field that corresponds to the path that module
+Each Module has a `millSourcePath` field that corresponds to the path that module
expects it's input files to be on disk. Re-visiting our examples above:
```scala
@@ -90,24 +90,24 @@ object foo extends mill.Module{
}
```
-The `foo` module has a `basePath` of `./foo`, while the `foo.baz` module has a
-`basePath` of `./foo/baz`.
+The `foo` module has a `millSourcePath` of `./foo`, while the `foo.baz` module has a
+`millSourcePath` of `./foo/baz`.
-You can use `basePath` to automatically set the source directories of your
+You can use `millSourcePath` to automatically set the source directories of your
modules to match the build structure. You are not forced to rigidly use
-`basePath` to define the source folders of all your code, but it can simplify
+`millSourcePath` to define the source folders of all your code, but it can simplify
the common case where you probably want your build-layout on on-disk-layout to
be the same.
e.g. for `mill.scalalib.ScalaModule`, the Scala source code is assumed by
-default to be in `basePath/"src"` while resources are automatically assumed to
-be in `basePath/"resources"`.
+default to be in `millSourcePath/"src"` while resources are automatically assumed to
+be in `millSourcePath/"resources"`.
-You can override `basePath`:
+You can override `millSourcePath`:
```scala
object foo extends mill.Module{
- def basePath = super.basePath / "lols"
+ def millSourcePath = super.millSourcePath / "lols"
def bar = T{ "hello" }
object baz extends mill.Module{
def qux = T{ "world" }
@@ -116,10 +116,10 @@ object foo extends mill.Module{
```
And any overrides propagate down to the module's children: in the above example,
-module `foo` would have it's `basePath` be `./foo/lols` while module` foo.baz`
-would have it's `basePath` be `./foo/lols/baz`.
+module `foo` would have it's `millSourcePath` be `./foo/lols` while module` foo.baz`
+would have it's `millSourcePath` be `./foo/lols/baz`.
-Note that `basePath` is generally only used for a module's input source files.
+Note that `millSourcePath` is generally only used for a module's input source files.
Output is always in the `out/` folder and cannot be changed, e.g. even with the
-overriden `basePath` the output paths are still the default `./out/foo/bar` and
+overriden `millSourcePath` the output paths are still the default `./out/foo/bar` and
`./out/foo/baz/qux` folders. \ No newline at end of file