Issue #314; port sbt-updates to mill (#340)

* Implement basic dependency resolution

* Implement basic dependency versions resolution (Maven only)

* refactor dependency updates code

* add resolution of updated dependencies

* remove dependency on locally-built coursier

* dependency updates output formatting

* Add 'allowPreRelease' option

* start adding tests

* Add more tests

* Add documentation

* Cleanup code

* rewrite version parser to use fastparse

1 files changed, 23 insertions, 0 deletions

diff --git a/docs/pages/1 - Intro to Mill.md b/docs/pages/1 - Intro to Mill.md
index bbed0ed7..439e80e5 100644
--- a/docs/pages/1 - Intro to Mill.md
+++ b/docs/pages/1 - Intro to Mill.md
@@ -566,6 +566,29 @@ mill clean _.compile
 mill clean __.compile
 ```
 
+### Search for dependency updates
+
+```bash
+$ mill mill.scalalib.Dependency/updates
+```
+
+Mill can search for updated versions of your project's dependencies,
+if available from your project's configured repositories. Note that it
+uses heuristics based on common versionning schemes, so it may not work
+as expected for dependencies with particularly weird version numbers.
+
+Current limitations:
+- Only works for `JavaModule`s (including `ScalaModule`s,
+`CrossScalaModule`s, etc.) and Maven repositories.
+- Always applies to all modules in the build.
+- Doesn't apply to `$ivy` dependencies used in the build definition
+itself.
+
+```bash
+mill mill.scalalib.Dependency/updates
+mill mill.scalalib.Dependency/updates --allowPreRelease true # also show pre-release versions
+```
+
 ## IntelliJ Support
 
 Mill supports IntelliJ by default. Use `mill mill.scalalib.GenIdea/idea` to