How to PDF + Multi-projects

git-svn-id: https://svn.apache.org/repos/asf/maven/maven-1/plugins/trunk@116089 13f79535-47bb-0310-9956-ffa450edef68

pdf/xdocs/faq.fml

@@ -28,6 +28,33 @@
         </ul>
       </answer>
     </faq>
+    <faq id="how-use-multiproject">
+      <question>How do I use the PDF Plugin with a multiproject ?</question>
+      <answer>
+      <p>To generate a PDF from documentations defined in several sub-projects, you must copy all the xdocs files from these projects.</p>
+      <p>Here is an example on how to do it :</p>
+     <source><![CDATA[ 
+<attainGoal name="multiproject:site"/>
+<maven:reactor 
+  basedir="${basedir}" 
+  postProcessing="true" 
+  includes="**/project.xml" 
+  collectOnly="true" 
+  ignoreFailures="false" 
+  collectionVar="multiprojects"/>
+<!-- We copy the generated files to use them in the pdf -->
+<j:forEach var="reactorProject" items="${multiprojects}">
+  <j:set var="fromDir" value="${reactorProject.context.getVariable('maven.gen.docs')}"/>
+  <ant:copy todir="${maven.build.dir}/pdf/${maven.multiproject.aggregateDir}${reactorProject.artifactId}">
+    <ant:fileset dir="${fromDir}" force="true">
+      <ant:include name="**/*.*"/>
+    </ant:fileset>
+  </ant:copy>
+</j:forEach>
+<attainGoal name="pdf"/>
+]]></source>        
+      </answer>
+    </faq>    
     <faq id="how-images">
       <question>Which types of images can I use in my documents ?</question>
       <answer>