You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-commits@maven.apache.org by kh...@apache.org on 2017/08/13 12:02:03 UTC

svn commit: r1016737 [9/24] - in /websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST: ./ apidocs/ apidocs/org/apache/maven/plugins/assembly/ apidocs/org/apache/maven/plugins/assembly/archive/ apidocs/org/apache/maven/plu...

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/dependency-management.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/dependency-management.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/dependency-management.html Sun Aug 13 12:01:54 2017
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Project Dependency Management</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.5.min.css" />
@@ -77,9 +77,9 @@
         <li class="active ">Project Dependency Management</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -106,6 +106,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -172,7 +179,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="examples/single/index.html" title="Single Project">
@@ -207,6 +214,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -555,7 +569,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/descriptor-refs.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/descriptor-refs.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/descriptor-refs.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -11,7 +11,7 @@
 Edwin Punzalan
 John Casey" />
     <meta name="Date-Creation-yyyymmdd" content="20110207" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Predefined Assembly Descriptors</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.5.min.css" />
@@ -81,9 +81,9 @@ John Casey" />
         <li class="active ">Predefined Assembly Descriptors</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@ John Casey" />
   
             <a href="#"><span class="none"></span>Predefined Descriptors</a>
           </li>
+                
+      <li>
+  
+                          <a href="assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@ John Casey" />
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="examples/single/index.html" title="Single Project">
@@ -209,6 +216,13 @@ John Casey" />
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -552,7 +566,7 @@ John Casey" />
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/distribution-management.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/distribution-management.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/distribution-management.html Sun Aug 13 12:01:54 2017
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Project Distribution Management</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.5.min.css" />
@@ -77,9 +77,9 @@
         <li class="active ">Project Distribution Management</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -106,6 +106,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -172,7 +179,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="examples/single/index.html" title="Single Project">
@@ -207,6 +214,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -531,7 +545,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/download.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/download.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/download.html Sun Aug 13 12:01:54 2017
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Download Apache Maven Assembly Plugin Source</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.5.min.css" />
@@ -77,9 +77,9 @@
         <li class="active ">Download Apache Maven Assembly Plugin Source</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -106,6 +106,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -170,7 +177,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="examples/single/index.html" title="Single Project">
@@ -205,6 +212,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -415,10 +429,10 @@
             
   
     <div class="section">
-<h2><a name="Download_Apache_Maven_Assembly_Plugin_3.0.0_Source"></a>Download Apache Maven Assembly Plugin 3.0.0 Source</h2>
+<h2><a name="Download_Apache_Maven_Assembly_Plugin_3.1.0_Source"></a>Download Apache Maven Assembly Plugin 3.1.0 Source</h2>
 
       
-<p>Apache Maven Assembly Plugin 3.0.0 is distributed in source format. Use a source archive if you intend to build
+<p>Apache Maven Assembly Plugin 3.1.0 is distributed in source format. Use a source archive if you intend to build
       Apache Maven Assembly Plugin yourself. Otherwise, simply use the ready-made binary artifacts from central repository.</p>
 
       
@@ -493,7 +507,7 @@
       
       
 <div class="section">
-<h3><a name="Apache_Maven_Assembly_Plugin_3.0.0"></a>Apache Maven Assembly Plugin 3.0.0</h3>
+<h3><a name="Apache_Maven_Assembly_Plugin_3.1.0"></a>Apache Maven Assembly Plugin 3.1.0</h3>
         
       
 <p>This is the current stable version of Apache Maven Assembly Plugin.</p>
@@ -517,13 +531,13 @@
           
 <tr class="b">
             
-<td>Apache Maven Assembly Plugin 3.0.0 (Source zip)</td>
+<td>Apache Maven Assembly Plugin 3.1.0 (Source zip)</td>
             
-<td><a href="[preferred]maven/plugins/maven-assembly-plugin-3.0.0-source-release.zip">maven/plugins/maven-assembly-plugin-3.0.0-source-release.zip</a></td>
+<td><a href="[preferred]maven/plugins/maven-assembly-plugin-3.1.0-source-release.zip">maven/plugins/maven-assembly-plugin-3.1.0-source-release.zip</a></td>
             
-<td><a class="externalLink" href="http://www.apache.org/dist/maven/plugins/maven-assembly-plugin-3.0.0-source-release.zip.md5">maven/plugins/maven-assembly-plugin-3.0.0-source-release.zip.md5</a></td>
+<td><a class="externalLink" href="http://www.apache.org/dist/maven/plugins/maven-assembly-plugin-3.1.0-source-release.zip.md5">maven/plugins/maven-assembly-plugin-3.1.0-source-release.zip.md5</a></td>
             
-<td><a class="externalLink" href="http://www.apache.org/dist/maven/plugins/maven-assembly-plugin-3.0.0-source-release.zip.asc">maven/plugins/maven-assembly-plugin-3.0.0-source-release.zip.asc</a></td>
+<td><a class="externalLink" href="http://www.apache.org/dist/maven/plugins/maven-assembly-plugin-3.1.0-source-release.zip.asc">maven/plugins/maven-assembly-plugin-3.1.0-source-release.zip.asc</a></td>
           </tr>
         </tbody>
       </table>
@@ -549,7 +563,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/index.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/index.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/index.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="John Casey" />
     <meta name="Date-Creation-yyyymmdd" content="20081103" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Examples</title>
     <link rel="stylesheet" href="../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Examples</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -172,7 +179,7 @@
   
             <a href="#"><span class="none"></span>Examples Index</a>
           </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="../examples/single/index.html" title="Single Project">
@@ -207,6 +214,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -425,7 +439,8 @@
 <li><a href="./single/filtering-some-distribution-files.html">Filtering Some Distribution Files</a></li>
 <li><a href="./single/including-and-excluding-artifacts.html">Including/Excluding Artifacts</a></li>
 <li><a href="./single/using-components.html">Using Component Descriptors</a></li>
-<li><a href="./single/using-repositories.html">Using Repositories</a></li></ul></li>
+<li><a href="./single/using-repositories.html">Using Repositories</a></li>
+<li><a href="./single/using-container-descriptor-handlers.html">Using Container Descriptor Handlers</a></li></ul></li>
 <li><a href="./multimodule/index.html">Working with Multi-Module Projects</a>
 <ul>
 <li><a href="./multimodule/module-source-inclusion-simple.html">Adding Module Sources to the Assembly</a></li>
@@ -440,7 +455,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/index.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/index.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/index.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="Edwin Punzalan" />
     <meta name="Date-Creation-yyyymmdd" content="20060724" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Multi-Module Examples</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Multi-Module Examples</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="../../examples/single/index.html" title="Single Project">
@@ -209,6 +216,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                                   
@@ -430,7 +444,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/module-binary-inclusion-simple.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/module-binary-inclusion-simple.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/module-binary-inclusion-simple.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="John Casey" />
     <meta name="Date-Creation-yyyymmdd" content="20060505" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Including Module Binaries</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Including Module Binaries</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="../../examples/single/index.html" title="Single Project">
@@ -209,6 +216,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                                         
@@ -483,7 +497,7 @@
       &lt;plugins&gt;
         &lt;plugin&gt;
           &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
-          &lt;version&gt;3.0.0&lt;/version&gt;
+          &lt;version&gt;3.1.0&lt;/version&gt;
           &lt;configuration&gt;
             &lt;descriptors&gt;
               &lt;descriptor&gt;src/assembly/bin.xml&lt;/descriptor&gt;
@@ -575,7 +589,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/module-source-inclusion-simple.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/module-source-inclusion-simple.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/multimodule/module-source-inclusion-simple.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="John Casey" />
     <meta name="Date-Creation-yyyymmdd" content="20060505" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Including Module Sources</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Including Module Sources</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="../../examples/single/index.html" title="Single Project">
@@ -209,6 +216,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                                         
@@ -443,7 +457,7 @@
           &lt;fileSet&gt;
             &lt;outputDirectory&gt;sources/${module.artifactId}&lt;/outputDirectory&gt;
             &lt;excludes&gt;
-              &lt;exclude&gt;/Users/olamy/dev/sources/maven/plugins/maven-assembly-plugin/target/checkout/target/**&lt;/exclude&gt;
+              &lt;exclude&gt;/Users/kama/apache-maven/maven-plugins/maven-assembly-plugin/target/checkout/target/**&lt;/exclude&gt;
             &lt;/excludes&gt;
           &lt;/fileSet&gt;
         &lt;/fileSets&gt;
@@ -481,7 +495,7 @@
     &lt;plugins&gt;
       &lt;plugin&gt;
         &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
-        &lt;version&gt;3.0.0&lt;/version&gt;
+        &lt;version&gt;3.1.0&lt;/version&gt;
         &lt;configuration&gt;
           &lt;descriptors&gt;
             &lt;descriptor&gt;src/assembly/src.xml&lt;/descriptor&gt;
@@ -524,7 +538,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/sharing-descriptors.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/sharing-descriptors.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/sharing-descriptors.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="Dennis Lundberg" />
     <meta name="Date-Creation-yyyymmdd" content="20101108" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Sharing Assembly Descriptors</title>
     <link rel="stylesheet" href="../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Sharing Assembly Descriptors</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                  
+                                                                                                                                    
       <li>
   
                           <a href="../examples/single/index.html" title="Single Project">
@@ -209,6 +216,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -474,7 +488,7 @@
     &lt;plugins&gt;
       &lt;plugin&gt;
         &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
-        &lt;version&gt;3.0.0&lt;/version&gt;
+        &lt;version&gt;3.1.0&lt;/version&gt;
         &lt;dependencies&gt;
           &lt;dependency&gt;
             &lt;groupId&gt;your.group.id&lt;/groupId&gt;
@@ -512,7 +526,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/filtering-some-distribution-files.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/filtering-some-distribution-files.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/filtering-some-distribution-files.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="Edwin Punzalan" />
     <meta name="Date-Creation-yyyymmdd" content="20060726" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Filtering Some Distribution Files</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Filtering Some Distribution Files</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                            
+                                                                                                                                              
       <li>
   
                           <a href="../../examples/single/index.html" title="Single Project">
@@ -207,6 +214,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -504,7 +518,7 @@ variable2=value2</pre></div></div>
       [...]
       &lt;plugin&gt;
         &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
-        &lt;version&gt;3.0.0&lt;/version&gt;
+        &lt;version&gt;3.1.0&lt;/version&gt;
         &lt;configuration&gt;
           &lt;filters&gt;
             &lt;filter&gt;src/assembly/filter.properties&lt;/filter&gt;
@@ -529,7 +543,7 @@ variable2=value2</pre></div></div>
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/including-and-excluding-artifacts.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/including-and-excluding-artifacts.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/including-and-excluding-artifacts.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="Barrie Treloar" />
     <meta name="Date-Creation-yyyymmdd" content="20060731" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Including and Excluding Artifacts</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Including and Excluding Artifacts</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                            
+                                                                                                                                              
       <li>
   
                           <a href="../../examples/single/index.html" title="Single Project">
@@ -207,6 +214,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -454,7 +468,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/index.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/index.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/index.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="Edwin Punzalan" />
     <meta name="Date-Creation-yyyymmdd" content="20060724" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Single Project Examples</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Single Project Examples</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                      
+                                                                                                                                        
       <li class="active">
   
             <a href="#"><span class="icon-chevron-down"></span>Single Project</a>
@@ -207,6 +214,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -422,7 +436,8 @@
 <li><a href="./filtering-some-distribution-files.html">Filtering Some Distribution Files</a></li>
 <li><a href="./including-and-excluding-artifacts.html">Including/Excluding Artifacts</a></li>
 <li><a href="./using-components.html">Using Component Descriptors</a></li>
-<li><a href="./using-repositories.html">Using Repositories</a></li></ul></div>
+<li><a href="./using-repositories.html">Using Repositories</a></li>
+<li><a href="./using-container-descriptor-handlers.html">Using Container Descriptor Handlers</a></li></ul></div>
                   </div>
             </div>
           </div>
@@ -432,7 +447,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Modified: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/using-components.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/using-components.html (original)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/using-components.html Sun Aug 13 12:01:54 2017
@@ -1,6 +1,6 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2016-11-09 
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
  | Rendered using Apache Maven Fluido Skin 1.5
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -9,7 +9,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <meta name="author" content="Edwin Punzalan" />
     <meta name="Date-Creation-yyyymmdd" content="20060724" />
-    <meta name="Date-Revision-yyyymmdd" content="20161109" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
     <meta http-equiv="Content-Language" content="en" />
     <title>Apache Maven Assembly Plugin &#x2013; Using Component Descriptors</title>
     <link rel="stylesheet" href="../../css/apache-maven-fluido-1.5.min.css" />
@@ -79,9 +79,9 @@
         <li class="active ">Using Component Descriptors</li>
         
               
-                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2016-11-09</li>
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
               <li id="projectVersion" class="pull-right">
-                    Version: 3.0.0
+                    Version: 3.1.0
         </li>
             
                             </ul>
@@ -108,6 +108,13 @@
           <span class="none"></span>
         Predefined Descriptors</a>
             </li>
+                
+      <li>
+  
+                          <a href="../../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
                               <li class="nav-header">Overview</li>
                               
       <li>
@@ -174,7 +181,7 @@
           <span class="none"></span>
         Examples Index</a>
             </li>
-                                                                                                                            
+                                                                                                                                              
       <li>
   
                           <a href="../../examples/single/index.html" title="Single Project">
@@ -207,6 +214,13 @@
           <span class="none"></span>
         Using Repositories</a>
             </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-container-descriptor-handlers.html" title="Using Container Descriptor Handlers">
+          <span class="none"></span>
+        Using Container Descriptor Handlers</a>
+            </li>
               </ul>
         </li>
                                                                               
@@ -527,7 +541,7 @@
       [...]
       &lt;plugin&gt;
         &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
-        &lt;version&gt;3.0.0&lt;/version&gt;
+        &lt;version&gt;3.1.0&lt;/version&gt;
         &lt;configuration&gt;
           &lt;descriptors&gt;
             &lt;descriptor&gt;src/assembly/appserverA-assembly.xml&lt;/descriptor&gt;
@@ -550,7 +564,7 @@
     <footer>
             <div class="container-fluid">
                       <div class="row-fluid">
-                                      <p >Copyright &copy;                    2002&#x2013;2016
+                                      <p >Copyright &copy;                    2002&#x2013;2017
                         <a href="https://www.apache.org/">The Apache Software Foundation</a>.
             All rights reserved.    
       </p>

Added: websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/using-container-descriptor-handlers.html
==============================================================================
--- websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/using-container-descriptor-handlers.html (added)
+++ websites/production/maven/components/plugins-archives/maven-assembly-plugin-LATEST/examples/single/using-container-descriptor-handlers.html Sun Aug 13 12:01:54 2017
@@ -0,0 +1,714 @@
+<!DOCTYPE html>
+<!--
+ | Generated by Apache Maven Doxia Site Renderer 1.7.1 at 2017-08-13 
+ | Rendered using Apache Maven Fluido Skin 1.5
+-->
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <meta name="author" content="Guillaume Boué" />
+    <meta name="Date-Creation-yyyymmdd" content="20170715" />
+    <meta name="Date-Revision-yyyymmdd" content="20170813" />
+    <meta http-equiv="Content-Language" content="en" />
+    <title>Apache Maven Assembly Plugin &#x2013; Using Container Descriptor Handlers</title>
+    <link rel="stylesheet" href="../../css/apache-maven-fluido-1.5.min.css" />
+    <link rel="stylesheet" href="../../css/site.css" />
+    <link rel="stylesheet" href="../../css/print.css" media="print" />
+
+      
+    <script type="text/javascript" src="../../js/apache-maven-fluido-1.5.min.js"></script>
+
+                  <!-- Google Analytics -->
+    <script type="text/javascript">
+
+      var _gaq = _gaq || [];
+      _gaq.push(['_setAccount', 'UA-140879-1']);
+      _gaq.push(['_trackPageview']);
+
+      (function() {
+        var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+        ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+        var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+      })();
+
+    </script>
+          </head>
+        <body class="topBarDisabled">
+          
+                
+                    
+    
+        <div class="container-fluid">
+          <div id="banner">
+        <div class="pull-left">
+                                    <a href="https://www.apache.org/" id="bannerLeft">
+                                                                                                <img src="../../../../images/apache-maven-project.png"  alt="Apache Maven Assembly Plugin"/>
+                </a>
+                      </div>
+        <div class="pull-right">                                <a href="../../../../" id="bannerRight">
+                                                                                                <img src="../../../../images/maven-logo-black-on-white.png" />
+                </a>
+      </div>
+        <div class="clear"><hr/></div>
+      </div>
+
+      <div id="breadcrumbs">
+        <ul class="breadcrumb">
+              
+                              <li class="">
+                    <a href="https://www.apache.org/" class="externalLink" title="Apache">
+        Apache</a>
+                    <span class="divider">/</span>
+      </li>
+            <li class="">
+                    <a href="../../../../index.html" title="Maven">
+        Maven</a>
+                    <span class="divider">/</span>
+      </li>
+            <li class="">
+                    <a href="../../../index.html" title="Plugins">
+        Plugins</a>
+                    <span class="divider">/</span>
+      </li>
+            <li class="">
+                    <a href="../../index.html" title="Apache Maven Assembly Plugin">
+        Apache Maven Assembly Plugin</a>
+                    <span class="divider">/</span>
+      </li>
+        <li class="active ">Using Container Descriptor Handlers</li>
+        
+              
+                  <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2017-08-13</li>
+              <li id="projectVersion" class="pull-right">
+                    Version: 3.1.0
+        </li>
+            
+                            </ul>
+      </div>
+
+            
+      <div class="row-fluid">
+        <div id="leftColumn" class="span2">
+          <div class="well sidebar-nav">
+              
+                <ul class="nav nav-list">
+                    <li class="nav-header">Reference</li>
+                              
+      <li>
+  
+                          <a href="../../assembly.html" title="Descriptor Format">
+          <span class="none"></span>
+        Descriptor Format</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../descriptor-refs.html" title="Predefined Descriptors">
+          <span class="none"></span>
+        Predefined Descriptors</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../assembly-component.html" title="Components">
+          <span class="none"></span>
+        Components</a>
+            </li>
+                              <li class="nav-header">Overview</li>
+                              
+      <li>
+  
+                          <a href="../../index.html" title="Introduction">
+          <span class="none"></span>
+        Introduction</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../plugin-info.html" title="Goals">
+          <span class="none"></span>
+        Goals</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../usage.html" title="Usage">
+          <span class="none"></span>
+        Usage</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../faq.html" title="FAQ">
+          <span class="none"></span>
+        FAQ</a>
+            </li>
+                
+      <li>
+  
+                          <a href="http://www.apache.org/licenses/" class="externalLink" title="License">
+          <span class="none"></span>
+        License</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../download.html" title="Download">
+          <span class="none"></span>
+        Download</a>
+            </li>
+                              <li class="nav-header">Advanced Topics</li>
+                              
+      <li>
+  
+                          <a href="../../advanced-descriptor-topics.html" title="Assembly Descriptors">
+          <span class="none"></span>
+        Assembly Descriptors</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../advanced-module-set-topics.html" title="ModuleSets">
+          <span class="none"></span>
+        ModuleSets</a>
+            </li>
+                              <li class="nav-header">Examples</li>
+                              
+      <li>
+  
+                          <a href="../../examples/index.html" title="Examples Index">
+          <span class="none"></span>
+        Examples Index</a>
+            </li>
+                                                                                                                                              
+      <li>
+  
+                          <a href="../../examples/single/index.html" title="Single Project">
+          <span class="icon-chevron-down"></span>
+        Single Project</a>
+                    <ul class="nav nav-list">
+                    
+      <li>
+  
+                          <a href="../../examples/single/filtering-some-distribution-files.html" title="Filtering Some Distribution Files">
+          <span class="none"></span>
+        Filtering Some Distribution Files</a>
+            </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/including-and-excluding-artifacts.html" title="Including/Excluding Artifacts">
+          <span class="none"></span>
+        Including/Excluding Artifacts</a>
+            </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-components.html" title="Using Component Descriptors">
+          <span class="none"></span>
+        Using Component Descriptors</a>
+            </li>
+                    
+      <li>
+  
+                          <a href="../../examples/single/using-repositories.html" title="Using Repositories">
+          <span class="none"></span>
+        Using Repositories</a>
+            </li>
+                    
+      <li class="active">
+  
+            <a href="#"><span class="none"></span>Using Container Descriptor Handlers</a>
+          </li>
+              </ul>
+        </li>
+                                                                              
+      <li>
+  
+                          <a href="../../examples/multimodule/index.html" title="Multimodule Projects">
+          <span class="icon-chevron-down"></span>
+        Multimodule Projects</a>
+                    <ul class="nav nav-list">
+                    
+      <li>
+  
+                          <a href="../../examples/multimodule/module-binary-inclusion-simple.html" title="Include Module Artifacts">
+          <span class="none"></span>
+        Include Module Artifacts</a>
+            </li>
+                    
+      <li>
+  
+                          <a href="../../examples/multimodule/module-source-inclusion-simple.html" title="Include Module Sources">
+          <span class="none"></span>
+        Include Module Sources</a>
+            </li>
+              </ul>
+        </li>
+                
+      <li>
+  
+                          <a href="../../examples/sharing-descriptors.html" title="Sharing Assembly Descriptors">
+          <span class="none"></span>
+        Sharing Assembly Descriptors</a>
+            </li>
+                              <li class="nav-header">Project Documentation</li>
+                                                                                                                                                                                                                                                                                                                          
+      <li>
+  
+                          <a href="../../project-info.html" title="Project Information">
+          <span class="icon-chevron-right"></span>
+        Project Information</a>
+                  </li>
+                                                                                                                                                                                                                                                                        
+      <li>
+  
+                          <a href="../../project-reports.html" title="Project Reports">
+          <span class="icon-chevron-right"></span>
+        Project Reports</a>
+                  </li>
+                              <li class="nav-header">Maven Projects</li>
+                              
+      <li>
+  
+                          <a href="../../../../archetype/index.html" title="Archetype">
+          <span class="none"></span>
+        Archetype</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../doxia/index.html" title="Doxia">
+          <span class="none"></span>
+        Doxia</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../jxr/index.html" title="JXR">
+          <span class="none"></span>
+        JXR</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../ref/current" title="Maven">
+          <span class="none"></span>
+        Maven</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../pom/index.html" title="Parent POMs">
+          <span class="none"></span>
+        Parent POMs</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../index.html" title="Plugins">
+          <span class="none"></span>
+        Plugins</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../plugin-testing/index.html" title="Plugin Testing">
+          <span class="none"></span>
+        Plugin Testing</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../plugin-tools/index.html" title="Plugin Tools">
+          <span class="none"></span>
+        Plugin Tools</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../apache-resource-bundles/index.html" title="Resource Bundles">
+          <span class="none"></span>
+        Resource Bundles</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../scm/index.html" title="SCM">
+          <span class="none"></span>
+        SCM</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../shared/index.html" title="Shared Components">
+          <span class="none"></span>
+        Shared Components</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../skins/index.html" title="Skins">
+          <span class="none"></span>
+        Skins</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../surefire/index.html" title="Surefire">
+          <span class="none"></span>
+        Surefire</a>
+            </li>
+                
+      <li>
+  
+                          <a href="../../../../wagon/index.html" title="Wagon">
+          <span class="none"></span>
+        Wagon</a>
+            </li>
+                              <li class="nav-header">ASF</li>
+                              
+      <li>
+  
+                          <a href="https://www.apache.org/foundation/how-it-works.html" class="externalLink" title="How Apache Works">
+          <span class="none"></span>
+        How Apache Works</a>
+            </li>
+                
+      <li>
+  
+                          <a href="https://www.apache.org/foundation/" class="externalLink" title="Foundation">
+          <span class="none"></span>
+        Foundation</a>
+            </li>
+                
+      <li>
+  
+                          <a href="https://www.apache.org/foundation/sponsorship.html" class="externalLink" title="Sponsoring Apache">
+          <span class="none"></span>
+        Sponsoring Apache</a>
+            </li>
+                
+      <li>
+  
+                          <a href="https://www.apache.org/foundation/thanks.html" class="externalLink" title="Thanks">
+          <span class="none"></span>
+        Thanks</a>
+            </li>
+            </ul>
+              
+                            <form id="search-form" action="https://www.google.com/search" method="get" >
+    
+  <input value="$sitesearchValue" name="sitesearch" type="hidden"/>
+  <input class="search-query" name="q" id="query" type="text" />
+</form>
+<script type="text/javascript" src="https://cse.google.com/brand?form=search-form"></script>
+          
+          <hr />
+
+           <div id="poweredBy">
+                   
+    <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
+
+    
+    <div class="g-plusone" data-href="https://maven.apache.org/plugins/maven-assembly-plugin/" data-size="tall" ></div>
+
+                   <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                            <div class="clear"></div>
+                             <a href="http://maven.apache.org/" title="Built by Maven" class="poweredBy">
+        <img class="builtBy" alt="Built by Maven" src="../../images/logos/maven-feather.png" />
+      </a>
+                  </div>
+          </div>
+        </div>
+        
+                
+        <div id="bodyColumn"  class="span10" >
+                                  
+            <div class="section">
+<h2><a name="Using_Container_Descriptor_Handlers"></a>Using Container Descriptor Handlers</h2>
+<div class="section">
+<h3><a name="Introduction"></a>Introduction</h3>
+<p>Container descriptor handlers can be used to filter dynamically the content of files configured in a descriptor, for example by aggregating multiple files into a single file, or customizing the content of specific files.</p>
+<p>This example demonstrate the use of <tt>&lt;containerDescriptorHandlers&gt;</tt> in the assembly <a href="../../assembly.html">descriptor format</a>.</p></div>
+<div class="section">
+<h3><a name="Built-in_container_descriptor_handlers"></a>Built-in container descriptor handlers</h3>
+<p>The plugin comes with several handlers already defined.</p>
+<dl>
+<dt><tt>file-aggregator</tt></dt>
+<dd>This handler matches the files according to the given regular expression <tt>filePattern</tt>, aggregates their content, and stores the output in the assembly at the given <tt>outputPath</tt>. A sample descriptor which matches all <tt>file.txt</tt> files configured in the assembly and aggregates them, by appending their content, into a single <tt>file.txt</tt> located under the base directory of the assembly, is:
+<div class="source"><pre class="prettyprint linenums">&lt;assembly xmlns=&quot;http://maven.apache.org/ASSEMBLY/2.0.0&quot;
+    xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
+    xsi:schemaLocation=&quot;http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd&quot;&gt;
+  ....
+  &lt;containerDescriptorHandlers&gt;
+    &lt;containerDescriptorHandler&gt;
+      &lt;handlerName&gt;file-aggregator&lt;/handlerName&gt;
+      &lt;configuration&gt;
+        &lt;filePattern&gt;.*/file.txt&lt;/filePattern&gt;
+        &lt;outputPath&gt;file.txt&lt;/outputPath&gt;
+      &lt;/configuration&gt;
+    &lt;/containerDescriptorHandler&gt;
+  &lt;/containerDescriptorHandlers&gt;
+&lt;/assembly&gt;</pre></div></dd>
+<dt><tt>metaInf-services</tt></dt>
+<dd>This handler matches every <tt>META-INF/services</tt> file and aggregates them into a single <tt>META-INF/services</tt>. The content of the files are appended together.
+<div class="source"><pre class="prettyprint linenums">&lt;assembly xmlns=&quot;http://maven.apache.org/ASSEMBLY/2.0.0&quot;
+    xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
+    xsi:schemaLocation=&quot;http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd&quot;&gt;
+  ....
+  &lt;containerDescriptorHandlers&gt;
+    &lt;containerDescriptorHandler&gt;
+      &lt;handlerName&gt;metaInf-services&lt;/handlerName&gt;
+    &lt;/containerDescriptorHandler&gt;
+  &lt;/containerDescriptorHandlers&gt;
+&lt;/assembly&gt;</pre></div></dd>
+<dt><tt>metaInf-spring</tt></dt>
+<dd>This handler is similar to <tt>metaInf-services</tt>. It matches every file with a name starting with <tt>META-INF/spring.</tt>.
+<div class="source"><pre class="prettyprint linenums">&lt;assembly xmlns=&quot;http://maven.apache.org/ASSEMBLY/2.0.0&quot;
+    xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
+    xsi:schemaLocation=&quot;http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd&quot;&gt;
+  ....
+  &lt;containerDescriptorHandlers&gt;
+    &lt;containerDescriptorHandler&gt;
+      &lt;handlerName&gt;metaInf-spring&lt;/handlerName&gt;
+    &lt;/containerDescriptorHandler&gt;
+  &lt;/containerDescriptorHandlers&gt;
+&lt;/assembly&gt;</pre></div></dd>
+<dt><tt>plexus</tt></dt>
+<dd>This handler matches every <tt>META-INF/plexus/components.xml</tt> file and aggregates them into a single valid <tt>META-INF/plexus/components.xml</tt>.
+<div class="source"><pre class="prettyprint linenums">&lt;assembly xmlns=&quot;http://maven.apache.org/ASSEMBLY/2.0.0&quot;
+    xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
+    xsi:schemaLocation=&quot;http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd&quot;&gt;
+  ....
+  &lt;containerDescriptorHandlers&gt;
+    &lt;containerDescriptorHandler&gt;
+      &lt;handlerName&gt;plexus&lt;/handlerName&gt;
+    &lt;/containerDescriptorHandler&gt;
+  &lt;/containerDescriptorHandlers&gt;
+&lt;/assembly&gt;</pre></div></dd></dl></div>
+<div class="section">
+<h3><a name="Custom_container_descriptor_handlers"></a>Custom container descriptor handlers</h3>
+<p>You can create your own container descriptor handler by creating a class implementing <tt>ContainerDescriptorHandler</tt>. As an example, let's create a handler that will prepend a configured comment to every properties file configured in an assembly descriptor. </p>
+<p>We start by creating a new Maven project named <tt>custom-container-descriptor-handler</tt> with the following POM:</p>
+<div class="source"><pre class="prettyprint linenums">&lt;project xmlns=&quot;http://maven.apache.org/POM/4.0.0&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot; xsi:schemaLocation=&quot;http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd&quot;&gt;
+  &lt;modelVersion&gt;4.0.0&lt;/modelVersion&gt;
+  &lt;groupId&gt;com.test&lt;/groupId&gt;
+  &lt;artifactId&gt;custom-container-descriptor-handler&lt;/artifactId&gt;
+  &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+  &lt;dependencies&gt;
+    &lt;dependency&gt;
+      &lt;groupId&gt;org.apache.maven.plugins&lt;/groupId&gt;
+      &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
+      &lt;version&gt;3.1.0&lt;/version&gt;
+    &lt;/dependency&gt;
+  &lt;/dependencies&gt;
+  &lt;build&gt;
+    &lt;plugins&gt;
+      &lt;plugin&gt;
+        &lt;groupId&gt;org.codehaus.plexus&lt;/groupId&gt;
+        &lt;artifactId&gt;plexus-component-metadata&lt;/artifactId&gt;
+        &lt;version&gt;1.7.1&lt;/version&gt;
+        &lt;executions&gt;
+          &lt;execution&gt;
+            &lt;goals&gt;
+              &lt;goal&gt;generate-metadata&lt;/goal&gt;
+            &lt;/goals&gt;
+          &lt;/execution&gt;
+        &lt;/executions&gt;
+      &lt;/plugin&gt;
+    &lt;/plugins&gt;
+  &lt;/build&gt;
+&lt;/project&gt;</pre></div>
+<p>This POM declares a dependency on the Assembly Plugin so that we can create our handler, and generates a Plexus configuration file so that it can be found through dependency injection during assembling.</p>
+<p>Implementing <tt>ContainerDescriptorHandler</tt> requires defining a couple of methods:</p>
+<dl>
+<dt><tt>isSelected</tt></dt>
+<dd>Tells whether a given file or directory, configured in the assembly descriptor, should be added to the final assembly. A typical set-up would be to prevent the addition of certain files, and let the handler do its work on them.</dd>
+<dt><tt>getVirtualFiles</tt></dt>
+<dd>Returns the list of file paths, from the root of the assembly, of each file this handler will add.</dd>
+<dt><tt>finalizeArchiveCreation</tt></dt>
+<dd>Callback that is invoked when an assembly is going to be created. This method can be used to add files that resulted from the handler's work on each selected file. <b>Cave-at:</b> Because of the way archive finalization is performed, we need to loop through each resource in the archive before doing anything.</dd>
+<dt><tt>finalizeArchiveExtraction</tt></dt>
+<dd>Callback that is invoked when an assembly has been extracted into a directory. This method can be used to process files that resulted from the handler's work on each selected file.</dd></dl>
+<p>Our handler that prepends a comment to each properties file could look like the following (using here Java 8 features):</p>
+<div class="source"><pre class="prettyprint linenums">package com.test;
+
+import java.io.BufferedReader;
+import java.io.BufferedWriter;
+import java.io.File;
+import java.io.IOException;
+import java.io.InputStreamReader;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+import org.apache.maven.plugins.assembly.filter.ContainerDescriptorHandler;
+import org.apache.maven.plugins.assembly.utils.AssemblyFileUtils;
+import org.codehaus.plexus.archiver.Archiver;
+import org.codehaus.plexus.archiver.ArchiverException;
+import org.codehaus.plexus.archiver.UnArchiver;
+import org.codehaus.plexus.component.annotations.Component;
+import org.codehaus.plexus.components.io.fileselectors.FileInfo;
+
+@Component(role = ContainerDescriptorHandler.class, hint = &quot;custom&quot;)
+public class MyCustomDescriptorHandler implements ContainerDescriptorHandler {
+
+    private String comment;
+
+    private Map&lt;String, List&lt;String&gt;&gt; catalog = new HashMap&lt;&gt;();
+
+    private boolean excludeOverride = false;
+
+    @Override
+    public void finalizeArchiveCreation(Archiver archiver) throws ArchiverException {
+        archiver.getResources().forEachRemaining(a -&gt; {}); // necessary to prompt the isSelected() call
+
+        for (Map.Entry&lt;String, List&lt;String&gt;&gt; entry : catalog.entrySet())
+        {
+            String name = entry.getKey();
+            String fname = new File(name).getName();
+
+            Path p;
+            try {
+                p = Files.createTempFile(&quot;assembly-&quot; + fname, &quot;.tmp&quot;);
+            } catch (IOException e) {
+                throw new ArchiverException(&quot;Cannot create temporary file to finalize archive creation&quot;, e);
+            }
+
+            try (BufferedWriter writer = Files.newBufferedWriter(p, StandardCharsets.ISO_8859_1)) {
+                writer.write(&quot;# &quot; + comment);
+                for (String line : entry.getValue()) {
+                    writer.newLine();
+                    writer.write(line);
+                }
+            } catch (IOException e) {
+                throw new ArchiverException(&quot;Error adding content of &quot; + fname + &quot; to finalize archive creation&quot;, e);
+            }
+
+            File file = p.toFile();
+            file.deleteOnExit();
+            excludeOverride = true;
+            archiver.addFile(file, name);
+            excludeOverride = false;
+        }
+    }
+
+    @Override
+    public void finalizeArchiveExtraction(UnArchiver unarchiver) throws ArchiverException { }
+
+    @Override
+    public List&lt;String&gt; getVirtualFiles() {
+        return new ArrayList&lt;&gt;(catalog.keySet());
+    }
+
+    @Override
+    public boolean isSelected(FileInfo fileInfo) throws IOException {
+        if (excludeOverride) {
+            return true;
+        }
+        String name = AssemblyFileUtils.normalizeFileInfo(fileInfo);
+        if (fileInfo.isFile() &amp;&amp; AssemblyFileUtils.isPropertyFile(name)) {
+            catalog.put(name, readLines(fileInfo));
+            return false;
+        }
+        return true;
+    }
+
+    private List&lt;String&gt; readLines(FileInfo fileInfo) throws IOException {
+        try (BufferedReader reader = new BufferedReader(new InputStreamReader(fileInfo.getContents(), StandardCharsets.ISO_8859_1))) {
+            return reader.lines().collect(Collectors.toList());
+        }
+    }
+
+    public void setComment(String comment) {
+        this.comment = comment;
+    }
+
+}</pre></div>
+<p>It is a Plexus component, having the <tt>ContainerDescriptorHandler</tt> role, that is distinguished from the other handlers with its <tt>hint</tt> of <tt>custom</tt>.</p>
+<p>It selects each properties file and stores their content into a catalog map, where the key is the name of the file and the value is a list of its lines. Those matched files are not added to the assembly, because the handler needs to process them first. During assembly creation, it creates temporary files whose content are the previously read lines, prepended by a custom comment. They are then added back into the archive with their previous name. Note that this simple handler does not aggregate files with the same name - it could be enhanced to do it. When the temporary files are added to the archive, the <tt>isSelected</tt> method is automatically called, hence we need to set a boolean <tt>excludeOverride</tt> to <tt>true</tt> to make sure the catalog processing part is not done.</p>
+<p>The last ingredient is using our custom handler in an assembly descriptor of some Maven project. Suppose there is a <tt>src/samples</tt> directory in this project, containing an XML file named <tt>test.xml</tt> and a properties file named <tt>test.properties</tt>. With the following descriptor format</p>
+<div class="source"><pre class="prettyprint linenums">&lt;assembly xmlns=&quot;http://maven.apache.org/ASSEMBLY/2.0.0&quot; xmlns:xsi=&quot;http://www.w3.org/2001/XMLSchema-instance&quot;
+  xsi:schemaLocation=&quot;http://maven.apache.org/ASSEMBLY/2.0.0 http://maven.apache.org/xsd/assembly-2.0.0.xsd&quot;&gt;
+  &lt;id&gt;dist&lt;/id&gt;
+  &lt;formats&gt;
+    &lt;format&gt;zip&lt;/format&gt;
+  &lt;/formats&gt;
+  &lt;containerDescriptorHandlers&gt;
+    &lt;containerDescriptorHandler&gt;
+      &lt;handlerName&gt;custom&lt;/handlerName&gt;
+      &lt;configuration&gt;
+        &lt;comment&gt;A comment&lt;/comment&gt;
+      &lt;/configuration&gt;
+    &lt;/containerDescriptorHandler&gt;
+  &lt;/containerDescriptorHandlers&gt;
+  &lt;fileSets&gt;
+    &lt;fileSet&gt;
+      &lt;directory&gt;src/samples&lt;/directory&gt;
+      &lt;outputDirectory&gt;&lt;/outputDirectory&gt;
+    &lt;/fileSet&gt;
+  &lt;/fileSets&gt;
+&lt;/assembly&gt;</pre></div>
+<p>and the following Assembly plugin configuration</p>
+<div class="source"><pre class="prettyprint linenums">&lt;project&gt;
+  [...]
+  &lt;build&gt;
+    [...]
+    &lt;plugins&gt;
+      [...]
+      &lt;plugin&gt;
+        &lt;artifactId&gt;maven-assembly-plugin&lt;/artifactId&gt;
+        &lt;version&gt;3.1.0&lt;/version&gt;
+        &lt;executions&gt;
+          &lt;execution&gt;
+            &lt;phase&gt;package&lt;/phase&gt;
+            &lt;goals&gt;
+              &lt;goal&gt;single&lt;/goal&gt;
+            &lt;/goals&gt;
+            &lt;configuration&gt;
+              &lt;descriptors&gt;
+                &lt;descriptor&gt;src/assemble/assembly.xml&lt;/descriptor&gt;
+              &lt;/descriptors&gt;
+            &lt;/configuration&gt;
+          &lt;/execution&gt;
+        &lt;/executions&gt;
+        &lt;dependencies&gt;
+          &lt;dependency&gt;
+            &lt;groupId&gt;com.test&lt;/groupId&gt;
+            &lt;artifactId&gt;custom-container-descriptor-handler&lt;/artifactId&gt;
+            &lt;version&gt;0.0.1-SNAPSHOT&lt;/version&gt;
+          &lt;/dependency&gt;
+        &lt;/dependencies&gt;
+      &lt;/plugin&gt;
+  [...]
+&lt;/project&gt;</pre></div>
+<p>the resulting assembly would contain both <tt>test.xml</tt> and <tt>test.properties</tt> under the base directory, with only the latter starting with <tt># A comment</tt>.</p></div></div>
+                  </div>
+            </div>
+          </div>
+
+    <hr/>
+
+    <footer>
+            <div class="container-fluid">
+                      <div class="row-fluid">
+                                      <p >Copyright &copy;                    2002&#x2013;2017
+                        <a href="https://www.apache.org/">The Apache Software Foundation</a>.
+            All rights reserved.    
+      </p>
+                </div>
+
+        
+                </div>
+    </footer>
+        </body>
+</html>
\ No newline at end of file