Cleanup documentation build

git-svn-id: https://brutex.net/svn/xservices/trunk@62 e7e49efb-446e-492e-b9ec-fcafc1997a86
tag-20130205r
Brian Rosenberger 2011-05-02 18:10:49 +00:00
parent 2aaf50fca1
commit 2e99ff8f80
1 changed files with 37 additions and 71 deletions

View File

@ -1,71 +1,37 @@
<?xml version="1.0" encoding="UTF-8"?> <?xml version="1.0"?>
<!-- You may freely edit this file. See commented blocks below for --> <project default="create-doc" basedir=".">
<!-- some examples of how to customize the build. -->
<!-- (If you delete it and reopen the project it will be recreated.) -->
<!-- By default, only the Clean and Build commands use this build script. -->
<!-- Commands such as Run, Debug, and Test only use this build script if -->
<!-- the Compile on Save feature is turned off for the project. -->
<!-- You can turn off the Compile on Save (or Deploy on Save) setting -->
<!-- in the project's Project Properties dialog box.-->
<project name="XServices" default="default" basedir=".">
<description>Builds, tests, and runs the project XServices.</description>
<import file="nbproject/build-impl.xml"/>
<!--
There exist several targets which are by default empty and which can be <property name="current-loc" location="." />
used for execution of your tasks. These targets are usually executed <property name="workspace" location=".." />
before and after some main targets. They are: <property name="htmldir" value="${current-loc}/doc/html" />
<property name="docbookdir" value="C:\JAVA-DEV\docbook-xsl-ns-1.76.1\html\" />
-pre-init: called before initialization of project properties <property name="docbooksource" value="${current-loc}/doc"/>
-post-init: called after initialization of project properties <property name="xalan" value="org.apache.xalan.processor.TransformerFactoryImpl" />
-pre-compile: called before javac compilation
-post-compile: called after javac compilation
-pre-compile-single: called before javac compilation of single file
-post-compile-single: called after javac compilation of single file
-pre-compile-test: called before javac compilation of JUnit tests
-post-compile-test: called after javac compilation of JUnit tests
-pre-compile-test-single: called before javac compilation of single JUnit test
-post-compile-test-single: called after javac compilation of single JUunit test
-pre-dist: called before archive building
-post-dist: called after archive building
-post-clean: called after cleaning build products
-pre-run-deploy: called before deploying
-post-run-deploy: called after deploying
Example of pluging an obfuscator after the compilation could look like
<target name="-post-compile">
<obfuscate>
<fileset dir="${build.classes.dir}"/>
</obfuscate>
</target>
For list of available properties check the imported
nbproject/build-impl.xml file.
Other way how to customize the build is by overriding existing main targets. <!-- XSLT Chunking Properties -->
The target of interest are: <property name="base.dir" value="${htmldir}"/>
init-macrodef-javac: defines macro for javac compilation <target name="merge">
init-macrodef-junit: defines macro for junit execution <xsl.xinclude in="${docbooksource}/BruteXServices_User_Guide.xml"
init-macrodef-debug: defines macro for class debugging out="${docbooksource}/BruteXServices_User_Guide.dbk"
do-dist: archive building />
run: execution of project </target>
javadoc-build: javadoc generation
Example of overriding the target for project execution could look like <target name="clean-doc">
<delete dir="${htmldir}" />
<mkdir dir="${htmldir}"/>
</target>
<target name="run" depends="<PROJNAME>-impl.jar"> <target name="create-doc" depends="clean-doc, merge">
<exec dir="bin" executable="launcher.exe">
<arg file="${dist.jar}"/>
</exec>
</target>
Notice that overridden target depends on jar target and not only on <xslt force="true" style="${docbookdir}/../toHTML.xsl"
compile target as regular run target does. Again, for list of available in="${docbooksource}/BruteXServices_User_Guide.dbk"
properties which you can use check the target you are overriding in out="${htmldir}/index.html">
nbproject/build-impl.xml file. <factory name="${xalan}" />
<param name="base.dir" expression="${htmldir}/"/>
<param name="use.id.as.filename" expression="1" />
</xslt>
</target>
-->
</project> </project>