Author: gboue Date: Sun Jul 17 15:11:06 2016 New Revision: 1753082 URL: http://svn.apache.org/viewvc?rev=1753082&view=rev Log: [MASSEMBLY-823] Documentation refers to deprecated goals
Documentation is updated to only to refer to the "single" goal. This requires the example code for the "Include Module Sources" to be adapted, mainly by adding the "useAllReactorProjects" parameter and fixing a deprecation warning about fileSet inclusions. Modified: maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/multimodule/module-source-inclusion-simple.apt.vm maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/filtering-some-distribution-files.apt.vm maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/using-repositories.apt.vm Modified: maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/multimodule/module-source-inclusion-simple.apt.vm URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/multimodule/module-source-inclusion-simple.apt.vm?rev=1753082&r1=1753081&r2=1753082&view=diff ============================================================================== --- maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/multimodule/module-source-inclusion-simple.apt.vm (original) +++ maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/multimodule/module-source-inclusion-simple.apt.vm Sun Jul 17 15:11:06 2016 @@ -54,11 +54,20 @@ Including Module Sources <includeBaseDirectory>false</includeBaseDirectory> <moduleSets> <moduleSet> + <useAllReactorProjects>true</useAllReactorProjects> <includes> <include>org.test:child1</include> </includes> <sources> - <outputDirectory>sources/${artifactId}</outputDirectory> + <includeModuleDirectory>false</includeModuleDirectory> + <fileSets> + <fileSet> + <outputDirectory>sources/${module.artifactId}</outputDirectory> + <excludes> + <exclude>${project.build.directory}/**</exclude> + </excludes> + </fileSet> + </fileSets> </sources> </moduleSet> </moduleSets> @@ -75,11 +84,18 @@ Including Module Sources sources should be contained within the directory structure <<<sources/child1>>> for this module, since the outputDirectory expression will be interpolated on a module-by-module basis. + + By default, the Assembly Plugin will add the sources under a folder named with the artifactId + of each module; this can be disabled by setting <<<includeModuleDirectory>>> to <<<false>>>. + + Note that the build directory (<<<target>>> by default) will be included, so it is explicitly excluded + since this is a temporary storage for files produced during the build and it should not contain any + project sources. * The POM Now, let's review the POM configuration necessary to enable the building of - this assembly via the <assembly:directory> goal: + this assembly via the <assembly:single> goal: +---+ <?xml version="1.0" encoding="UTF-8"?> @@ -125,7 +141,7 @@ Including Module Sources To build the assembly, we issue the following command: +---+ -mvn clean assembly:directory +mvn clean assembly:single +---+ This will ensure that the output directory (normally, <<<target>>>), is Modified: maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/filtering-some-distribution-files.apt.vm URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/filtering-some-distribution-files.apt.vm?rev=1753082&r1=1753081&r2=1753082&view=diff ============================================================================== --- maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/filtering-some-distribution-files.apt.vm (original) +++ maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/filtering-some-distribution-files.apt.vm Sun Jul 17 15:11:06 2016 @@ -182,5 +182,5 @@ variable2=value2 To generate the distribution assembly, we then use: +----- -mvn assembly:assembly +mvn clean assembly:single +----- Modified: maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/using-repositories.apt.vm URL: http://svn.apache.org/viewvc/maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/using-repositories.apt.vm?rev=1753082&r1=1753081&r2=1753082&view=diff ============================================================================== --- maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/using-repositories.apt.vm (original) +++ maven/plugins/trunk/maven-assembly-plugin/src/site/apt/examples/single/using-repositories.apt.vm Sun Jul 17 15:11:06 2016 @@ -95,7 +95,7 @@ Using Repositories The assembly archive is then created using: +----- -mvn assembly:assembly +mvn clean assembly:single +----- The generated archive can be extracted to an internal repository so users of