&build-properties;

clean build dirs (including local deploy dir)

create unused doc zip - see ../build/build.xml for installer

deploy docs.dist.dir faq to web.doc.dir

deploy built faq and index to web.doc.dir

deploy README-11.html to the web site

deploy built docs to the web site

avoid local-dist antecedants if uptodate

finish products by copying dist files

javadoc for AspectJ lang, lang.reflect and org.aspectj.weaver.tools

build prog or dev guide, using guide.dir and guide.name

antcall(xml-source-dir, xml-source-root, xml-target-dir, xml-target-file) convert xml to html using docbook. parameters: xml-source-dir # base directory of source xml-source-root # base file of source (relative to xml-source-dir) xsl-source-file # xsl transform to apply (use chunk.xsl.source by default) xml-target-dir # target directory for output (used as xsl param base.dir) xml-target-file # full path to output file in xml-source-dir, ignored when chunking xml-html-copy # copy files to target (defaults to *.gif,*.png

misc info for writing and building docbook

---- misc info for writing and building docbook - link tag linkend attribute takes an id - xsl converts as needed during output - do NOT use ulink; this will be converted to "" (but see param citerefentry-link: might enable this)

- to use sensible names for the files produced, - use an xsl wrapper to add/modify features - set flag to use the id of the top-level element in the output file as the filename. xsl:param name="use.id.as.filename" select="1" - fyi, other related parameters: html-ext, root-filename - In this example, the top-level element in the output file is the refentry, so set ids which become the basename of the file: refentry id="aspectj-mode" # in aspectj-mode.xml, produces aspecj-mode.html refentry id="ajdee" # in ajdee.xml, produces ajdee.html

-- fyi - related parameters: html-ext, root-filename - these tags did not work for me: dbhtml filename="foo.htm" dbhtml prefix="foo-"

- resources - the dtd reference for docbook http://www.oreilly.com/catalog/docbook/chapter/book/docbook.html - the stylesheet reference for docbook xsl http://docbook.sourceforge.net/projects/dsssl/doc/html.html - todo - fyi, generate.reference.titlepage appears not to be respected. tried to add if statement to html/refentry.xsl, but file still gen'd