-
-
Notifications
You must be signed in to change notification settings - Fork 337
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge branch 'main' into update-semanticdb-java
- Loading branch information
Showing
162 changed files
with
2,378 additions
and
282 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
|
||
// Author Notes: | ||
// | ||
// This is the first page a user is expected to land on when learning about | ||
// Mill. It is designed to be a quick, broad overview to get someone started: | ||
// what is Mill, why should they care, and what some simple Mill builds look | ||
// like and how to use them. We intentionally touch shallowly on a lot of | ||
// topics without giving them a proper discussion, since the other pages have | ||
// plenty of space to go in-depth. | ||
// | ||
// By the end of this page, a prospective Mill user should be familiar with | ||
// what Mill is, hopefully have downloaded an example to try out, and be | ||
// interested in learning more about the Mill build tool | ||
|
||
= Introduction to Mill for Java | ||
|
||
include::partial$Intro_to_Mill_Header.adoc[] | ||
|
||
|
||
== Simple Java Module | ||
|
||
include::example/basicjava/1-simple.adoc[] | ||
|
||
== Custom Build Logic | ||
|
||
include::example/basicjava/2-custom-build-logic.adoc[] | ||
|
||
== Multi-Module Project | ||
|
||
include::example/basicjava/3-multi-module.adoc[] | ||
|
||
|
||
|
||
include::partial$Intro_to_Mill_Footer.adoc[] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
// Author Notes: | ||
// | ||
// This is the first page a user is expected to land on when learning about | ||
// Mill. It is designed to be a quick, broad overview to get someone started: | ||
// what is Mill, why should they care, and what some simple Mill builds look | ||
// like and how to use them. We intentionally touch shallowly on a lot of | ||
// topics without giving them a proper discussion, since the other pages have | ||
// plenty of space to go in-depth. | ||
// | ||
// By the end of this page, a prospective Mill user should be familiar with | ||
// what Mill is, hopefully have downloaded an example to try out, and be | ||
// interested in learning more about the Mill build tool | ||
|
||
= Introduction to Mill for Scala | ||
|
||
:page-aliases: index.adoc | ||
|
||
include::partial$Intro_to_Mill_Header.adoc[] | ||
|
||
|
||
== Simple Scala Module | ||
|
||
include::example/basic/1-simple.adoc[] | ||
|
||
== Custom Build Logic | ||
|
||
include::example/basic/2-custom-build-logic.adoc[] | ||
|
||
== Multi-Module Project | ||
|
||
include::example/basic/3-multi-module.adoc[] | ||
|
||
|
||
include::partial$Intro_to_Mill_Footer.adoc[] |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,73 @@ | ||
= Java Build Examples | ||
|
||
On this page, we will explore the Mill build tool via a series of simple Java | ||
example projects. Each project demonstrates one particular feature of the Mill | ||
build tool, and is also an executable codebase you can download and run. By the | ||
end of this page, you will be familiar with how to configure Mill to work with | ||
realistic Java codebases: cross-building, testing, and publishing them. | ||
|
||
|
||
Many of the APIs covered here are listed in the API documentation: | ||
|
||
* {mill-doc-url}/api/latest/mill/main/RootModule.html[`mill.scalalib.RootModule`] | ||
* {mill-doc-url}/api/latest/mill/scalalib/TestModule$.html[`mill.scalalib.TestModule`] | ||
* {mill-doc-url}/api/latest/mill/scalalib/PublishModule.html[`mill.scalalib.PublishModule`] | ||
* {mill-doc-url}/api/latest/mill/scalalib/CrossScalaModule.html[`mill.scalalib.CrossScalaModule`] | ||
* {mill-doc-url}/api/latest/mill/scalalib/MavenModule.html[`mill.scalalib.MavenModule`] | ||
* {mill-doc-url}/api/latest/mill/scalalib/CrossSbtModule.html[`mill.scalalib.CrossSbtModule`] | ||
* {mill-doc-url}/api/latest/mill/scalalib/JavaModule.html[`mill.scalalib.JavaModule`] | ||
== Common Configuration Overrides | ||
|
||
include::example/javabuilds/1-common-config.adoc[] | ||
|
||
== Custom Tasks | ||
|
||
include::example/javabuilds/2-custom-tasks.adoc[] | ||
|
||
== Overriding Tasks | ||
|
||
include::example/javabuilds/3-override-tasks.adoc[] | ||
|
||
== Nesting Modules | ||
|
||
include::example/javabuilds/4-nested-modules.adoc[] | ||
|
||
== Java Module With Test Suite | ||
|
||
include::example/javabuilds/5-test-suite.adoc[] | ||
|
||
== Publish Module | ||
|
||
include::example/javabuilds/6-publish-module.adoc[] | ||
|
||
|
||
== Maven-Compatible Modules | ||
|
||
include::example/javabuilds/8-compat-modules.adoc[] | ||
|
||
|
||
== Realistic Java Example Project | ||
|
||
include::example/javabuilds/9-realistic.adoc[] | ||
|
||
|
||
== Example Builds for Real Projects | ||
|
||
Mill comes bundled with example builds for real-world open-source projects, | ||
demonstrating how Mill can be used to build code outside of tiny example codebases: | ||
|
||
=== JimFS | ||
|
||
include::example/thirdparty/jimfs.adoc[] | ||
|
||
=== Apache Commons IO | ||
|
||
include::example/thirdparty/commons-io.adoc[] | ||
|
||
== Real World Mill Builds | ||
|
||
=== C3P0 | ||
|
||
https://github.com/swaldman/c3p0[C3P0] is a JDBC connection pooling library | ||
written in Java, built using the Mill build tool. |
Oops, something went wrong.