This is an automated email from the ASF dual-hosted git repository. hboutemy pushed a commit to annotated tag maven-help-plugin-2.0.2 in repository https://gitbox.apache.org/repos/asf/maven-help-plugin.git
commit cfb5f16872975bcc0eb9dc07aa19c2bf5271bf22 Author: Dennis Lundberg <denn...@apache.org> AuthorDate: Thu Mar 1 21:18:56 2007 +0000 o Set EOL style to native. git-svn-id: https://svn.apache.org/repos/asf/maven/plugins/trunk/maven-help-plugin@513503 13f79535-47bb-0310-9956-ffa450edef68 --- src/site/apt/index.apt | 88 ++++++++++++------------ src/site/apt/usage.apt | 182 ++++++++++++++++++++++++------------------------- 2 files changed, 135 insertions(+), 135 deletions(-) diff --git a/src/site/apt/index.apt b/src/site/apt/index.apt index b0be4ce..4562697 100644 --- a/src/site/apt/index.apt +++ b/src/site/apt/index.apt @@ -1,44 +1,44 @@ - ------ - Introduction - ------ - Maria Odea Ching - ------ - 7 July 2006 - ------ - - -Maven 2 Help Plugin - - The Maven 2 Help Plugin is used to get relative information about a project. It can be used to get a description - of a particular plugin, including the plugin's mojos with their parameters and component requirements, the effective pom - and effective settings of the current build, and the profiles applied to the current project being built. - -* Goals Overview - - The Help plugin has the following goals: - - * {{{active-profiles-mojo.html}help:active-profiles}} lists the profiles which are currently active for the build. - - * {{{dependencies-mojo.html}help:dependencies}} prints out the dependency tree for the project. - - * {{{describe-mojo.html}help:describe}} describes the attirbutes of a plugin and/or plugin mojo. For its execution, it requires - the groupId and artifactId or the plugin prefix of the plugin to be specified. - - * {{{effective-pom-mojo.html}help:effective-pom}} displays the effective POM for the current build, with the active - profiles factored in. - - * {{{effective-settings-mojo.html}help:effective-settings}} prints out the calculated settings for the project, given any - profile enhancement and the inheritance of the global settings into the user-level settings. - -* Usage - - Instructions on how to use the Help Plugin can be found {{{usage.html}here}}. - -* Examples - - To provide you with better understanding on some usages of the Help plugin, you can take a look into the - following example(s): - - * {{{examples/describe-configuration.html}Configuring Describe Mojo}} - - + ------ + Introduction + ------ + Maria Odea Ching + ------ + 7 July 2006 + ------ + + +Maven 2 Help Plugin + + The Maven 2 Help Plugin is used to get relative information about a project. It can be used to get a description + of a particular plugin, including the plugin's mojos with their parameters and component requirements, the effective pom + and effective settings of the current build, and the profiles applied to the current project being built. + +* Goals Overview + + The Help plugin has the following goals: + + * {{{active-profiles-mojo.html}help:active-profiles}} lists the profiles which are currently active for the build. + + * {{{dependencies-mojo.html}help:dependencies}} prints out the dependency tree for the project. + + * {{{describe-mojo.html}help:describe}} describes the attirbutes of a plugin and/or plugin mojo. For its execution, it requires + the groupId and artifactId or the plugin prefix of the plugin to be specified. + + * {{{effective-pom-mojo.html}help:effective-pom}} displays the effective POM for the current build, with the active + profiles factored in. + + * {{{effective-settings-mojo.html}help:effective-settings}} prints out the calculated settings for the project, given any + profile enhancement and the inheritance of the global settings into the user-level settings. + +* Usage + + Instructions on how to use the Help Plugin can be found {{{usage.html}here}}. + +* Examples + + To provide you with better understanding on some usages of the Help plugin, you can take a look into the + following example(s): + + * {{{examples/describe-configuration.html}Configuring Describe Mojo}} + + diff --git a/src/site/apt/usage.apt b/src/site/apt/usage.apt index abb4e11..1580d48 100644 --- a/src/site/apt/usage.apt +++ b/src/site/apt/usage.apt @@ -1,91 +1,91 @@ - ------ - Usage - ------ - John Casey - Maria Odea Ching - ------ - 10 July 2006 - ------ - -Usage - - Below are the different goals and configuration of the Help plugin. - -* The <<<help:active-profiles>>> Mojo - - The <<<active-profiles>>> mojo 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). - - Optionally, the output parameter can be specified to divert this output to a file. - - You can execute this mojo using the following command: - -+-----+ -mvn help:active-profiles -Doutput=/path/to/file -+-----+ - -* The <<<help:dependencies>>> Mojo - - The <<<dependencies>>> mojo is used to view the dependency hierarchy of the project currently being built. - It will output the resolved tree of dependencies that the Maven build process actually uses. - - Optionally, the output parameter can be specified to divert this output to a file. - - You can execute this mojo using the following command: - -+-----+ -mvn help:dependencies -Doutput=/path/to/file -+-----+ - -* The <<<help:describe>>> Mojo - - The <<<describe>>> mojo is used to discover information about Maven plugins. Given a plugin prefix or groupId, artifactId, - and optionally version, the mojo will lookup that plugin and output details about it. If the user also specifies - which mojo to describe, the <<describe>> mojo will limit output to the details of that mojo, including parameters. - - Optionally, the output parameter can be specified to divert this output to a file. - - This mojo requires either the groupId and artifactId parameters or the plugin parameter to be specified: - -+-----+ -mvn help:describe -DgroupId=org.somewhere - -DartifactId=some-plugin -Dversion=0.0.0 -+-----+ - - or - -+-----+ -mvn help:active-profiles -Dplugin=org.somewhere:some-plugin:0.0.0 -+-----+ - - (NOTE: version is always optional here.) - -* The <<<help:effective-pom>>> Mojo - - The <<<effective-pom>>> mojo 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. - - Optionally, the output parameter can be specified to divert this output to a file. - - The mojo can be executedd using the following command: - -+-----+ -mvn help:effective-profiles -Doutput=/path/to/file -+-----+ - -* The <<<help:effective-settings>>> Mojo - - The <<<effective-settings>>> mojo is used to view the Settings that Maven actually uses to run the build. This Settings - instance is a result of merging the global file with the user's file, with the user's file taking precedence. - - Optionally, the output parameter can be specified to divert this output to a file. - - The mojo can be executedd using the following command: - -+-----+ -mvn help:effective-settings -Doutput=/path/to/file -+-----+ - - + ------ + Usage + ------ + John Casey + Maria Odea Ching + ------ + 10 July 2006 + ------ + +Usage + + Below are the different goals and configuration of the Help plugin. + +* The <<<help:active-profiles>>> Mojo + + The <<<active-profiles>>> mojo 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). + + Optionally, the output parameter can be specified to divert this output to a file. + + You can execute this mojo using the following command: + ++-----+ +mvn help:active-profiles -Doutput=/path/to/file ++-----+ + +* The <<<help:dependencies>>> Mojo + + The <<<dependencies>>> mojo is used to view the dependency hierarchy of the project currently being built. + It will output the resolved tree of dependencies that the Maven build process actually uses. + + Optionally, the output parameter can be specified to divert this output to a file. + + You can execute this mojo using the following command: + ++-----+ +mvn help:dependencies -Doutput=/path/to/file ++-----+ + +* The <<<help:describe>>> Mojo + + The <<<describe>>> mojo is used to discover information about Maven plugins. Given a plugin prefix or groupId, artifactId, + and optionally version, the mojo will lookup that plugin and output details about it. If the user also specifies + which mojo to describe, the <<describe>> mojo will limit output to the details of that mojo, including parameters. + + Optionally, the output parameter can be specified to divert this output to a file. + + This mojo requires either the groupId and artifactId parameters or the plugin parameter to be specified: + ++-----+ +mvn help:describe -DgroupId=org.somewhere + -DartifactId=some-plugin -Dversion=0.0.0 ++-----+ + + or + ++-----+ +mvn help:active-profiles -Dplugin=org.somewhere:some-plugin:0.0.0 ++-----+ + + (NOTE: version is always optional here.) + +* The <<<help:effective-pom>>> Mojo + + The <<<effective-pom>>> mojo 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. + + Optionally, the output parameter can be specified to divert this output to a file. + + The mojo can be executedd using the following command: + ++-----+ +mvn help:effective-profiles -Doutput=/path/to/file ++-----+ + +* The <<<help:effective-settings>>> Mojo + + The <<<effective-settings>>> mojo is used to view the Settings that Maven actually uses to run the build. This Settings + instance is a result of merging the global file with the user's file, with the user's file taking precedence. + + Optionally, the output parameter can be specified to divert this output to a file. + + The mojo can be executedd using the following command: + ++-----+ +mvn help:effective-settings -Doutput=/path/to/file ++-----+ + + -- To stop receiving notification emails like this one, please contact "commits@maven.apache.org" <commits@maven.apache.org>.