[Laszlo-checkins] r9090 - openlaszlo/trunk/docs/src/xsl

[dda@openlaszlo.org]

Author: dda
Date: 2008-05-12 12:39:33 -0700 (Mon, 12 May 2008)
New Revision: 9090

Modified:
   openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
   openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl
Log:
Change 20080512-dda-1 by dda at lester.local on 2008-05-12 15:21:57 EDT
    in /Users/dda/laszlo/src/svn/openlaszlo/trunk-doc3
    for http://svn.openlaszlo.org/openlaszlo/trunk

Summary: fix doc for lzx events

New Features:

Bugs Fixed: LPP-5952

Technical Reviewer: (pending)
QA Reviewer: (pending)
Doc Reviewer: liorio (pending)

Documentation:

Release Notes:

Details:
    Events marked as <event> in lzx file are now internally translated
    as having lzxtype="event".  This is the trigger to show them as events,
    also needed to look for events in <property name="prototype"> (coming lzx) in
    addition to <property name="__ivars__"> (coming lzs).
    
    Note that some events are now exposed that perhaps should not be.  For example,
    baseslider defines events onmaxvalue, onminvalue that have no documentation
    (and are not marked private).  I'm guessing these should be private.
    To find trouble spots, you can get a reasonable summary of event tags used
    in components via:
         grep -C5 '<event' lps/components/*/*.lzx

Tests:
   Rebuild doc, examine <menuitem>  (not <menu> as mentioned in the JIRA),
   and <basetabelement>



Modified: openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl	2008-05-12 19:39:15 UTC (rev 9089)
+++ openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl	2008-05-12 19:39:33 UTC (rev 9090)
@@ -255,7 +255,7 @@
         <xsl:variable name="svars" select="&objectvalue;/property[@name='setters']/object/property[&isvisible;]"/>
         <xsl:variable name="pvars" select="&objectvalue;/property[@name='prototype']/object/property[&isvisible;]"/>
         <xsl:variable name="ovars" select="&objectvalue;/property[not(&privateslot;) and &isvisible;]"/>
-        <xsl:variable name="events" select="&objectvalue;/property[@name='__ivars__']/object/property[doc/tag[@name='lzxtype']/text = 'event' and &isvisible;]" />
+        <xsl:variable name="events" select="&objectvalue;/property[@name='__ivars__' or @name='prototype']/object/property[doc/tag[@name='lzxtype']/text = 'event' and &isvisible;]" />
         <xsl:variable name="initargs" select="class/initarg[not(contains(@access, 'private'))]" />       
         
         

Modified: openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl	2008-05-12 19:39:15 UTC (rev 9089)
+++ openlaszlo/trunk/docs/src/xsl/lzx2js2doc.xsl	2008-05-12 19:39:33 UTC (rev 9090)
@@ -242,6 +242,9 @@
           <xsl:when test="@type">
             <tag name="lzxtype"><text><xsl:value-of select="@type"/></text></tag>
           </xsl:when>
+          <xsl:when test="self::event">
+            <tag name="lzxtype"><text>event</text></tag>
+          </xsl:when>
           <xsl:otherwise>
             <tag name="lzxtype"><text>expression</text></tag>
           </xsl:otherwise>