[Laszlo-dev] doc build fails

[Matt Wilde]

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>".
>>>>>
>>>>
>>>
>>
>