Change 20061205-jgrandyw-V by [EMAIL PROTECTED] on 2006-12-05
08:39:44 PST
in /Users/jgrandyw/dev/svn/openlaszlo/branches/legals2
Summary:Clean up and turn on LFC reference. Building the LFC now also
runs js2doc and builds the docbook documentation. The HTML documentation
is now built as well, but only as part of 'ant doc'. The docbook docs
are quick
enough (3 secs on my machine) that they can be part of the regular
build.
Bugs Fixed:
Technical Reviewer: ben
QA Reviewer: ptw
Doc Reviewer: jsundman
Details:Building 'ant doc' in WEB-INF/lps/lfc builds the .dbk version
of the LFC reference docs. Added the 'doc' target to 'build' in that
directory so that it is routinely built whenever the LFC is built.
The actual HTML documentation is built in a separate step from docs/
src into docs/reference, and only triggered by a full docs build or
by 'ant reference' in docs/src. The build targets that were in docs/
src/build-lfc.xml have been merged into either WEB-INF/lps/lfc/
build.xml or docs/src/build.xml and that file is being deleted.
Note that the js2doc build requires Java 1.5, but (at least on my
machine) does not fail if you try to build using Java 1.4 -- it just
doesn't generate the reference.
Also change js2doc to generate runtime and build flags more
explicitly so they are easier to digest by XSLT. And the usual
smattering of changes to js2doc2dbk.xsl itself, supposedly improving
formatting and layout although it's still pretty darn weird looking.
Tests:'ant clean build doc' in both Java1.5 and Java1.4.
Files:
M docs/src/build.xml
D docs/src/build-lfc.xml
M docs/src/xsl/js2doc2dbk.xsl
M build-tools/build-opt.xml
M WEB-INF/lps/lfc/kernel/svg/LFC.js
M WEB-INF/lps/lfc/kernel/dhtml/LzRequires.js
M WEB-INF/lps/lfc/kernel/dhtml/LzKeyboardKernel.js
M WEB-INF/lps/lfc/kernel/dhtml/LzSprite.js
M WEB-INF/lps/lfc/kernel/dhtml/LzMouseKernel.js
M WEB-INF/lps/lfc/kernel/dhtml/LzPool.js
M WEB-INF/lps/lfc/kernel/dhtml/LzInputTextSprite.js
M WEB-INF/lps/lfc/kernel/dhtml/LzTextSprite.js
M WEB-INF/lps/lfc/kernel/LzIdleKernel.lzs
M WEB-INF/lps/lfc/kernel/LzRequires.lzs
M WEB-INF/lps/lfc/core/LzNode.lzs
M WEB-INF/lps/lfc/build.xml
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/tests/
test_include.xml
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/tests/
unitcomment.xml
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/tests/
unitcomment2.xml
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/tests/
LaszloEvents.xml
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/tests/shortest.xml
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/tests/
simplecomment.xml
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/JS2Doc_Test.java
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/
ConditionalState.java
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/JS2Doc.java
M WEB-INF/lps/server/src/org/openlaszlo/js2doc/js2doc.rnc
M WEB-INF/lps/server/build.xml
Changeset: http://svn.openlaszlo.org/openlaszlo/patches/20061205-
jgrandyw-V.tar
