hboutemy commented on a change in pull request #236:
URL: https://github.com/apache/maven-site/pull/236#discussion_r624362868
##########
File path: content/apt/guides/mini/guide-multiple-modules.apt
##########
@@ -59,25 +75,117 @@ Guide to Working with Multiple Modules
Note that only "instantiated" references are used -
<<<dependencyManagement>>> and <<<pluginManagement>>> elements do not cause a
change to the reactor sort order.
-** Command Line Options
+** Selecting Modules
- No special configuration is required to take advantage of the reactor,
however it is possible to customize its behavior.
+ By default, Maven will build all modules it has collected. However, you can
select a subset of these modules to build using command line flags.
+ Those flags come in three categories:
- The following command line switches are available:
+ * Inclusion and exclusion
+
+ * Relationships between modules
+
+ * Dealing with failures
+
+ This section ends with how those flags relate to each other.
+
+*** Inclusion and exclusion
+
+ Using <<<--projects>>> you can specify which modules you want to build.
+ You can do this by specifying a comma-delimited list of project selectors.
+ A project selector is a string that is composed of the
<<<groupId:artifactId>>>, only <<<:artifactId>>> or the relative path to a
module.
+
+ A module can be selected (default), or excluded from the build. You exclude
a module by prefixing the selector with a <<<!>>> or <<<->>>. To explicitly
select a module, prefix it with a <<<+>>>.
+
+ When a selector does not resolve to an existing module, Maven will fail the
build. You can prevent this by adding the <<<?>>> prefix.
+ This prefix should always go after the other prefixes.
- * <<<--resume-from>>> - resumes a reactor from the specified project (e.g.
when it fails in the middle)
+*** Relationships between modules
- * <<<--also-make>>> - build the specified projects, and any of their
dependencies in the reactor
+ Modules inside a project can have two types of relationships: parent/child
and dependency/dependent.
- * <<<--also-make-dependents>>> - build the specified projects, and any
that depend on them
+ When selecting a parent (aggregate), Maven automatically selects the child
modules as well. Similarly, Maven excludes child modules of an excluded parent
(aggregate).
Review comment:
aggregate -> aggregator
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
