This is confusing, and calls for some serious spelunking.

in r588 on 5/17/06, I added this line to build-tools/build-opt.xml:
<property name="skip.doc" value="true" />
in order to turn off even attempting the doc build while it was broken.

In r1193 on 6/28/06, I fixed the reference build.

In r1259 on 7/05/06, I checked in the last of a series of changes  
which fixed the doc build in trunk, including reference, developer's  
guide, and deployer's guide.

In r1418 on 7/27/06, I made the main build.xml respect the value of  
skip.doc; if skip.doc is defined, we skip building the doc. skip.doc  
had been defined since r588. This is the simple answer to "why isn't  
doc building in the nightlies?"

Now, in my sandbox in trunk, I  removed <property name="skip.doc"  
value="true" />   from build-tools/build-opt.xml, and it is (sort of  
predictably) failing because video and CSS don't meet the stringent  
requirements of the doctools. (Actually it is hanging forever, which  
Jim has told me is an infinite loop that indicates a major doctools  
error.)

The build.docs.error.fail property is a horse of a different color.  
We're not even getting up to it.


Upshot: CSS and video fail the doctools.




**odd note: in ant, properties are either defined or undefined.  
Guards on targets of the form unless="foo.bar" and if="foo.bar"  
considers foo.bar to be true if it is defined, regardless of its  
value. So, if you have
<property name="likes.chocolate" value="false" />
and you have a target
<target name="eat-mocha-cake" if="likes.chocolate">
then you will eat the mocha cake. The way to not eat the mocha cake  
is to not define likes.chocolate. Lovely, isn't it?


_______________________________________________
Laszlo-dev mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-dev

Reply via email to