On Sep 20, 2006, at 1:24 PM, Benjamin Shine wrote: > 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.) > Well, no, that was in Legals where it hung forever because it was completely failing to parse any class definitions. I think this is a different failure mode.
It's easy enough to fix the missing doc errors in trunk, though. I believe that means there are no wrapper pages for those classes. I can add them > 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. > > OK. Since I'm in doctool mode, I'll take on the task of getting things going again. I'll simply remove <property name="skip.doc" value="true" /> from build-tools/build-opt.xml and get started on adding in basic wrappers. jim > > > **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 _______________________________________________ Laszlo-dev mailing list [email protected] http://www.openlaszlo.org/mailman/listinfo/laszlo-dev
