Henry has an option where in docs/src you can say `ant -DQUICK=true
reference` which makes the doc build only look at lfc/
doctestLaszloLibrary and components/doctest-library. Make sure the
files you are trying to debug are listed in those test libraries. It
makes the doc build take less than 3 hours (hopefully on the order of
10 minutes or so).
Beyond that, I have no hints other than digging in.
The doc system is simpler than it used to be, but still not too
simple. <sigh />
There is usually a hint in the output of the ant file, the problem is,
it is not always a fatal error. Sometimes it will output something
that seems innocuous, but that in actuality is screwing the whole
thing. Try inspecting the output of the above command and look for
anything at all suspicious.
Oh, and, I guess we should have a rule: If you are adding new code,
or editing the doc, please make sure the doc build will pass before
you check in! (It should be sufficient to check that your stuff
passes the QUICK build, if you want to take a shortcut; but you are on
the hook to fix it if it breaks the build...)
On 2009-09-25, at 09:03, Max Carlson wrote:
Hmm - I've fiddled with this quite a bit and the only thing that
makes the doc build successfully is removing the two new functions
__roundrectFactors() and __getRoundRectFactors(). I tried adding
them t the interface, tried removing their docs and nothing works.
How are we supposed to debug doc build issues like this? I don't
see any errors, but lz.drawview.html fails to build - it just isn't
there.
I'm about to go to bed, so I'm going to hand this off to André...
Max Carlson wrote:
r14823 worked fine. I'm 95% sure this was caused by r14824 -
André's change to drawview. I'm guessing this this line is
confusing the doc system:
+ // @devnote mixins can't have static members (at least in
AS3),
Testing now...
P T Withington wrote:
The trunk nightly is broken:
[exec] Error: broken link in doc navigation: lz.drawview.html
referenced from toc.xml does not exist
...
[exec] Error: docs/src/nav/toc.xml is out of date, see broken
link messages above
I suspect due to Max's recent changes to drawview. Unless someone
else has been fiddling with documentation lately?
On 2009-09-24, at 05:07, [email protected] wrote:
2009-09-24 02:07:14 PDT: FAILURE for 14837-openlaszlo-trunk with
build return code 1 on linux-builder.corp.laszlosystems.com
(Deploy return code -1; Megatest , -1) attaching /home/svnbuild/
logs/tail-14837-trunk-nightly.log
<tail-14837-trunk-nightly.log>
_______________________________________________
Laszlo-builds mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-builds
--
Regards,
Max Carlson
OpenLaszlo.org
