Browse Source

HPCC-9348 DOCS:Integrate ConfigMgr Doc generation tool

FIX HPCC-9348 DOCS:Integrate ConfigMgr Doc generation tool
Changes to component files to facilitate auto generation
of configmgr doc at build time.

Signed-off-by: G Panagiotatos <greg.panagiotatos@lexisnexis.com>
G Panagiotatos 10 years ago
parent
commit
420d88519b

+ 1 - 0
cmake_modules/docMacros.cmake

@@ -158,4 +158,5 @@ MACRO(XSD_TO_XML _xsd_files _in_dir _out_dir)
             list(APPEND _xml_files ${_out_dir}/${_xml_file})
         endforeach()
 	ADD_CUSTOM_TARGET("xsd_to_xml" ALL  DEPENDS ${_out_dir} ${_xml_files} )
+        set_property(GLOBAL APPEND PROPERTY DOC_TARGETS "xsd_to_xml")
 ENDMACRO(XSD_TO_XML)

+ 2 - 1
docs/CMakeLists.txt

@@ -74,7 +74,8 @@ add_subdirectory(ECLWatch)
 
 # Docs automation
 if (DOCS_AUTO)
-   add_subdirectory(Automation)
+   add_subdirectory(XMLGeneration)
+   add_subdirectory(UsingConfigManager)
 endif()
 
 

+ 10 - 1
docs/UsingConfigManager/CMakeLists.txt

@@ -13,10 +13,19 @@
 #    See the License for the specific language governing permissions and
 #    limitations under the License.
 ################################################################################
+GET_PROPERTY(Current_Targets GLOBAL PROPERTY DOC_TARGETS)
+
+SET(XSLTPROC_DEPENDENCIES)
+FOREACH(T ${Current_Targets})
+   IF("${T}" MATCHES "xsd_to_xml" )
+      LIST(APPEND XSLTPROC_DEPENDENCIES  ${T})
+   ENDIF()
+ENDFOREACH()
+########################################################################
 # commented out per issue # HPCC-10267
 #
 #
-#DOCBOOK_TO_PDF( ${FO_XSL} UsingConfigManager.xml "UsingConfigManager")
+DOCBOOK_TO_PDF( ${FO_XSL} UsingConfigManager.xml "UsingConfigManager")
 #
 #
 ########################################################################

+ 105 - 80
docs/UsingConfigManager/UsingConfigManager.xml

@@ -745,11 +745,12 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
 
           <para />
 
-          <!--configMgr-Dali-Server-Include-XXX-->
+          <!--configMgr-Dali-Server-Include-XXX1-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/dali.xsd.mod.xml"
-                        xpointer="da.tbl1"
+          
+            <xi:include href="XMLGeneration/xml/dali.xsd.mod.xml"
+                        xpointer="da.t1"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -768,11 +769,12 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
 
           <para />
 
-          <!--configMgr-Dali-Server-Include-XXX-->
+          <!--configMgr-Dali-Server-Include-XXX2-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/dali.xsd.mod.xml"
-                        xpointer="da.tbl2"
+          
+            <xi:include href="XMLGeneration/xml/dali.xsd.mod.xml"
+                        xpointer="da.t2"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -788,11 +790,12 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img04-4.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-DaliServer-LDAP-Include-XXX-->
+          <!--configMgr-DaliServer-LDAP-Include-XXX3-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/dali.xsd.mod.xml"
-                        xpointer="da.tbl4"
+            
+            <xi:include href="XMLGeneration/xml/dali.xsd.mod.xml"
+                        xpointer="da.t4"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -859,10 +862,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img12-1.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-DaFileSrv-Include-XXX-->
+          <!--configMgr-DaFileSrv-Include-XXX4-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/dafilesrv.xsd.mod.xml"
+
+            <xi:include href="XMLGeneration/xml/dafilesrv.xsd.mod.xml"
                         xpointer="daFs.t"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -907,11 +911,12 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img05-1.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-DFUSrvr-Attr-Include-XXX-->
+          <!--configMgr-DFUSrvr-Attr-Include-XXX6-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/dfuserver.xsd.mod.xml"
-                        xpointer="DF.t2"
+            
+            <xi:include href="XMLGeneration/xml/dfuserver.xsd.mod.xml"
+                        xpointer="DF.t1"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -925,11 +930,12 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img05-2.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-DFUSrvr-SSH-Include-XXX-->
+          <!--configMgr-DFUSrvr-SSH-Include-XXX7-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/dfuserver.xsd.mod.xml"
-                        xpointer="DF.t1"
+              
+            <xi:include href="XMLGeneration/xml/dfuserver.xsd.mod.xml"
+                        xpointer="DF.t2"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -1119,10 +1125,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img07-1.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-ECLAgent-Attr-Include-RRR-->
+          <!--configMgr-ECLAgent-Attr-Include-XXX8-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/eclagent_config.xsd.mod.xml"
+           
+            <xi:include href="XMLGeneration/xml/eclagent_config.xsd.mod.xml"
                         xpointer="EA.t1"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1137,10 +1144,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img07-2.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-ECLAgent-Options-Include-RRR-->
+          <!--configMgr-ECLAgent-Options-Include-XXX9-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/eclagent_config.xsd.mod.xml"
+
+            <xi:include href="XMLGeneration/xml/eclagent_config.xsd.mod.xml"
                         xpointer="EA.t2"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1196,10 +1204,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-ECLCC-02.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--ECLCCServer-Include-cc.t2-XXX-->
+          <!--ECLCCServer-Include-cc.t2-XXX-X-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/eclccserver.xsd.mod.xml"
+         
+            <xi:include href="XMLGeneration/xml/eclccserver.xsd.mod.xml"
                         xpointer="cc.t2"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1266,10 +1275,10 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-160.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-DaliServer-LDAP-Include-XXX-->
+          <!--configMgr-DaliServer-LDAP-Include-XXX-XI-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/eclscheduler.xsd.mod.xml"
+            <xi:include href="XMLGeneration/xml/eclscheduler.xsd.mod.xml"
                         xpointer="ecl.sched"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1324,11 +1333,12 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img08-1.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--MyESP-Include-ES.t6-XXX-->
+          <!--MyESP-Include-ESP.t6-XXX12-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/esp.xsd.mod.xml"
-                        xpointer="ES.t6"
+  
+            <xi:include href="XMLGeneration/xml/esp.xsd.mod.xml"
+                        xpointer="ESP.t6"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -1349,31 +1359,38 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
           other tables on that tab. The next table describes the <emphasis
           role="bold">URL Authentication</emphasis> table.</para>
 
-          <!--MyESP-Include-ES.t1-XXX-URL-AuthXXX-->
+          <!--MyESP-Include-ESP.t1-XXXIII-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/esp.xsd.mod.xml"
-                        xpointer="ES.t1"
-                        xmlns:xi="http://www.w3.org/2001/XInclude" />
+           
+             <xi:include href="XMLGeneration/xml/esp.xsd.mod.xml"
+                        xpointer="ESP.t1"
+                        xmlns:xi="http://www.w3.org/2001/XInclude" />  
+    
           </para>
 
           <para>The following tables describe the ESPProcess Service Bindings,
           <emphasis role="bold">Feature Authentications</emphasis>.</para>
 
-          <!--MyESP-Include-ES.t2-XXX-Feature-AuthXXX-->
+          <!--MyESP-Include-ES.t2-XXX-14-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/esp.xsd.mod.xml"
-                        xpointer="ES.t2"
-                        xmlns:xi="http://www.w3.org/2001/XInclude" />
+            
+           <xi:include href="XMLGeneration/xml/esp.xsd.mod.xml"
+                        xpointer="ESP.t2"
+                        xmlns:xi="http://www.w3.org/2001/XInclude" />  
+            
           </para>
 
           <para>
-            <!--MyESP-Include-ES.t3-XXX-Feature-AuthXXX-->
+            <!--MyESP-Include-ES.t3-XXX-15-->
 
-            <xi:include href="UsingConfigManager/CM_Mods/esp.xsd.mod.xml"
+ 
+           <!-- <xi:include href="XMLGeneration/xml/esp.xsd.mod.xml"
                         xpointer="ES.t3"
-                        xmlns:xi="http://www.w3.org/2001/XInclude" />
+                        xmlns:xi="http://www.w3.org/2001/XInclude" />  -->
+ 
+
           </para>
 
           <para />
@@ -1391,12 +1408,14 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img08-3.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--MyESP-Authentication-ES.t4-XOKDXX-->
+          <!--MyESP-Authentication-ES.t4-XXX-16-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/esp.xsd.mod.xml"
-                        xpointer="ES.t4"
-                        xmlns:xi="http://www.w3.org/2001/XInclude" />
+            
+           <xi:include href="XMLGeneration/xml/esp.xsd.mod.xml"
+                        xpointer="ESP.t4"
+                        xmlns:xi="http://www.w3.org/2001/XInclude" /> 
+          
           </para>
         </sect3>
 
@@ -1411,13 +1430,13 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img08-4.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--MyESP-HTTPS.t5-XXX-->
+          <!--MyESP-HTTPS.t5-XXX-17-->
 
-          <para>
-            <xi:include href="UsingConfigManager/CM_Mods/esp.xsd.mod.xml"
-                        xpointer="ES.t5"
-                        xmlns:xi="http://www.w3.org/2001/XInclude" />
-          </para>
+          <para> 
+           <xi:include href="XMLGeneration/xml/esp.xsd.mod.xml"
+                        xpointer="ESP.t5"
+                        xmlns:xi="http://www.w3.org/2001/XInclude" /> 
+           </para>
         </sect3>
 
         <sect3>
@@ -1483,11 +1502,12 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
           <para>This section describes an FTSlaveProcess attributes
           tab.</para>
 
-          <!--FTSlave-Include-XXX-->
+          <!--FTSlave-Include-XXX-18-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/ftslave.xsd.mod.xml"
-                        xpointer="FTS"
+          
+            <xi:include href="XMLGeneration/xml/ftslave_linux.xsd.mod.xml"
+                        xpointer="FTS.t1"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -1515,10 +1535,9 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
           <graphic fileref="images/LDAP_004.jpg" />
         </para>
 
-        <!--LdapServer-Include-fullDoc-XXX-->
-
-        <xi:include href="UsingConfigManager/CM_Mods/ldapserver.xsd.mod.xml"
-                    xpointer="Active_Directory_LDAP_process_mod"
+        <!--LdapServer-Include-fullDoc-XXX-19-->
+        <xi:include href="XMLGeneration/xml/ldapserver.xsd.mod.xml"
+                    xpointer="ldapSrv"
                     xmlns:xi="http://www.w3.org/2001/XInclude" />
 
         <sect3>
@@ -1593,10 +1612,10 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
 
           <graphic fileref="images/CM-Sasha17A.jpg" vendor="configmgrSS" />
 
-          <!--configMgr-Sasha-t1-Include-->
+          <!--configMgr-Sasha-t1-Include-XXX-20-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/sasha.xsd.mod.xml"
+            <xi:include href="XMLGeneration/xml/sasha.xsd.mod.xml"
                         xpointer="sh.t1"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1614,10 +1633,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img17-1.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-Sasha-Archiver-Include-->
+          <!--configMgr-Sasha-Archiver-Include-XXX-21-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/sasha.xsd.mod.xml"
+            
+            <xi:include href="XMLGeneration/xml/sasha.xsd.mod.xml"
                         xpointer="sh.t2"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1635,10 +1655,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img17-2.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-Sasha-Coaleser-Include-->
+          <!--configMgr-Sasha-Coaleser-Include-XXX-22-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/sasha.xsd.mod.xml"
+          
+            <xi:include href="XMLGeneration/xml/sasha.xsd.mod.xml"
                         xpointer="sh.t3"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1656,10 +1677,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img17-3.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-Sasha-DfuXref-Include-->
+          <!--configMgr-Sasha-DfuXref-Include-XXX-23-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/sasha.xsd.mod.xml"
+            
+            <xi:include href="XMLGeneration/xml/sasha.xsd.mod.xml"
                         xpointer="sh.t4"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1679,10 +1701,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
 
           <para />
 
-          <!--configMgr-Sasha-DfuExpiry-Include-->
+          <!--configMgr-Sasha-DfuExpiry-Include-XXX-24-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/sasha.xsd.mod.xml"
+               
+            <xi:include href="XMLGeneration/xml/sasha.xsd.mod.xml"
                         xpointer="sh.t5"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1700,10 +1723,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img17-5.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-Sasha-ThorQMon-Include-->
+          <!--configMgr-Sasha-ThorQMon-IncludeXXX-25-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/sasha.xsd.mod.xml"
+              
+            <xi:include href="XMLGeneration/xml/sasha.xsd.mod.xml"
                         xpointer="sh.t6"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1721,10 +1745,11 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
             <graphic fileref="images/CM-img17-6.jpg" vendor="configmgrSS" />
           </para>
 
-          <!--configMgr-Sasha-DafiSrvMon-Include-XXX-->
+          <!--configMgr-Sasha-DafiSrvMon-Include-XXX26-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/sasha.xsd.mod.xml"
+           
+            <xi:include href="XMLGeneration/xml/sasha.xsd.mod.xml"
                         xpointer="sh.t7"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
@@ -1959,8 +1984,8 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
           <!--configMgr-Thor-Attribute-Include-XXX-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/thor.xsd.mod.xml"
-                        xpointer="th.t1"
+            <xi:include href="XMLGeneration/xml/thor.xsd.mod.xml"
+                        xpointer="Th.t1"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -1979,8 +2004,8 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
           <!--configMgr-Thor-SSH-Include-XXX-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/thor.xsd.mod.xml"
-                        xpointer="th.t2"
+            <xi:include href="XMLGeneration/xml/thor.xsd.mod.xml"
+                        xpointer="Th.t3"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -2005,8 +2030,8 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
           <!--configMgr-Thor-SwapNode-Include-XXX-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/thor.xsd.mod.xml"
-                        xpointer="th.t4"
+            <xi:include href="XMLGeneration/xml/thor.xsd.mod.xml"
+                        xpointer="Th.t4"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -2025,8 +2050,8 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
           <!--configMgr-Thor-Backup-Include-XXX-->
 
           <para>
-            <xi:include href="UsingConfigManager/CM_Mods/thor.xsd.mod.xml"
-                        xpointer="th.t5"
+               <xi:include href="XMLGeneration/xml/thor.xsd.mod.xml"
+                        xpointer="Th.t5"
                         xmlns:xi="http://www.w3.org/2001/XInclude" />
           </para>
         </sect3>
@@ -2123,8 +2148,8 @@ sudo -u hpcc cp /etc/HPCCSystems/source/NewEnvironment.xml /etc/HPCCSystems/envi
 
       <?hard-pagebreak ?>
 
-      <xi:include href="UsingConfigManager/CM_Mods/roxie.xsd.mod.xml"
-                  xpointer="RoxieCluster_mod"
+      <xi:include href="XMLGeneration/xml/roxie.xsd.mod.xml"
+                  xpointer="element(/1)"
                   xmlns:xi="http://www.w3.org/2001/XInclude" />
 
       <sect2 id="Topology" role="brk">

+ 58 - 0
docs/XMLGeneration/CMakeLists.txt

@@ -0,0 +1,58 @@
+################################################################################
+#    HPCC SYSTEMS software Copyright (C) 2012 HPCC Systems.
+#
+#    Licensed under the Apache License, Version 2.0 (the "License");
+#    you may not use this file except in compliance with the License.
+#    You may obtain a copy of the License at
+#
+#       http://www.apache.org/licenses/LICENSE-2.0
+#
+#    Unless required by applicable law or agreed to in writing, software
+#    distributed under the License is distributed on an "AS IS" BASIS,
+#    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+#    See the License for the specific language governing permissions and
+#    limitations under the License.
+################################################################################
+SET(XSD_SOURCE_DIR ${HPCC_SOURCE_DIR}/initfiles/componentfiles/configxml)
+SET(XSD_TARGET_DIR ${CMAKE_CURRENT_BINARY_DIR}/XSD )
+SET(XML_TARGET_DIR ${CMAKE_CURRENT_SOURCE_DIR}/xml )
+
+FILE(MAKE_DIRECTORY ${XSD_TARGET_DIR})
+
+# get all *.xsd.in and *.xsd files
+FILE(GLOB XSD_TEMPLATE_FILES RELATIVE "${XSD_SOURCE_DIR}" "${XSD_SOURCE_DIR}/*.xsd.in")
+FILE(GLOB XSD_FILES RELATIVE "${XSD_SOURCE_DIR}" "${XSD_SOURCE_DIR}/*.xsd")
+
+# Skip some files which cause problem
+LIST(REMOVE_ITEM XSD_FILES "esp_service_wsecl2.xsd")
+
+# process and copy *.xsd.in files
+FOREACH( XSD_TEMPLATE_FILE  ${XSD_TEMPLATE_FILES} )
+   STRING(REGEX REPLACE "(.*).in" "\\1" XSD_FILE "${XSD_TEMPLATE_FILE}")
+   CONFIGURE_FILE(${XSD_SOURCE_DIR}/${XSD_TEMPLATE_FILE} ${XSD_TARGET_DIR}/${XSD_FILE})
+ENDFOREACH()
+
+# copy *.xsd.in files
+FOREACH( XSD_FILE  ${XSD_FILES} )
+   CONFIGURE_FILE(${XSD_SOURCE_DIR}/${XSD_FILE} ${XSD_TARGET_DIR}/${XSD_FILE} COPYONLY)
+ENDFOREACH()
+
+# create complete *.xsd file list
+FOREACH( XSD_TEMPLATE_FILE  ${XSD_TEMPLATE_FILES} )
+   STRING(REGEX REPLACE "(.*).in" "\\1" XSD_FILE "${XSD_TEMPLATE_FILE}")
+   SET(XSD_FILES ${XSD_FILES} ${XSD_FILE})
+ENDFOREACH()
+
+# Set dependencies
+GET_PROPERTY(Current_Targets GLOBAL PROPERTY DOC_TARGETS)
+
+SET(XSLTPROC_DEPENDENCIES)
+FOREACH(T ${Current_Targets})
+   IF("${T}" MATCHES "xsd_to_xml" )
+      LIST(APPEND XSLTPROC_DEPENDENCIES  ${T})
+   ENDIF()
+ENDFOREACH()
+
+
+# create MakeFiles to generate xsd file to xml file
+XSD_TO_XML("${XSD_FILES}" ${XSD_TARGET_DIR} ${XML_TARGET_DIR})

+ 6 - 0
initfiles/componentfiles/configxml/dafilesrv.xsd

@@ -24,6 +24,12 @@
             <xs:documentation>Describes an DFUFileSrv installation</xs:documentation>
         </xs:annotation>
         <xs:complexType>
+        		<!--4/14-GP-added-for-auto-doc-build--> 	
+                      <xs:annotation>
+	                         <xs:appinfo>
+	                                  <docid>daFs.t</docid>
+	                        </xs:appinfo>
+	               </xs:annotation>
             <xs:sequence>
                 <xs:element name="Instance" maxOccurs="unbounded">
                     <xs:annotation>

+ 31 - 0
initfiles/componentfiles/configxml/dali.xsd

@@ -24,6 +24,12 @@
       <xs:documentation>Describes a Dali server installation</xs:documentation>
     </xs:annotation>
     <xs:complexType>
+    <!--5/15-GP-added-for-auto-doc-build-->
+    		         <xs:annotation>
+    		                  <xs:appinfo>
+    		                      <docid>da.t1</docid>
+    		                  </xs:appinfo>
+		        </xs:annotation>  
       <xs:sequence>
         <xs:element name="Instance" maxOccurs="unbounded">
           <xs:annotation>
@@ -205,6 +211,13 @@
     </xs:complexType>
   </xs:element>
   <xs:attributeGroup name="Store">
+      <!--5/15-GP-added-for-auto-doc-build-->
+      		         <xs:annotation>
+      		                  <xs:appinfo>
+      		                      <docid>da.t2</docid>
+      		                  </xs:appinfo>
+  		        </xs:annotation>  
+
     <xs:attribute name="lightweightCoalesce" type="xs:boolean" use="optional" default="true">
       <xs:annotation>
         <xs:appinfo>
@@ -263,6 +276,12 @@
     </xs:attribute>
   </xs:attributeGroup>
   <xs:attributeGroup name="Backup">
+      <!--5/15-GP-added-for-auto-doc-build-->
+        		         <xs:annotation>
+        		                  <xs:appinfo>
+        		                      <docid>da.t3</docid>
+        		                  </xs:appinfo>
+    		        </xs:annotation>  
     <xs:attribute name="backupComputer" type="computerType" use="optional">
       <xs:annotation>
         <xs:appinfo>
@@ -286,6 +305,12 @@
     </xs:attribute>
   </xs:attributeGroup>
    <xs:attributeGroup name="DFS">
+       <!--5/15-GP-added-for-auto-doc-build-->
+         		         <xs:annotation>
+         		                  <xs:appinfo>
+         		                      <docid>da.t5</docid>
+         		                  </xs:appinfo>
+     		        </xs:annotation>  
     <xs:attribute name="forceGroupUpdate" type="xs:boolean" use="optional" default="false">
       <xs:annotation>
         <xs:appinfo>
@@ -302,6 +327,12 @@
     </xs:attribute>
    </xs:attributeGroup>
    <xs:attributeGroup name="LDAP">
+       <!--5/15-GP-added-for-auto-doc-build-->
+         		         <xs:annotation>
+         		                  <xs:appinfo>
+         		                      <docid>da.t4</docid>
+         		                  </xs:appinfo>
+     		        </xs:annotation>  
     <xs:attribute name="ldapServer" type="ldapServerType" use="optional">
       <xs:annotation>
         <xs:appinfo>

+ 12 - 0
initfiles/componentfiles/configxml/dfuserver.xsd

@@ -24,6 +24,12 @@
             <xs:documentation>Describes a DFU server installation</xs:documentation>
         </xs:annotation>
         <xs:complexType>
+                            		<!--5/15-GP-added-for-auto-doc-build--> 	
+		    	                      <xs:annotation>
+		    		                         <xs:appinfo>
+		    		                                  <docid>DF.t1</docid>
+		    		                        </xs:appinfo>
+		    		               </xs:annotation>
             <xs:sequence>
                 <xs:element name="SSH">
                     <xs:annotation>
@@ -33,6 +39,12 @@
                         </xs:appinfo>
                     </xs:annotation>
                     <xs:complexType>
+                    <!--5/15-GP-added-for-auto-doc-build--> 	
+		    		    	                      <xs:annotation>
+		    		    		                         <xs:appinfo>
+		    		    		                                  <docid>DF.t2</docid>
+		    		    		                        </xs:appinfo>
+		    		    		               </xs:annotation>
                         <xs:attribute name="SSHidentityfile" type="xs:string" use="optional" default="$HOME/.ssh/id_rsa">
                             <xs:annotation>
                                 <xs:appinfo>

+ 8 - 0
initfiles/componentfiles/configxml/eclagent_config.xsd.in

@@ -22,6 +22,12 @@
     <xs:include schemaLocation="environment.xsd"/>
     <xs:element name="EclAgentProcess">
         <xs:complexType>
+          		<!--5/15-GP-added-for-auto-doc-build-->
+		            <xs:annotation>
+		                <xs:appinfo>
+		       	    	   <docid>EA.t1</docid>
+		       	    	</xs:appinfo>
+		       	    </xs:annotation>  
             <xs:sequence>
                 <xs:element name="Instance" maxOccurs="unbounded">
                     <xs:annotation>
@@ -153,6 +159,8 @@
             <xs:appinfo>
                 <title>Options</title>
                 <tooltip>Options</tooltip>
+                 <!--5/15-GP-added-for-auto-doc-build-->
+                     <docid>EA.t2</docid>
             </xs:appinfo>
         </xs:annotation>
 

+ 12 - 0
initfiles/componentfiles/configxml/eclccserver.xsd

@@ -23,6 +23,12 @@
     <xs:include schemaLocation="environment.xsd"/>
     <xs:element name="EclCCserver">
         <xs:complexType>
+          		<!--5/15-GP-added-for-auto-doc-build-->
+			                      <xs:annotation>
+				                         <xs:appinfo>
+				                                  <docid>cc.t2</docid>
+				                        </xs:appinfo>
+				               </xs:annotation>  
             <xs:sequence>
                 <xs:element name="Option" minOccurs="0" maxOccurs="unbounded">
                     <xs:annotation>
@@ -31,6 +37,12 @@
                         </xs:appinfo>
                     </xs:annotation>
                     <xs:complexType>
+                              		<!--5/15-GP-added-for-auto-doc-build-->
+		    			                      <xs:annotation>
+		    				                         <xs:appinfo>
+		    				                                  <docid>cc.t1</docid>
+		    				                        </xs:appinfo>
+		    				               </xs:annotation>  
                         <xs:attribute name="name" type="xs:string" use="required">
                             <xs:annotation>
                                 <xs:appinfo>

+ 6 - 0
initfiles/componentfiles/configxml/eclscheduler.xsd

@@ -21,6 +21,12 @@
     <xs:include schemaLocation="environment.xsd"/>
     <xs:element name="EclSchedulerProcess">
         <xs:complexType>
+                		<!--5/15-GP-added-for-auto-doc-build-->
+		                      <xs:annotation>
+			                         <xs:appinfo>
+			                                  <docid>ecl.sched</docid>
+			                        </xs:appinfo>
+			               </xs:annotation>  
             <xs:sequence>
                 <xs:element name="Instance" maxOccurs="unbounded">
                     <xs:annotation>

+ 36 - 0
initfiles/componentfiles/configxml/esp.xsd.in

@@ -21,6 +21,12 @@
     <xs:include schemaLocation="environment.xsd"/>
     <xs:element name="EspProcess">
         <xs:complexType>
+                 <!--5/15-GP-added-for-auto-doc-build-->
+     	    		         <xs:annotation>
+     	    		                  <xs:appinfo>
+     	    		                      <docid>ESP.t6</docid>
+     	    		                  </xs:appinfo>
+     			        </xs:annotation>  
             <xs:sequence>
                 <xs:element name="EspBinding" maxOccurs="unbounded">
                     <xs:annotation>
@@ -29,6 +35,12 @@
                         </xs:appinfo>
                     </xs:annotation>
                     <xs:complexType>
+                   <!--5/15-GP-code-for-auto-doc-build-t684-->
+			         <xs:annotation>
+	    	    		    <xs:appinfo>
+			               <docid>ESP.t3</docid>
+				    </xs:appinfo>
+				  </xs:annotation>  
                         <xs:sequence>
                             <xs:element name="Authenticate" minOccurs="0" maxOccurs="unbounded">
                                 <xs:annotation>
@@ -38,6 +50,12 @@
                                     </xs:appinfo>
                                 </xs:annotation>
                                 <xs:complexType>
+                                    <!--5/15-GP-added-for-auto-doc-build-->
+				         <xs:annotation>
+					     <xs:appinfo>
+					         <docid>ESP.t1</docid>
+				             </xs:appinfo>
+     			                </xs:annotation> 
                                     <xs:attribute name="description" type="xs:string" use="optional">
                                         <xs:annotation>
                                             <xs:appinfo>
@@ -92,6 +110,12 @@
                                     </xs:appinfo>
                                 </xs:annotation>
                                 <xs:complexType>
+                                  <!--5/15-GP-added-for-auto-doc-build-->
+				     	    		         <xs:annotation>
+				     	    		                  <xs:appinfo>
+				     	    		                      <docid>ESP.t2</docid>
+				     	    		                  </xs:appinfo>
+				     			        </xs:annotation>  
                                     <xs:attribute name="authenticate" use="optional" default="Yes">
                                         <xs:annotation>
                                             <xs:appinfo>
@@ -223,6 +247,12 @@
                         </xs:appinfo>
                     </xs:annotation>
                     <xs:complexType>
+                      <!--5/15-GP-added-for-auto-doc-build-->
+		         	    		         <xs:annotation>
+		         	    		                  <xs:appinfo>
+		         	    		                      <docid>ESP.t4</docid>
+		         	    		                  </xs:appinfo>
+		         			        </xs:annotation>  
                         <xs:attribute name="method" use="optional" default="none">
                             <xs:annotation>
                                 <xs:appinfo>
@@ -289,6 +319,12 @@
                 </xs:element>
                 <xs:element name="HTTPS" minOccurs="0">
                     <xs:complexType>
+                              <!--5/15-GP-added-for-auto-doc-build-->
+		         	    		         <xs:annotation>
+		         	    		                  <xs:appinfo>
+		         	    		                      <docid>ESP.t5</docid>
+		         	    		                  </xs:appinfo>
+		         			        </xs:annotation>  
                         <xs:attribute name="certificateFileName" type="xs:string" use="optional" default="certificate.cer">
                             <xs:annotation>
                                 <xs:appinfo>

+ 6 - 0
initfiles/componentfiles/configxml/ftslave_linux.xsd.in

@@ -25,6 +25,12 @@
             <xs:documentation>Describes an ftslave installation</xs:documentation>
         </xs:annotation>
         <xs:complexType>
+                		<!--4/15-GP-added-for-auto-doc-build-->
+		                      <xs:annotation>
+			                         <xs:appinfo>
+			                                  <docid>FTS.t1</docid>
+			                        </xs:appinfo>
+			               </xs:annotation>  
             <xs:sequence>
                 <xs:element name="Instance" maxOccurs="unbounded">
                     <xs:annotation>

+ 6 - 0
initfiles/componentfiles/configxml/ldapserver.xsd

@@ -26,6 +26,12 @@
             </xs:appinfo>
         </xs:annotation>
         <xs:complexType>
+                <!--5/15-GP-added-for-auto-doc-build--> 	
+	         <xs:annotation>
+		     <xs:appinfo>
+		        <docid>ldapSrv</docid>
+		      </xs:appinfo>
+	         </xs:annotation>
             <xs:sequence>
                 <xs:element name="Instance" maxOccurs="unbounded">
                     <xs:annotation>

+ 6 - 0
initfiles/componentfiles/configxml/roxie.xsd.in

@@ -23,6 +23,12 @@
     <xs:annotation>
       <xs:documentation>Describes a roxie cluster</xs:documentation>
     </xs:annotation>
+           		<!--5/15-GP-added-for-auto-doc-build--> 	
+    	    	          <xs:annotation>
+    	    		      <xs:appinfo>
+    	    		          <docid>Roxie.tb1</docid>
+    	    		        </xs:appinfo>
+		            </xs:annotation>
     <xs:complexType>
       <xs:choice maxOccurs="unbounded">
 

+ 42 - 0
initfiles/componentfiles/configxml/sasha.xsd

@@ -24,6 +24,12 @@
             <xs:documentation>Describes a Sasha server installation</xs:documentation>
         </xs:annotation>
         <xs:complexType>
+            <!--5/15-GP-added-for-auto-doc-build-->
+	    		         <xs:annotation>
+	    		                  <xs:appinfo>
+	    		                      <docid>sh.t1</docid>
+	    		                  </xs:appinfo>
+			        </xs:annotation>  
             <xs:sequence>
                 <xs:element name="Instance" maxOccurs="unbounded">
                     <xs:annotation>
@@ -193,6 +199,12 @@
         </xs:complexType>
     </xs:element>
     <xs:attributeGroup name="Archiver">
+         <!--5/15-GP-added-for-auto-doc-build-->
+         		         <xs:annotation>
+         		                  <xs:appinfo>
+         		                      <docid>sh.t2</docid>
+         		                  </xs:appinfo>
+     		                 </xs:annotation>  
         <xs:attribute name="WUlimit" type="xs:nonNegativeInteger" use="optional" default="1000">
             <xs:annotation>
                 <xs:appinfo>
@@ -349,6 +361,12 @@
         </xs:attribute>
     </xs:attributeGroup>
     <xs:attributeGroup name="Coalescer">
+          <!--5/15-GP-added-for-auto-doc-build-->
+                <xs:annotation>
+                     <xs:appinfo>
+                        <docid>sh.t3</docid>
+                     </xs:appinfo>
+      	        </xs:annotation>  
         <xs:attribute name="coalesceInterval" type="xs:nonNegativeInteger" default="1">
             <xs:annotation>
                 <xs:appinfo>
@@ -379,6 +397,12 @@
         </xs:attribute>
     </xs:attributeGroup>
     <xs:attributeGroup name="DfuXRef">
+             <!--5/15-GP-added-for-auto-doc-build-->
+                    <xs:annotation>
+                         <xs:appinfo>
+                            <docid>sh.t4</docid>
+                         </xs:appinfo>
+          	        </xs:annotation>  
         <xs:attribute name="xrefInterval" type="xs:nonNegativeInteger" default="672">
             <xs:annotation>
                 <xs:appinfo>
@@ -437,6 +461,12 @@
         </xs:attribute>
     </xs:attributeGroup>
     <xs:attributeGroup name="DfuExpiry">
+             <!--5/15-GP-added-for-auto-doc-build-->
+                    <xs:annotation>
+                         <xs:appinfo>
+                            <docid>sh.t5</docid>
+                         </xs:appinfo>
+          	        </xs:annotation>  
         <xs:attribute name="ExpiryInterval" type="xs:nonNegativeInteger" default="24">
             <xs:annotation>
                 <xs:appinfo>
@@ -467,6 +497,12 @@
         </xs:attribute>
     </xs:attributeGroup>
     <xs:attributeGroup name="ThorQMon">
+             <!--5/15-GP-added-for-auto-doc-build-->
+                    <xs:annotation>
+                         <xs:appinfo>
+                            <docid>sh.t6</docid>
+                         </xs:appinfo>
+          	        </xs:annotation>  
         <xs:attribute name="thorQMonQueues" type="xs:string" use="optional" default="*">
             <xs:annotation>
                 <xs:appinfo>
@@ -490,6 +526,12 @@
         </xs:attribute>
     </xs:attributeGroup>
     <xs:attributeGroup name="DaFileSrvMonitor">
+             <!--5/15-GP-added-for-auto-doc-build-->
+                    <xs:annotation>
+                         <xs:appinfo>
+                            <docid>sh.t7</docid>
+                         </xs:appinfo>
+          	        </xs:annotation>  
         <xs:attribute name="dafsmonInterval" type="xs:nonNegativeInteger" default="0">
             <xs:annotation>
                 <xs:appinfo>

+ 36 - 0
initfiles/componentfiles/configxml/thor.xsd.in

@@ -25,6 +25,12 @@
       <xs:documentation>Describes a thor cluster</xs:documentation>
     </xs:annotation>
     <xs:complexType>
+                  <!--5/15-GP-added-for-auto-doc-build-->
+      	    		         <xs:annotation>
+      	    		                  <xs:appinfo>
+      	    		                      <docid>Th.t1</docid>
+      	    		                  </xs:appinfo>
+      			        </xs:annotation>  
       <xs:choice maxOccurs="unbounded">
         <xs:element name="ThorSpareProcess" minOccurs="0" maxOccurs="unbounded">
           <xs:annotation>
@@ -89,6 +95,13 @@
               <tooltip>Options for using SSH remote execution</tooltip>
             </xs:appinfo>
           </xs:annotation>
+          <xs:complexType> 
+                     <!--6/15-GP-added-for-auto-doc-build-->
+	  	  	<xs:annotation>
+	  	           <xs:appinfo>
+	  	        	<docid>Th.t3</docid>
+	  	            </xs:appinfo>
+	  	        </xs:annotation>  
           <xs:attribute name="SSHidentityfile" type="xs:string" default="$HOME/.ssh/id_rsa">
             <xs:annotation>
               <xs:appinfo>
@@ -125,6 +138,7 @@
               </xs:appinfo>
             </xs:annotation>
           </xs:attribute>
+          </xs:complexType>
         </xs:element>
         <xs:element name="Debug">
           <xs:annotation>
@@ -133,6 +147,12 @@
             </xs:appinfo>
           </xs:annotation>
           <xs:complexType>
+    <!--5/15-GP-added-for-auto-doc-build-->
+	  	 <xs:annotation>
+	  	    <xs:appinfo>
+	  	        <docid>Th.t2</docid>
+	  	    </xs:appinfo>
+	  	 </xs:annotation>  
             <xs:attribute name="dllsToSlaves" type="xs:boolean" use="optional" default="true">
               <xs:annotation>
                 <xs:appinfo>
@@ -163,6 +183,13 @@
               <tooltip>Options for automatic node swap</tooltip>
             </xs:appinfo>
           </xs:annotation>
+          <xs:complexType>
+            <!--6/15-GP-added-for-auto-doc-build-->
+	  	<xs:annotation>
+	  	  <xs:appinfo>
+	  	    <docid>Th.t4</docid>
+            </xs:appinfo>
+          </xs:annotation>
           <xs:attribute name="AutoSwapNode" type="xs:boolean" use="optional" default="false">
             <xs:annotation>
               <xs:appinfo>
@@ -226,6 +253,7 @@
               </xs:appinfo>
             </xs:annotation>
           </xs:attribute>
+          </xs:complexType>
         </xs:element>
         <xs:element name="Storage">
           <xs:annotation>
@@ -234,6 +262,13 @@
               <tooltip>Options for mirroring thor data</tooltip>
             </xs:appinfo>
           </xs:annotation>
+          <xs:complexType>
+            <!--6/15-GP-added-for-auto-doc-build-->
+	  	<xs:annotation>
+	  	  <xs:appinfo>
+	  	    <docid>Th.t5</docid>
+            </xs:appinfo>
+          </xs:annotation>
           <xs:attribute name="breakoutLimit" type="xs:nonNegativeInteger" use="optional" default="3600">
             <xs:annotation>
               <xs:appinfo>
@@ -248,6 +283,7 @@
               </xs:appinfo>
             </xs:annotation>
           </xs:attribute>
+          </xs:complexType>
         </xs:element>
         <xs:element name="Notes" maxOccurs="unbounded">
           <xs:annotation>