CR-6575 OPENDJ-1912 Move doc source generation to a profile

Mark Craig

07.03.2015 f40b9e881e95f3e93fff86777edd4c31b81f275f

CR-6575 OPENDJ-1912 Move doc source generation to a profile

This patch speeds up a basic clean install
by moving doc generation out of the common path into a profile.

This patch requires that both native package builds and also doc builds
now use -Pman-pages to build the man pages.

Otherwise the build breaks with a message:
Man pages not found. You must build with -P man-pages.

 opendj-ldap-toolkit/pom.xml

@@ -99,6 +99,59 @@
        </executions>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-jar-plugin</artifactId>
        <configuration>
          <archive>
            <manifest>
              <addClasspath>true</addClasspath>
            </manifest>
          </archive>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-assembly-plugin</artifactId>
        <executions>
          <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
            <configuration>
              <appendAssemblyId>false</appendAssemblyId>
              <descriptors>
                <descriptor>src/main/assembly/descriptor.xml</descriptor>
              </descriptors>
            </configuration>
          </execution>
        </executions>
      </plugin>
      <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-failsafe-plugin</artifactId>
          <executions>
              <execution>
                <goals>
                    <goal>integration-test</goal>
                    <goal>verify</goal>
                </goals>
              </execution>
          </executions>
     </plugin>
    </plugins>
  </build>
  <profiles>
    <profile>
      <id>docs</id>
      <build>
        <plugins>
          <plugin>
        <groupId>org.forgerock.opendj</groupId>
        <artifactId>opendj-doc-maven-plugin</artifactId>
        <version>${project.version}</version>
@@ -232,37 +285,9 @@
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-jar-plugin</artifactId>
        <configuration>
          <archive>
            <manifest>
              <addClasspath>true</addClasspath>
            </manifest>
          </archive>
        </configuration>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-surefire-plugin</artifactId>
      </plugin>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-assembly-plugin</artifactId>
        <executions>
          <execution>
            <id>make-assembly</id>
            <phase>package</phase>
            <goals>
              <goal>single</goal>
            </goals>
            <configuration>
              <appendAssemblyId>false</appendAssemblyId>
              <descriptors>
                <descriptor>src/main/assembly/descriptor.xml</descriptor>
              </descriptors>
            </configuration>
          </execution>
          <execution>
            <id>man-pages</id>
            <phase>package</phase>
            <goals>
@@ -276,18 +301,8 @@
          </execution>
        </executions>
      </plugin>
      <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-failsafe-plugin</artifactId>
          <executions>
              <execution>
                <goals>
                    <goal>integration-test</goal>
                    <goal>verify</goal>
                </goals>
              </execution>
          </executions>
     </plugin>
    </plugins>
  </build>
    </profile>
  </profiles>
</project>

 opendj-server-legacy/pom.xml

@@ -529,321 +529,6 @@
        </executions>
      </plugin>

      <!-- Generates man page sources -->
      <plugin>
        <groupId>org.forgerock.opendj</groupId>
        <artifactId>opendj-doc-maven-plugin</artifactId>
        <version>${project.version}</version>
        <executions>
          <execution>
             <id>generate-doc</id>
             <goals>
               <goal>generate-refentry</goal>
             </goals>
             <configuration>
               <outputDir>${project.build.directory}/docbkx-sources/man-pages</outputDir>
               <tools>
                 <tool>
                  <name>backup</name>
                  <application>org.opends.server.tools.BackUpDB</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-1.xml</trailingSectionPath>
                    <trailingSectionPath>backup-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>base64</name>
                  <application>org.opends.server.util.Base64</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>base64-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>control-panel</name>
                  <application>org.opends.guitools.controlpanel.ControlPanelLauncher</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>control-panel-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>create-rc-script</name>
                  <application>org.opends.server.tools.CreateRCScript</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>create-rc-script-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>dbtest</name>
                  <application>org.opends.server.tools.DBTest</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>dbtest-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>dsconfig</name>
                  <application>org.forgerock.opendj.config.dsconfig.DSConfig</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>dsconfig-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>dsjavaproperties</name>
                  <application>org.opends.server.tools.JavaPropertiesTool</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>dsjavaproperties-files.xml</trailingSectionPath>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>dsjavaproperties-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>dsreplication</name>
                  <application>org.opends.server.tools.dsreplication.ReplicationCliMain</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>dsreplication-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>encode-password</name>
                  <application>org.opends.server.tools.EncodePassword</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-5-6-other.xml</trailingSectionPath>
                    <trailingSectionPath>encode-password-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>export-ldif</name>
                  <application>org.opends.server.tools.ExportLDIF</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>export-ldif-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>import-ldif</name>
                  <application>org.opends.server.tools.ImportLDIF</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>export-ldif-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>ldapcompare</name>
                  <application>org.opends.server.tools.LDAPCompare</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>ldapcompare-exit-codes.xml</trailingSectionPath>
                    <trailingSectionPath>files.xml</trailingSectionPath>
                    <trailingSectionPath>ldapcompare-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>ldapdelete</name>
                  <application>org.opends.server.tools.LDAPDelete</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-ldap-89.xml</trailingSectionPath>
                    <trailingSectionPath>files.xml</trailingSectionPath>
                    <trailingSectionPath>ldapdelete-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>ldapmodify</name>
                  <application>org.opends.server.tools.LDAPModify</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-ldap-89.xml</trailingSectionPath>
                    <trailingSectionPath>files.xml</trailingSectionPath>
                    <trailingSectionPath>ldapmodify-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>ldappasswordmodify</name>
                  <application>org.opends.server.tools.LDAPPasswordModify</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-ldap-89.xml</trailingSectionPath>
                    <trailingSectionPath>files.xml</trailingSectionPath>
                    <trailingSectionPath>ldappasswordmodify-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>ldapsearch</name>
                  <application>org.opends.server.tools.LDAPSearch</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>filters.xml</trailingSectionPath>
                    <trailingSectionPath>attributes.xml</trailingSectionPath>
                    <trailingSectionPath>exit-codes-0-ldap-89.xml</trailingSectionPath>
                    <trailingSectionPath>files.xml</trailingSectionPath>
                    <trailingSectionPath>ldapsearch-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>ldif-diff</name>
                  <application>org.opends.server.tools.LDIFDiff</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-5-6-other.xml</trailingSectionPath>
                    <trailingSectionPath>ldif-diff-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>ldifmodify</name>
                  <application>org.opends.server.tools.LDIFModify</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>ldifmodify-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>ldifsearch</name>
                  <application>org.opends.server.tools.LDIFSearch</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>ldifsearch-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>list-backends</name>
                  <application>org.opends.server.tools.ListBackends</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>list-backends-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>make-ldif</name>
                  <application>org.opends.server.tools.makeldif.MakeLDIF</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>make-ldif-examples.xml</trailingSectionPath>
                    <trailingSectionPath>make-ldif-see-also.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>manage-account</name>
                  <application>org.opends.server.tools.ManageAccount</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-89.xml</trailingSectionPath>
                    <trailingSectionPath>manage-account-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>manage-tasks</name>
                  <application>org.opends.server.tools.ManageTasks</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>manage-tasks-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>rebuild-index</name>
                  <application>org.opends.server.tools.RebuildIndex</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>rebuild-index-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>restore</name>
                  <application>org.opends.server.tools.RestoreDB</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>restore-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>setup</name>
                  <application>org.opends.quicksetup.installer.SetupLauncher</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>setup-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>start-ds</name>
                  <application>org.opends.server.core.DirectoryServer</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>start-ds-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>status</name>
                  <application>org.opends.server.tools.status.StatusCli</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>status-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>stop-ds</name>
                  <application>org.opends.server.tools.StopDS</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>stop-ds-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>uninstall</name>
                  <application>org.opends.guitools.uninstaller.UninstallLauncher</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                    <trailingSectionPath>uninstall-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>upgrade</name>
                  <application>org.opends.server.tools.upgrade.UpgradeCli</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>upgrade-exit-codes.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>

                 <tool>
                  <name>verify-index</name>
                  <application>org.opends.server.tools.VerifyIndex</application>
                  <trailingSectionPaths>
                    <trailingSectionPath>verify-index-exit-codes.xml</trailingSectionPath>
                    <trailingSectionPath>verify-index-examples.xml</trailingSectionPath>
                  </trailingSectionPaths>
                 </tool>
               </tools>
             </configuration>
           </execution>
         </executions>
      </plugin>

      <plugin>
        <groupId>org.codehaus.mojo</groupId>
        <artifactId>build-helper-maven-plugin</artifactId>
@@ -1834,12 +1519,362 @@
    </profile>

    <profile>
      <!-- Build man pages -->
      <id>man-pages</id>

      <build>
        <plugins>
          <plugin>
            <groupId>org.forgerock.opendj</groupId>
            <artifactId>opendj-doc-maven-plugin</artifactId>
            <version>${project.version}</version>
            <executions>
              <execution>
                <id>generate-man-pages</id>
                <goals>
                  <goal>generate-refentry</goal>
                </goals>
                <phase>process-classes</phase>
                <configuration>
                  <outputDir>${project.build.directory}/docbkx-sources/man-pages</outputDir>
                  <tools>
                    <tool>
                     <name>backup</name>
                     <application>org.opends.server.tools.BackUpDB</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-1.xml</trailingSectionPath>
                       <trailingSectionPath>backup-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>base64</name>
                     <application>org.opends.server.util.Base64</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>base64-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>control-panel</name>
                     <application>org.opends.guitools.controlpanel.ControlPanelLauncher</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>control-panel-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>create-rc-script</name>
                     <application>org.opends.server.tools.CreateRCScript</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>create-rc-script-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>dbtest</name>
                     <application>org.opends.server.tools.DBTest</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>dbtest-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>dsconfig</name>
                     <application>org.forgerock.opendj.config.dsconfig.DSConfig</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>dsconfig-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>dsjavaproperties</name>
                     <application>org.opends.server.tools.JavaPropertiesTool</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>dsjavaproperties-files.xml</trailingSectionPath>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>dsjavaproperties-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>dsreplication</name>
                     <application>org.opends.server.tools.dsreplication.ReplicationCliMain</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>dsreplication-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>encode-password</name>
                     <application>org.opends.server.tools.EncodePassword</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-5-6-other.xml</trailingSectionPath>
                       <trailingSectionPath>encode-password-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>export-ldif</name>
                     <application>org.opends.server.tools.ExportLDIF</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>export-ldif-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>import-ldif</name>
                     <application>org.opends.server.tools.ImportLDIF</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>export-ldif-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>ldapcompare</name>
                     <application>org.opends.server.tools.LDAPCompare</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>ldapcompare-exit-codes.xml</trailingSectionPath>
                       <trailingSectionPath>files.xml</trailingSectionPath>
                       <trailingSectionPath>ldapcompare-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>ldapdelete</name>
                     <application>org.opends.server.tools.LDAPDelete</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-ldap-89.xml</trailingSectionPath>
                       <trailingSectionPath>files.xml</trailingSectionPath>
                       <trailingSectionPath>ldapdelete-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>ldapmodify</name>
                     <application>org.opends.server.tools.LDAPModify</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-ldap-89.xml</trailingSectionPath>
                       <trailingSectionPath>files.xml</trailingSectionPath>
                       <trailingSectionPath>ldapmodify-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>ldappasswordmodify</name>
                     <application>org.opends.server.tools.LDAPPasswordModify</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-ldap-89.xml</trailingSectionPath>
                       <trailingSectionPath>files.xml</trailingSectionPath>
                       <trailingSectionPath>ldappasswordmodify-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>ldapsearch</name>
                     <application>org.opends.server.tools.LDAPSearch</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>filters.xml</trailingSectionPath>
                       <trailingSectionPath>attributes.xml</trailingSectionPath>
                       <trailingSectionPath>exit-codes-0-ldap-89.xml</trailingSectionPath>
                       <trailingSectionPath>files.xml</trailingSectionPath>
                       <trailingSectionPath>ldapsearch-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>ldif-diff</name>
                     <application>org.opends.server.tools.LDIFDiff</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-5-6-other.xml</trailingSectionPath>
                       <trailingSectionPath>ldif-diff-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>ldifmodify</name>
                     <application>org.opends.server.tools.LDIFModify</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>ldifmodify-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>ldifsearch</name>
                     <application>org.opends.server.tools.LDIFSearch</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>ldifsearch-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>list-backends</name>
                     <application>org.opends.server.tools.ListBackends</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>list-backends-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>make-ldif</name>
                     <application>org.opends.server.tools.makeldif.MakeLDIF</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>make-ldif-examples.xml</trailingSectionPath>
                       <trailingSectionPath>make-ldif-see-also.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>manage-account</name>
                     <application>org.opends.server.tools.ManageAccount</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-89.xml</trailingSectionPath>
                       <trailingSectionPath>manage-account-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>manage-tasks</name>
                     <application>org.opends.server.tools.ManageTasks</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>manage-tasks-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>rebuild-index</name>
                     <application>org.opends.server.tools.RebuildIndex</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>rebuild-index-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>restore</name>
                     <application>org.opends.server.tools.RestoreDB</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>restore-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>setup</name>
                     <application>org.opends.quicksetup.installer.SetupLauncher</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>setup-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>start-ds</name>
                     <application>org.opends.server.core.DirectoryServer</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>start-ds-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>status</name>
                     <application>org.opends.server.tools.status.StatusCli</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>status-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>stop-ds</name>
                     <application>org.opends.server.tools.StopDS</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>stop-ds-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>uninstall</name>
                     <application>org.opends.guitools.uninstaller.UninstallLauncher</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>exit-codes-0-gt0.xml</trailingSectionPath>
                       <trailingSectionPath>uninstall-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>upgrade</name>
                     <application>org.opends.server.tools.upgrade.UpgradeCli</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>upgrade-exit-codes.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>

                    <tool>
                     <name>verify-index</name>
                     <application>org.opends.server.tools.VerifyIndex</application>
                     <trailingSectionPaths>
                       <trailingSectionPath>verify-index-exit-codes.xml</trailingSectionPath>
                       <trailingSectionPath>verify-index-examples.xml</trailingSectionPath>
                     </trailingSectionPaths>
                    </tool>
                  </tools>
                </configuration>
              </execution>
            </executions>
          </plugin>
        </plugins>
      </build>
    </profile>

    <profile>
      <!-- Build documentation -->
      <id>docs</id>

      <build>
        <plugins>
          <plugin>
            <artifactId>maven-enforcer-plugin</artifactId>
            <executions>
              <execution>
                <id>enforce-man-pages-exist</id>
                <phase>prepare-package</phase>
                <goals>
                  <goal>enforce</goal>
                </goals>
                <configuration>
                  <rules>
                    <requireFilesExist>
                      <files>
                        <file>${project.build.directory}/docbkx-sources/man-pages/man-dsconfig.xml</file>
                      </files>
                      <message>
                        Man pages not found. You must build with -P man-pages.
                      </message>
                    </requireFilesExist>
                  </rules>
                  <fail>true</fail>
                </configuration>
              </execution>
            </executions>
          </plugin>

          <plugin>
            <groupId>org.forgerock.opendj</groupId>
            <artifactId>opendj-doc-maven-plugin</artifactId>
            <version>${project.version}</version>
@@ -1853,6 +1888,7 @@
              </execution>

              <execution>
                <id>generate-log-reference-doc</id>
                <goals>
                  <goal>generate-xml-messages-doc</goal>
                </goals>
@@ -1931,7 +1967,33 @@

        <build>
          <plugins>
            <!-- Build man pages -->
            <plugin>
              <artifactId>maven-enforcer-plugin</artifactId>
              <executions>
                <execution>
                  <id>enforce-man-pages-exist</id>
                  <phase>prepare-package</phase>
                  <goals>
                    <goal>enforce</goal>
                  </goals>
                  <configuration>
                    <rules>
                      <requireFilesExist>
                        <files>
                          <file>${project.build.directory}/docbkx-sources/man-pages/man-dsconfig.xml</file>
                        </files>
                        <message>
                          Man pages not found. You must build with -P man-pages.
                        </message>
                      </requireFilesExist>
                    </rules>
                    <fail>true</fail>
                  </configuration>
                </execution>
              </executions>
            </plugin>

            <!-- Format man pages -->
            <plugin>
                <groupId>org.forgerock.commons</groupId>
                <artifactId>forgerock-doc-maven-plugin</artifactId>
@@ -2132,7 +2194,33 @@

      <build>
        <plugins>
            <!-- Build man pages -->
          <plugin>
            <artifactId>maven-enforcer-plugin</artifactId>
            <executions>
              <execution>
                <id>enforce-man-pages-exist</id>
                <phase>prepare-package</phase>
                <goals>
                  <goal>enforce</goal>
                </goals>
                <configuration>
                  <rules>
                    <requireFilesExist>
                      <files>
                        <file>${project.build.directory}/docbkx-sources/man-pages/man-dsconfig.xml</file>
                      </files>
                      <message>
                        Man pages not found. You must build with -P man-pages.
                      </message>
                    </requireFilesExist>
                  </rules>
                  <fail>true</fail>
                </configuration>
              </execution>
            </executions>
          </plugin>

          <!-- Format man pages -->
          <plugin>
            <groupId>org.forgerock.commons</groupId>
            <artifactId>forgerock-doc-maven-plugin</artifactId>
@@ -2368,7 +2456,33 @@
      <id>package-svr4</id>
      <build>
        <plugins>
          <!-- Build man pages -->
          <plugin>
            <artifactId>maven-enforcer-plugin</artifactId>
            <executions>
              <execution>
                <id>enforce-man-pages-exist</id>
                <phase>prepare-package</phase>
                <goals>
                  <goal>enforce</goal>
                </goals>
                <configuration>
                  <rules>
                    <requireFilesExist>
                      <files>
                        <file>${project.build.directory}/docbkx-sources/man-pages/man-dsconfig.xml</file>
                      </files>
                      <message>
                        Man pages not found. You must build with -P man-pages.
                      </message>
                    </requireFilesExist>
                  </rules>
                  <fail>true</fail>
                </configuration>
              </execution>
            </executions>
          </plugin>

          <!-- Format man pages -->
          <plugin>
            <groupId>org.forgerock.commons</groupId>
            <artifactId>forgerock-doc-maven-plugin</artifactId>