I'm trying to build the reference guide on my Windows machine, but
somehow the reference pages for the components aren't generated. The
reference pages for the LFC are generated, though. I've tried both "ant
clean reference" and "ant clean reference -DQUICK=true", no difference
here. At some point last year it was possible for me to generate the
reference pages for the components, because back then I worked on the
drawview pages.
I've made so far the following changes:
- commented out the "skip.doc.reference" entry in build-tools/build-opt.xml
- commented out the "reference.skip" condition in docs/src/build.xml
- changed the xsl:variable "programsource" to use a file:/// url in
docs/scr/xsl/dbkpreprocessexamples.xsl
- added xmlns:redirect="http://xml.apache.org/xalan/redirect"; because
xmlns:xalanredirect="org.apache.xalan.xslt.extensions.Redirect" doesn't
work for me in docs/scr/xsl/js2doc-comment2dbk.xsl
- converted \ in paths to / in toccheck.rb, navxmlbuilder.rb,
postprocess.rb (mixed paths don't work in ruby?)
There are entries for the components in
docs/src/build/reference/components{-raw}.xml and
doctestLaszloLibrary-{2,3,4,5,verbose}.js2doc. But I'm not sure whether
these entries are valid, so maybe someone can send these files, so I can
check them.
- André
