This is set to work with IDO docs, to avoid updating their config.

    <property name="doc.src.dir" location="${basedir}/docs/src" />

    <!-- Location of documentation API source.

    @type string

    @scope private

    -->

    <property name="api.doc.src.dir" location="${helium.dir}/doc/api" />

    <!-- A list of source paths for RST documentation to be built. -->

    <resources id="textdoc.paths">

        <path>

            <pathelement path="${doc.src.dir}"/>

        </path>

    </resources>

    <property name="doc.build.dir" location="${basedir}/build/doc" />

    <!-- A temp location for doc processing.

    @type string

    @scope private -->

    <property name="doc.temp.dir" location="${basedir}/build/temp/doc" />

    <!-- A temp location for doc processing.

    @type string

    @scope private -->

    <property name="doc_search.temp.dir" location="${basedir}/build/temp/doc_search" />

        <delete dir="${doc.build.dir}/api/helium"/>

        <delete dir="${doc.temp.dir}/api/helium"/>

        <mkdir dir="${doc.build.dir}/api/helium"/>

        <mkdir dir="${doc.temp.dir}/api/helium"/>

        <fmpp sourceRoot="${api.doc.src.dir}" includes="*.dot.ftl" outputRoot="${doc.temp.dir}/api/helium"

            <fileset dir="${doc.temp.dir}/api/helium" includes="*.dot"/>

                <exec executable="dot" dir="${doc.temp.dir}/api/helium">

                <exec executable="dot" dir="${doc.build.dir}/api">

        <move todir="${doc.build.dir}/api/helium" overwrite="true">

            <fileset dir="${doc.temp.dir}/api/helium" includes="*.dot.png"/>

        <mkdir dir="${doc.build.dir}/api/helium"/>

        <copy todir="${doc.temp.dir}/api/helium" overwrite="true">

            <fileset dir="${api.doc.src.dir}"/>

        <fmpp sourceRoot="${doc.temp.dir}/api/helium" excludes="*.dot.png,*.dot.ftl,**/*.dot,**/*.cmap,*.bak"

              outputRoot="${doc.build.dir}/api/helium"

            </data>

    <macrodef name="rstPrepMacro" uri="http://www.nokia.com/helium">

        <attribute name="destdir"/>

        <element name="resources-elements" implicit="yes"/>

        <sequential>

            <for param="dir">

                <resources-elements/>

                <sequential>

                    <echo>Copying textdocs source directory: @{dir}</echo>

                    <fmpp sourceRoot="@{dir}"

                          outputRoot="@{destdir}" removeExtensions="ftl"

                          modes="copy(**/*.rst, **/*.html)">

                        <data expandProperties="yes">

                            ant: antProperties()

                            project: antProject()

                        </data>

                    </fmpp>

                </sequential>

            </for>

        </sequential>

    </macrodef>

    <!-- Macro to generate HTML docs from rst. -->

        <attribute name="src" default="${doc.temp.dir}"/>

        <attribute name="output" default="${doc.build.dir}"/>

    <!-- Generate search index for apis -->

    <target name="apidocs-search">

        <echo>Convert API docs to .rst files</echo>

        <hlm:python>

import html2rest

import os

import codecs

#import traceback

for root, dirs, files in os.walk(r'${doc.build.dir}/api', topdown=False):

    for fname in files:

        if '.html' in fname:

            filename = os.path.abspath(os.path.join(root, fname))

            rstfilename = filename.replace('.html', '.rst')

            try:

                out = open(rstfilename, 'w')

                html2rest.html2rest(html2rest.readsoup(filename), out)

            except:

                #traceback.print_exc()

                print filename + ' failed to be converted to rst'

            finally:

                out.close()

            try:

                rstfile = codecs.open(rstfilename, 'r', 'utf8')

                rstfile.read()

            except:

                print rstfilename + ' has invalid unicode'

                rstfile.close()

                os.remove(rstfilename)

        </hlm:python>

        <move todir="${doc_search.temp.dir}" overwrite="true">

            <fileset dir="${doc.build.dir}/api">

                <include name="**/*.rst"/>

            </fileset>

        </move>

        <move todir="${doc.build.dir}/api_backup" overwrite="true">

            <fileset dir="${doc.build.dir}/api"/>

        </move>

        <hlm:rstPrepMacro destdir="${doc_search.temp.dir}">

            <resources>

                <path>

                    <pathelement path="${helium.dir}/doc/default"/>

                </path>

            </resources>

        </hlm:rstPrepMacro>

        <copy file="${api.doc.src.dir}/apisearchindex.rst" tofile="${doc_search.temp.dir}/index.rst" overwrite="true"/>

        <!--<copy todir="${doc_search.temp.dir}">

            <fileset refid="static.doc.files"/>

        </copy>

        <copy todir="${doc_search.temp.dir}" overwrite="true">

            <fileset dir="${helium.dir}/doc/src_search" includes="**/*"/>

        </copy>-->

        <hlm:rstMacro src="${doc_search.temp.dir}" output="${doc.build.dir}/api"/>

        <move todir="${doc.build.dir}/api" overwrite="true">

            <fileset dir="${doc.build.dir}/api_backup"/>

        </move>

    </target>

        <echo>Building docs into ${doc.build.dir}.</echo>

        <delete dir="${doc.build.dir}/.doctrees"/>

        <delete file="${doc.build.dir}/searchindex.json"/>

        <resources id="textdoc.all.paths">

            <!-- default doc content is always processed first -->

            <path>

                <pathelement path="${helium.dir}/doc/default"/>

            </path>

            <resources refid="textdoc.paths"/>

        </resources>

        <hlm:rstPrepMacro destdir="${doc.temp.dir}">

            <resources refid="textdoc.all.paths"/>    

        </hlm:rstPrepMacro>

    </target>

    <target name="build-textdocs-dot-images">

            <fileset dir="${doc.temp.dir}">

                <include name="**/*.dot"/>

                <exclude name="api/helium/**/*.dot"/>

            </fileset>

    <target name="build-textdocs">

        <copy file="${database.file}" todir="${doc.build.dir}"/>

    <target name="textdocs" depends="prep-textdocs,build-textdocs-dot-images,build-textdocs"/>

    <!-- Cleans only the RST text docs -->

    <target name="clean-textdocs">

        <mkdir dir="${doc.build.dir}"/>

        <mkdir dir="${doc.temp.dir}"/>

        <mkdir dir="${doc_search.temp.dir}"/>

        <delete includeemptydirs="true">

            <fileset dir="${doc.build.dir}">

                <include name="**/*"/>

                <exclude name="api/helium/**/*"/>

            </fileset>

            <fileset dir="${doc.temp.dir}"/>

            <fileset dir="${doc_search.temp.dir}"/>

        </delete>

    <!-- Cleans all documentation. -->

    <target name="clean-docs" depends="clean-helium-apidocs,clean-textdocs"/>