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

[André Bargull]

The XSL processor doesn't like °


On 9/25/2009 4:29 PM, André Bargull wrote:
> 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
>>
>>
>