[Laszlo-dev] Trunk doc build broken [Was: FAILURE for 14837-openlaszlo-trunk on linux-builder.corp.laszlosystems.com]

[André Bargull]

This seems to be the root cause for the failure:

> lzx2js2doc.transform:
>     [style] Processing \src\svn\openlaszlo\trunk\lps\components\doctest-library.lzx to 
> \src\svn\openlaszlo\trunk\docs\src\build\reference\components-raw.xml
>     [style] Loading stylesheet \src\svn\openlaszlo\trunk\docs\src\xsl\lzx2js2doc.xsl
>     [style] /src/svn/openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl:77:60: Warning! Angeforderte Do
> kumentation kann nicht geladen werden: Invalid byte 1 of 1-byte UTF-8 sequence.


To shorten the reference build, I've changed 
"components/doctest-library.lzx" to only include drawview and then 
called 'ant -DQUICK=true components.js2doc.generate'.


On 9/25/2009 3:20 PM, P T Withington wrote:
> 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, svnbuild at laszlosystems.com 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
>>>>> Laszlo-builds at openlaszlo.org
>>>>> http://www.openlaszlo.org/mailman/listinfo/laszlo-builds
>>>>
>>
>> -- 
>> Regards,
>> Max Carlson
>> OpenLaszlo.org
> 
>