This is an automated email from the ASF dual-hosted git repository. aharui pushed a commit to branch develop in repository https://gitbox.apache.org/repos/asf/royale-asjs.git
commit 803f071fa3c2ebb8bf0f2e9966a2ff45095f2c8b Author: Alex Harui <[email protected]> AuthorDate: Mon Jun 17 11:00:29 2019 -0700 get asdoc to build with most if not all projects --- examples/royale/ASDoc/build.xml | 39 ++++++++++++--- .../ASDoc/src/main/config/asdoc-js-config.xml | 58 ++++++++++++++++++---- .../ASDoc/src/main/config/asdoc-swf-config.xml | 58 ++++++++++++++++++++-- 3 files changed, 133 insertions(+), 22 deletions(-) diff --git a/examples/royale/ASDoc/build.xml b/examples/royale/ASDoc/build.xml index 410262f..a33a27b 100644 --- a/examples/royale/ASDoc/build.xml +++ b/examples/royale/ASDoc/build.xml @@ -78,20 +78,22 @@ <target name="json" unless="json.exists" > <echo message="ROYALE_COMPILER_HOME: ${ROYALE_COMPILER_HOME}"/> - <java jar="${ROYALE_COMPILER_HOME}/lib/asdoc.jar" resultProperty="errorCode" + <java jar="${ROYALE_COMPILER_HOME}/lib/asdoc.jar" resultProperty="errorCodeJS" fork="true"> <jvmarg line="${mxmlc.jvm.args}"/> <jvmarg line="-Droyalelib='${ROYALE_HOME}/frameworks'"/> <arg value="+royalelib=${ROYALE_HOME}/frameworks" /> <arg value="-external-library-path=${ROYALE_HOME}/js/libs/js.swc" /> - <arg value="-external-library-path=${ROYALE_HOME}/js/libs/GCL.swc" /> - <arg value="-external-library-path=${ROYALE_HOME}/js/libs/createjs.swc" /> - <arg value="-external-library-path=${ROYALE_HOME}/js/libs/jquery.swc" /> - <arg value="-external-library-path=${ROYALE_HOME}/js/libs/icons.swc" /> - <arg value="-external-library-path=${ROYALE_HOME}/js/libs/jewel.swc" /> + <arg value="-external-library-path+=${ROYALE_HOME}/js/libs/ace-1.2.3.swc" /> + <arg value="-external-library-path+=${ROYALE_HOME}/js/libs/cordova.swc" /> + <arg value="-external-library-path+=${ROYALE_HOME}/js/libs/GCL.swc" /> + <arg value="-external-library-path+=${ROYALE_HOME}/js/libs/createjs.swc" /> + <arg value="-external-library-path+=${ROYALE_HOME}/js/libs/jquery.swc" /> <arg value="-external-library-path+=${ROYALE_HOME}/js/libs/google_maps.swc" /> <arg value="+frameworks_dir=${ROYALE_HOME}/frameworks" /> <arg value="-load-config=${config.path}" /> + <arg value="-compiler.define+=ROYALE::DISPLAYOBJECT,IUIComponent" /> + <arg value="-compiler.define+=GOOG::DEBUG,goog.DEBUG" /> <arg value="-debug=true" /> <arg value="-output=${basedir}/bin-debug" /> <arg value="-window-title=Apache Royale API Reference" /> @@ -102,12 +104,21 @@ <arg value="-js-output-type=ROYALE" /> <arg value="-closure-lib=${GOOG_HOME}" /> </java> - + <fail> + <condition> + <not> + <or> + <equals arg1="${errorCodeJS}" arg2="0" /> + <equals arg1="${errorCodeJS}" arg2="2" /> + </or> + </not> + </condition> + </fail> </target> <target name="json.swf" unless="json.exists" > <echo message="ROYALE_COMPILER_HOME: ${ROYALE_COMPILER_HOME}"/> - <java jar="${ROYALE_COMPILER_HOME}/lib/asdoc.jar" resultProperty="errorCode" + <java jar="${ROYALE_COMPILER_HOME}/lib/asdoc.jar" resultProperty="errorCodeSWF" fork="true"> <jvmarg line="${mxmlc.jvm.args}"/> <jvmarg line="-Droyalelib='${ROYALE_HOME}/frameworks'"/> @@ -116,6 +127,8 @@ <arg value="-external-library-path+=${ROYALE_HOME}/js/libs/google_maps.swc" /> <arg value="+frameworks_dir=${ROYALE_HOME}/frameworks" /> <arg value="-load-config=${config.swf.path}" /> + <arg value="-compiler.define+=GOOG::DEBUG,true" /> + <arg value="-compiler.define+=ROYALE::DISPLAYOBJECT,DisplayObject" /> <arg value="-debug=true" /> <arg value="-output=${basedir}/bin-debug" /> <arg value="-window-title=Apache Royale API Reference" /> @@ -126,6 +139,16 @@ <arg value="-js-output-type=ROYALE" /> <arg value="-closure-lib=${GOOG_HOME}" /> </java> + <fail> + <condition> + <not> + <or> + <equals arg1="${errorCodeSWF}" arg2="0" /> + <equals arg1="${errorCodeSWF}" arg2="2" /> + </or> + </not> + </condition> + </fail> </target> <target name="examine" depends="build_example.get.browser"> diff --git a/examples/royale/ASDoc/src/main/config/asdoc-js-config.xml b/examples/royale/ASDoc/src/main/config/asdoc-js-config.xml index fe362b4..a720ac6 100644 --- a/examples/royale/ASDoc/src/main/config/asdoc-js-config.xml +++ b/examples/royale/ASDoc/src/main/config/asdoc-js-config.xml @@ -41,7 +41,7 @@ <!-- Specifies the locales for internationalization. --> <locale> - <locale-element>en_US</locale-element> + <!--<locale-element>en_US</locale-element>--> </locale> <!-- List of path elements that form the roots of ActionScript class hierarchies. --> @@ -52,7 +52,7 @@ </source-path> --> <source-path> - <!-- <path-element>${frameworks_dir}/projects/Ace/src/main/royale</path-element> --> + <path-element>${frameworks_dir}/projects/Ace/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Basic/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Binding/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Charts/src/main/royale</path-element> @@ -72,9 +72,9 @@ <path-element>${frameworks_dir}/projects/Icons/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Jewel/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/JQuery/src/main/royale</path-element> - <!-- <path-element>${frameworks_dir}/projects/Language/src/main/royale</path-element> --> + <path-element>${frameworks_dir}/projects/Language/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/MaterialDesignLite/src/main/royale</path-element> - <!-- <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale</path-element> --> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Mobile/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Network/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Reflection/src/main/royale</path-element> @@ -146,10 +146,14 @@ <!-- namespace declaration for asdoc --> <namespaces> - <!-- <namespace> + <namespace> + <uri>http://ns.adobe.com/mxml/2009</uri> + <manifest>${frameworks_dir}/mxml-2009-manifest.xml</manifest> + </namespace> + <namespace> <uri>library://ns.apache.org/royale/ace</uri> <manifest>${frameworks_dir}/projects/Ace/src/main/resources/ace-manifest.xml</manifest> - </namespace> --> + </namespace> <namespace> <uri>library://ns.apache.org/royale/basic</uri> <manifest>${frameworks_dir}/projects/Basic/src/main/resources/basic-manifest.xml</manifest> @@ -222,10 +226,10 @@ <uri>library://ns.apache.org/royale/mdl</uri> <manifest>${frameworks_dir}/projects/MaterialDesignLite/src/main/resources/mdl-manifest.xml</manifest> </namespace> - <!-- <namespace> + <namespace> <uri>library://ns.apache.org/royale/mx</uri> <manifest>${frameworks_dir}/projects/MXRoyale/src/main/resources/mx-royale-manifest.xml</manifest> - </namespace> --> + </namespace> <namespace> <uri>library://ns.apache.org/royale/basic</uri> <manifest>${frameworks_dir}/projects/Mobile/src/main/resources/basic-manifest.xml</manifest> @@ -568,9 +572,35 @@ <path-element>${frameworks_dir}/projects/Basic/src/main/royale/org/apache/royale/html/supportClasses/VScrollBar.as</path-element> <path-element>${frameworks_dir}/projects/Basic/src/main/royale/org/apache/royale/html/supportClasses/HScrollBar.as</path-element> <path-element>${frameworks_dir}/projects/Basic/src/main/royale/org/apache/royale/html/supportClasses/ScrollBar.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/supportClasses/scrollbar/VScrollBar.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/supportClasses/scrollbar/HScrollBar.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/supportClasses/scrollbar/ScrollBar.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/beads/models/ScrollBarModel.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/beads/views/ButtonView.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/beads/views/CheckBoxView.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/beads/views/RadioButtonView.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/beads/views/TextFieldView.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/beads/views/SliderTrackView.as</path-element> + <path-element>${frameworks_dir}/projects/Jewel/src/main/royale/org/apache/royale/jewel/beads/views/SliderThumbView.as</path-element> <path-element>${frameworks_dir}/projects/Formatters/src/main/royale/org/apache/royale/html/beads/FormatableTextInputView.as</path-element> <path-element>${frameworks_dir}/projects/Formatters/src/main/royale/org/apache/royale/html/beads/FormatableLabelView.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/core/IDisplayObjectInterface.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/controls/beads/RadioButtonView.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/controls/beads/CheckBoxView.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/controls/beads/CSSImageAndTextButtonView.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/FillStrokeStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/GapStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/ItemRendererStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/LeadingStyle.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/MarginStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/TextStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/skins/halo/SelectionSkin.as</path-element> + <!--<path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/effects/Parallel.as</path-element>--> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/effects/effectClasses/ParallelInstance.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/events/ResourceEvent.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/utils/RPCObjectUtil.as</path-element> <path-element>${frameworks_dir}/projects/GoogleMaps/src/main/royale/org/apache/royale/maps/google/beads/MapView_original.as</path-element> + <path-element>${frameworks_dir}/projects/Storage/src/main/royale/org/apache/royale/storage/file/LocalFile.as</path-element> </exclude-sources> <!-- source path for asdoc --> @@ -584,10 +614,14 @@ <uri>library://ns.apache.org/royale/google</uri> <uri>library://ns.apache.org/royale/html5</uri> <uri>library://ns.apache.org/royale/jquery</uri> + <uri>library://ns.apache.org/royale/mx</uri> + <uri>library://ns.apache.org/royale/spark</uri> </doc-namespaces> <!-- classes to include in asdoc --> <doc-sources> + <path-element>${frameworks_dir}/projects/Ace/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/Basic/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Binding/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Charts/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Collections/src/main/royale</path-element> @@ -599,15 +633,21 @@ <path-element>${frameworks_dir}/projects/Formatters/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/GoogleMaps/src/main/royale/org</path-element> <path-element>${frameworks_dir}/projects/Graphics/src/main/royale</path-element> - <path-element>${frameworks_dir}/projects/Basic/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/HTML/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/HTML5/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Icons/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Jewel/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/JQuery/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/MaterialDesignLite/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Mobile/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Network/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Reflection/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/RoyaleUnit/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/SparkRoyale/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/Storage/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/TLF/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/Text/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/GoogleMaps/src/main/royale/google/maps/LatLng.as</path-element> </doc-sources> diff --git a/examples/royale/ASDoc/src/main/config/asdoc-swf-config.xml b/examples/royale/ASDoc/src/main/config/asdoc-swf-config.xml index 4c625e7..b6eccd6 100644 --- a/examples/royale/ASDoc/src/main/config/asdoc-swf-config.xml +++ b/examples/royale/ASDoc/src/main/config/asdoc-swf-config.xml @@ -41,7 +41,7 @@ <!-- Specifies the locales for internationalization. --> <locale> - <locale-element>en_US</locale-element> + <!--<locale-element>en_US</locale-element>--> </locale> <!-- List of path elements that form the roots of ActionScript class hierarchies. --> @@ -52,7 +52,7 @@ </source-path> --> <source-path> - <!-- <path-element>${frameworks_dir}/projects/Ace/src/main/royale</path-element> --> + <path-element>${frameworks_dir}/projects/Ace/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Basic/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Binding/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Charts/src/main/royale</path-element> @@ -72,9 +72,8 @@ <path-element>${frameworks_dir}/projects/Icons/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Jewel/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/JQuery/src/main/royale</path-element> - <!-- <path-element>${frameworks_dir}/projects/Language/src/main/royale</path-element> --> <path-element>${frameworks_dir}/projects/MaterialDesignLite/src/main/royale</path-element> - <!-- <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale</path-element> --> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Mobile/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Network/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Reflection/src/main/royale</path-element> @@ -147,6 +146,10 @@ <!-- namespace declaration for asdoc --> <namespaces> <namespace> + <uri>http://ns.adobe.com/mxml/2009</uri> + <manifest>${frameworks_dir}/mxml-2009-manifest.xml</manifest> + </namespace> + <namespace> <uri>library://ns.apache.org/royale/basic</uri> <manifest>${frameworks_dir}/projects/Basic/src/main/resources/basic-manifest.xml</manifest> </namespace> @@ -219,10 +222,34 @@ <manifest>${frameworks_dir}/projects/Mobile/src/main/resources/basic-manifest.xml</manifest> </namespace> <namespace> + <uri>library://ns.apache.org/royale/mx</uri> + <manifest>${frameworks_dir}/projects/MXRoyale/src/main/resources/mx-royale-manifest.xml</manifest> + </namespace> + <namespace> <uri>library://ns.apache.org/royale/basic</uri> <manifest>${frameworks_dir}/projects/Network/src/main/resources/basic-manifest.xml</manifest> </namespace> <namespace> + <uri>library://ns.apache.org/royale/basic</uri> + <manifest>${frameworks_dir}/projects/Reflection/src/main/resources/basic-manifest.xml</manifest> + </namespace> + <namespace> + <uri>library://ns.apache.org/royale/spark</uri> + <manifest>${frameworks_dir}/projects/SparkRoyale/src/main/resources/spark-royale-manifest.xml</manifest> + </namespace> + <namespace> + <uri>library://ns.apache.org/royale/basic</uri> + <manifest>${frameworks_dir}/projects/Storage/src/main/resources/basic-manifest.xml</manifest> + </namespace> + <namespace> + <uri>library://ns.apache.org/royale/basic</uri> + <manifest>${frameworks_dir}/projects/TLF/src/main/resources/basic-manifest.xml</manifest> + </namespace> + <namespace> + <uri>library://ns.apache.org/royale/basic</uri> + <manifest>${frameworks_dir}/projects/Text/src/main/resources/basic-manifest.xml</manifest> + </namespace> + <namespace> <uri>library://ns.apache.org/royale/svg</uri> <manifest>${frameworks_dir}/projects/Basic/src/main/resources/svg-manifest.xml</manifest> </namespace> @@ -490,9 +517,22 @@ <exclude-sources> <path-element>${frameworks_dir}/projects/Language/src/main/royale/org/apache/royale/utils/Language.as</path-element> + <path-element>${frameworks_dir}/projects/Language/src/main/royale/Namespace.as</path-element> + <path-element>${frameworks_dir}/projects/Language/src/main/royale/QName.as</path-element> <path-element>${frameworks_dir}/projects/Core/src/main/royale/org/apache/royale/core/WrappedHTMLElement.as</path-element> <path-element>${frameworks_dir}/projects/Core/src/main/royale/org/apache/royale/events/BrowserEvent.as</path-element> <path-element>${frameworks_dir}/projects/GoogleMaps/src/main/royale/org/apache/royale/maps/google/beads/MapView_original.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/core/IDisplayObjectInterface.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/FillStrokeStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/GapStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/ItemRendererStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/LeadingStyle.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/MarginStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/styles/metadata/TextStyles.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/charts/skins/halo/SelectionSkin.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/effects/effectClasses/ParallelInstance.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/events/ResourceEvent.as</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale/mx/utils/RPCObjectUtil.as</path-element> </exclude-sources> <!-- source path for asdoc --> @@ -506,10 +546,13 @@ <uri>library://ns.apache.org/royale/google</uri> <uri>library://ns.apache.org/royale/html5</uri> <uri>library://ns.apache.org/royale/jquery</uri> + <uri>library://ns.apache.org/royale/mx</uri> + <uri>library://ns.apache.org/royale/spark</uri> </doc-namespaces> <!-- classes to include in asdoc --> <doc-sources> + <path-element>${frameworks_dir}/projects/Basic/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Binding/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Charts/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Collections/src/main/royale</path-element> @@ -521,15 +564,20 @@ <path-element>${frameworks_dir}/projects/Formatters/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/GoogleMaps/src/main/royale/org</path-element> <path-element>${frameworks_dir}/projects/Graphics/src/main/royale</path-element> - <path-element>${frameworks_dir}/projects/Basic/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/HTML/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/HTML5/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Icons/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Jewel/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/JQuery/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Mobile/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/MXRoyale/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Network/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/Reflection/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/RoyaleUnit/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/SparkRoyale/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/Storage/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/TLF/src/main/royale</path-element> + <path-element>${frameworks_dir}/projects/Text/src/main/royale</path-element> <path-element>${frameworks_dir}/projects/GoogleMaps/src/main/royale/google/maps/LatLng.as</path-element> </doc-sources>
