Usage

Below are the different goals and the minimalist configurations of the Help Plugin.

The help:active-profiles Goal

The active-profiles goal is used to discover which profiles have been applied to the projects currently being built. For each project in the build session, it will output a list of profiles which have been applied to that project, along with the source of the profile (POM, settings.xml or profiles.xml).

You can execute this goal using the following command:

# mvn help:active-profiles

Note: you could also use the output parameter to redirect output to a file.

The help:all-profiles Goal

The all-profiles goal is used to discover all available profiles under the current project.

You can execute this goal using the following command:

# mvn help:all-profiles

Note: you could also use the output parameter to redirect output to a file.

The help:describe Goal

The describe goal is used to discover information about Maven plugins. Given either a plugin or a groupId, an artifactId and optionally a version, the goal will lookup that plugin and output details about it. If the user also specifies which goal to describe, the describe goal will limit output to the details of that goal, including parameters.

You can execute this goal using the following command:

# mvn help:describe -DgroupId=org.somewhere -DartifactId=some-plugin -Dversion=0.0.0

Note: you could also use the output parameter to redirect output to a file.

Refer to Configuring Describe Goal for more information about its configuration.

The help:effective-pom Goal

The effective-pom goal is used to make visible the POM that results from the application of interpolation, inheritance and active profiles. It provides a useful way of removing the guesswork about just what ends up in the POM that Maven uses to build your project. It will iterate over all projects in the current build session, printing the effective POM for each.

You can execute this goal using the following command:

# mvn help:effective-pom

Note: you could also use the output parameter to redirect output to a file.

The help:effective-settings Goal

The effective-settings goal is used to view the settings that Maven actually uses to run the build. These settings are a result of merging the global file with the user's file, with the user's file taking precedence.

You can execute this goal using the following command:

# mvn help:effective-settings

Note: you could also use the output parameter to redirect output to a file.

The help:system Goal

The system goal is used to view the system information like system properties and environment variables.

You can execute this goal using the following command:

# mvn help:system

Note: you could also use the output parameter to redirect output to a file.

The help:evaluate Goal

You could use this interactive goal to evaluate some Maven expressions. To do it, just call the help:evaluate goal:

# mvn help:evaluate -Dartifact=org.apache.maven.plugins:maven-help-plugin
...
[INFO] [help:evaluate]
[INFO] Enter the Maven expression i.e. ${project.groupId} or 0 to exit?:
${project.artifactId}
[INFO]
maven-help-plugin
[INFO] Enter the Maven expression i.e. ${project.groupId} or 0 to exit?:
${project.none}
[INFO]
null object or invalid expression
...

The artifact parameter refers to ask expressions on the artifact POM. If omitted, the evaluate goal uses the current pom.

You could ask for all Maven expressions listed in the Javadoc of the PluginParameterExpressionEvaluator class.