[Laszlo-dev] doc build fails

[Matt Wilde]

At some point, the example gets moved from being inline in DocBook to 
it's own separate file. Perhaps the copy operation is also copying the 
example code into a separate file and replacing with the file reference?

P T Withington wrote:
> Oh, ah.  And you can't have nested CDATA's.  The error is showing up 
> in some step called [copy]?  Why would a copy operation even be 
> inspecting the file it is copying?
>
> On 2008-06-25, at 16:17 EDT, Matt Wilde wrote:
>
>> Well, the example is in a CDATA so that DocBook doesn't read it. 
>> However, it still needs to be escaped when it hits LZX, since it's 
>> not in a CDATA when it gets translated into a code sample.
>>
>> P T Withington wrote:
>>> Don't know if its a bug, but why are you using & in CDATA?  The 
>>> point of CDATA is that you don't have to escape &.
>>>
>>> On 2008-06-25, at 14:18 EDT, Matt Wilde wrote:
>>>
>>>> It seems the compiler is tripping over && in a CDATA section.
>>>>
>>>> Here's the example in the code:
>>>> * <example><programlisting><![CDATA[
>>>> * <canvas height="100">
>>>> *   <simplelayout inset="10" spacing="10"/>
>>>> *
>>>> *   <checkbox>Lock mouse events
>>>> *     <handler name="onvalue">
>>>> *       if (this.value){
>>>> *         lz.ModeManager.globalLockMouseEvents();
>>>> *       }
>>>> *     </handler>
>>>> *
>>>> *     <handler name="onclick" reference="LzGlobalMouse" args="who">
>>>> *       //need to use LzGlobalMouse, since we don't get clicks if 
>>>> we're
>>>> *       //checked. Note: LzGlobalMouse sends its events before the 
>>>> view
>>>> *       //receives the events, so we can just unlock it here, and the
>>>> *       //checkbox can do its normal onclick handling.
>>>> *       if (this.value &amp;&amp; who == this){
>>>> *         lz.ModeManager.globalUnlockMouseEvents();
>>>> *       }
>>>> *     </handler>
>>>> *   </checkbox>
>>>> *
>>>> *   <button>click me!</button>
>>>> *
>>>> *   <text resize="true">
>>>> *     <method name="showEvent" args="what, who">
>>>> *       this.format("%s: %w", what, who);
>>>> *     </method>
>>>> *
>>>> *     <handler name="onmouseover" 
>>>> reference="<em>LzGlobalMouse</em>" args="who">
>>>> *       this.showEvent("mouseover" , who);
>>>> *     </handler>
>>>> *     <handler name="onmouseout" reference="<em>LzGlobalMouse</em>" 
>>>> args="who">
>>>> *       this.showEvent("mouseout" , who);
>>>> *     </handler>
>>>> *
>>>> *     <handler name="onmousedown" 
>>>> reference="<em>LzGlobalMouse</em>" args="who">
>>>> *       this.showEvent("mousedown" , who);
>>>> *     </handler>
>>>> *     <handler name="onmouseup" reference="<em>LzGlobalMouse</em>" 
>>>> args="who">
>>>> *       this.showEvent("mouseup" , who);
>>>> *     </handler>
>>>> *
>>>> *     <handler name="onclick" reference="<em>LzGlobalMouse</em>" 
>>>> args="who">
>>>> *       this.showEvent("mouseclick" , who);
>>>> *     </handler>
>>>> *   </text>
>>>> * </canvas>
>>>> * ]]></programlisting></example>
>>>>
>>>> And here's the example once the compiler is done with it:
>>>>
>>>> <canvas height="100">
>>>> <simplelayout inset="10" spacing="10"/>
>>>>
>>>> <checkbox>Lock mouse events
>>>>   <handler name="onvalue">
>>>>     if (this.value){
>>>>       lz.ModeManager.globalLockMouseEvents();
>>>>     }
>>>>   </handler>
>>>>
>>>>   <handler name="onclick" reference="LzGlobalMouse" args="who">
>>>>     //need to use LzGlobalMouse, since we don't get clicks if we're
>>>>     //checked. Note: LzGlobalMouse sends its events before the view
>>>>     //receives the events, so we can just unlock it here, and the
>>>>     //checkbox can do its normal onclick handling.
>>>>     if (this.value &amp;ampamp; who == this){
>>>>       lz.ModeManager.globalUnlockMouseEvents();
>>>>     }
>>>>   &lt;/handler>
>>>> </checkbox>
>>>>
>>>> <button>click me!</button>
>>>>
>>>> <text resize="true">
>>>>   <method name="showEvent" args="what, who">
>>>>     this.format("%s: %w", what, who);
>>>>   </method>
>>>>
>>>>   <handler name="onmouseover" reference="<em>LzGlobalMouse</em>" 
>>>> args="who">
>>>>     this.showEvent("mouseover" , who);
>>>>   </handler>
>>>>   <handler name="onmouseout" reference="<em>LzGlobalMouse</em>" 
>>>> args="who">
>>>>     this.showEvent("mouseout" , who);
>>>>   </handler>
>>>>
>>>>   <handler name="onmousedown" reference="<em>LzGlobalMouse</em>" 
>>>> args="who">
>>>>     this.showEvent("mousedown" , who);
>>>>   </handler>
>>>>   <handler name="onmouseup" reference="<em>LzGlobalMouse</em>" 
>>>> args="who">
>>>>     this.showEvent("mouseup" , who);
>>>>   </handler>
>>>>
>>>>   <handler name="onclick" reference="<em>LzGlobalMouse</em>" 
>>>> args="who">
>>>>     this.showEvent("mouseclick" , who);
>>>>   </handler>
>>>> </text>
>>>> </canvas>
>>>>
>>>> Is this a compiler bug? Or is there something wrong with the 
>>>> &amp;&amp; syntax? Since I also get this during my compile:
>>>> reference.preprocess:
>>>>   [copy] Copying 5 files to 
>>>> /home/mwilde/src/svn/openlaszlo/trunk/docs/src/build/reference
>>>>   [copy] Copying 155 files to 
>>>> /home/mwilde/src/svn/openlaszlo/trunk/docs/src/build/reference/programs 
>>>>
>>>>   [copy] Infinite loop in tokens. Currently known tokens : [amp]
>>>>   [copy] Problem token : &amp; called from &amp;
>>>>
>>>> Matt
>>>>
>>>> Lou Iorio wrote:
>>>>> Actually, I wasn't quite accurate. I was trying to build the 
>>>>> reference,
>>>>> and it said the build succeeded. However, I got a resource not
>>>>> available when I tried to open the doc.
>>>>>
>>>>> I'm doing a complete ant clean build doc now.
>>>>>
>>>>> Lou
>>>>>
>>>>> On Jun 25, 2008, at 1:57 PM, Corry Haines wrote:
>>>>>
>>>>>> I have seen that error message for several days, and It hasn't 
>>>>>> stopped
>>>>>> my build from finishing.
>>>>>>
>>>>>> -Corry
>>>>>>
>>>>>> On Wed, 2008-06-25 at 13:50 -0400, Lou Iorio wrote:
>>>>>>> The doc build is failing on my machine. I don't know if this is the
>>>>>>> problem,
>>>>>>> but I get this error:
>>>>>>>
>>>>>>> dbk.examples.preprocess:
>>>>>>>     [java] Error on line 23 column 6 of file:/Users/lou/src/svn/
>>>>>>> openlaszlo/trunk/docs/src/build/reference/programs/LFC-$32.lzx:
>>>>>>>     [java]   Error reported by XML parser: The element type
>>>>>>> "handler" must be terminated by the matching end-tag "</handler>".
>>>>>>>     [java] Recoverable error
>>>>>>>     [java] org.xml.sax.SAXParseException: The element type
>>>>>>> "handler" must be terminated by the matching end-tag "</handler>".
>>>>>>>
>>>>>>
>>>>>
>>>>
>>>
>>
>