[Laszlo-dev] doc build fails

[Matt Wilde]

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