[Laszlo-checkins] r7229 - in openlaszlo/branches/paperpie: WEB-INF/lps/lfc/core WEB-INF/lps/lfc/views docs/src docs/src/reference docs/src/xsl

ben@openlaszlo.org ben at openlaszlo.org
Mon Nov 12 20:37:49 PST 2007


Author: ben
Date: 2007-11-12 20:37:43 -0800 (Mon, 12 Nov 2007)
New Revision: 7229

Modified:
   openlaszlo/branches/paperpie/WEB-INF/lps/lfc/core/LzNode.lzs
   openlaszlo/branches/paperpie/WEB-INF/lps/lfc/views/LaszloView.lzs
   openlaszlo/branches/paperpie/docs/src/build.xml
   openlaszlo/branches/paperpie/docs/src/reference/index.dbk
   openlaszlo/branches/paperpie/docs/src/xsl/js2doc2dbk.xsl
   openlaszlo/branches/paperpie/docs/src/xsl/simple-driver.xsl
Log:
Change 20071112-ben-M by ben at slim.local on 2007-11-12 15:31:26 PST
    in /Users/ben/src/svn/openlaszlo/branches/paperpie
    for http://svn.openlaszlo.org/openlaszlo/branches/paperpie

Summary: refguide - more cleanup of events list, attributes list

Documentation: 
Don't list initargs in the attributes list or list of inherited
attributes; every initarg should have an instance variable to go
with it, so the initarg can be left out. 

More cleanup to the events list for LzNode and LzView by fixing
js2doc annotations. 

Turn off building the cross reference because is it slow and
unused. 

Make the build not panic if the reference index can't be found,
because we're just going to overwrite it anyways. 

Tests:



Modified: openlaszlo/branches/paperpie/WEB-INF/lps/lfc/core/LzNode.lzs
===================================================================
--- openlaszlo/branches/paperpie/WEB-INF/lps/lfc/core/LzNode.lzs	2007-11-13 04:37:13 UTC (rev 7228)
+++ openlaszlo/branches/paperpie/WEB-INF/lps/lfc/core/LzNode.lzs	2007-11-13 04:37:43 UTC (rev 7229)
@@ -45,6 +45,7 @@
   * this node.
   * @param Object children
   * @param Boolean instcall
+  * @access private
   */
 function initialize ( parent , attrs , children , instcall ){
         this.__LZUID = "__U" + ++LzNode.__UIDs;
@@ -290,6 +291,7 @@
 var onclonenumber = LzDeclaredEvent;
 /** 
   * @lzxtype event
+  * @access private
   */ 
 var ondestroy = LzDeclaredEvent;
 
@@ -697,7 +699,7 @@
   * If this node's parent is inited, this method clears the queue of nodes
   * awaiting init.
   *
-  * @access protected
+  * @access private
   */
 function __LZinstantiationDone (){
     if ( !this.immediateparent ||  this.immediateparent.isinited ||

Modified: openlaszlo/branches/paperpie/WEB-INF/lps/lfc/views/LaszloView.lzs
===================================================================
--- openlaszlo/branches/paperpie/WEB-INF/lps/lfc/views/LaszloView.lzs	2007-11-13 04:37:13 UTC (rev 7228)
+++ openlaszlo/branches/paperpie/WEB-INF/lps/lfc/views/LaszloView.lzs	2007-11-13 04:37:43 UTC (rev 7229)
@@ -2439,6 +2439,7 @@
 /**
   * Get the Z order of the view
   * @return Integer: A number representing z level relative to other siblings
+  * @access private
   */
 function getZ () {
     return this.sprite.getZ();
@@ -2697,6 +2698,7 @@
     return this.sprite.getContextMenu();
 }
 
+/** @access private */ 
 function __warnCapability(msg) {
     Debug.warn('The %s runtime does not support %s', lzr, msg); 
 }
@@ -2704,7 +2706,7 @@
 /**
   * LzView.getNextSelection
   * Override to specify the next view to be focused
-  * @access public
+  * @access private
   */
 function getNextSelection() {
 }

Modified: openlaszlo/branches/paperpie/docs/src/build.xml
===================================================================
--- openlaszlo/branches/paperpie/docs/src/build.xml	2007-11-13 04:37:13 UTC (rev 7228)
+++ openlaszlo/branches/paperpie/docs/src/build.xml	2007-11-13 04:37:43 UTC (rev 7229)
@@ -568,7 +568,7 @@
     <property name="ref.visibility.filter" value="public protected"/>
     <property name="ref.show.comments" value="${show.comments}"/>
     <property name="ref.show.fixmes" value="${show.fixmes}"/>
-    
+
     <antcall target="dbk.topic.generate" inheritAll="true">
       <param name="local.input.file" value="${ref.file.in}"/>
       <param name="local.output.file" value="${reference.build.dir}/embedref.dbk"/>
@@ -605,6 +605,7 @@
       <param name="dbk.show.fixmes" value="${ref.show.fixmes}"/>
     </antcall>
 
+<?skip for faster builds
     <antcall target="dbk.topic.generate" inheritAll="true">
       <param name="local.input.file" value="${ref.file.in}"/>
       <param name="local.output.file" value="${reference.build.dir}/chartref.dbk"/>
@@ -613,6 +614,7 @@
       <param name="dbk.show.comments" value="${ref.show.comments}"/>
       <param name="dbk.show.fixmes" value="${ref.show.fixmes}"/>
     </antcall>
+?>    
 
     <antcall target="dbk.topic.generate" inheritAll="true">
       <param name="local.input.file" value="${ref.file.in}"/>
@@ -631,7 +633,7 @@
       <param name="dbk.show.comments" value="${ref.show.comments}"/>
       <param name="dbk.show.fixmes" value="${ref.show.fixmes}"/>
     </antcall>
-
+    
     <antcall target="dbk.topic.generate" inheritAll="true">
       <param name="local.input.file" value="${ref.file.in}"/>
       <param name="local.output.file" value="${reference.build.dir}/devref.dbk"/>
@@ -641,6 +643,7 @@
       <param name="dbk.show.fixmes" value="${ref.show.fixmes}"/>
     </antcall>
 
+<?skip for faster builds
     <style style="xsl/js2doc2xref.xsl"
            in="${ref.file.in}"
            out="${reference.build.dir}/xref.dbk">
@@ -652,6 +655,7 @@
       <param name="show.fixmes" expression="${ref.show.fixmes}"/>
       <param name="build.general.index" expression="1"/>
     </style>
+?>    
 
   </target>
   
@@ -761,7 +765,7 @@
           todir="${reference.output.dir}">
       </copy>      
       <!-- Tuck away the docbook-generated index, so we can examine it --> 
-      <copy 
+      <copy failonerror="false"
           file="${reference.output.dir}/index.html"
           tofile="${reference.output.dir}/index-docbook.html">          
       </copy>      

Modified: openlaszlo/branches/paperpie/docs/src/reference/index.dbk
===================================================================
--- openlaszlo/branches/paperpie/docs/src/reference/index.dbk	2007-11-13 04:37:13 UTC (rev 7228)
+++ openlaszlo/branches/paperpie/docs/src/reference/index.dbk	2007-11-13 04:37:43 UTC (rev 7229)
@@ -41,16 +41,20 @@
     <xi:fallback><para>Missing: Embedding Reference</para></xi:fallback>
   </xi:include>
 
+<?ignore skip for faster builds
   <xi:include href="chartref.dbk">
     <xi:fallback><para>Missing: Charting Reference</para></xi:fallback>
   </xi:include>
+?>  
 
   <xi:include href="incref.dbk">
     <xi:fallback><para>Missing: Incubator Reference</para></xi:fallback>
   </xi:include>
 
+<?ignore skip for faster builds
   <xi:include href="xref.dbk">
     <xi:fallback><para>Missing: Cross-Reference</para></xi:fallback>
   </xi:include>
+?>  
   
 </book>

Modified: openlaszlo/branches/paperpie/docs/src/xsl/js2doc2dbk.xsl
===================================================================
--- openlaszlo/branches/paperpie/docs/src/xsl/js2doc2dbk.xsl	2007-11-13 04:37:13 UTC (rev 7228)
+++ openlaszlo/branches/paperpie/docs/src/xsl/js2doc2dbk.xsl	2007-11-13 04:37:43 UTC (rev 7229)
@@ -297,7 +297,7 @@
         <!-- Properties -->    
         <xsl:if test="$show.members.attributes">
           <xsl:call-template name="describe-members">
-            <xsl:with-param name="members" select="$ivars[not &isevent;] | &classvalue;/initarg | $svars[not &isevent;]"/>
+            <xsl:with-param name="members" select="$ivars[not &isevent;] | $svars[not &isevent;]"/>
             <xsl:with-param name="title" select="'Attributes'"/>
             <xsl:with-param name="initargs" select="$initargs" />
             <xsl:with-param name="ivars" select="$ivars" />
@@ -1017,8 +1017,7 @@
         </title>
         <para>
           <xsl:variable name="inheritedattrs" select="$superclass/class/property[@name='__ivars__']/object/property[@access='public']"></xsl:variable>
-          <xsl:variable name="initargs" select="$superclass/class/initarg[@access='public']"></xsl:variable>
-          <xsl:variable name="allinheritedattrs" select="$inheritedattrs | $initargs" />
+          <xsl:variable name="allinheritedattrs" select="$inheritedattrs" />
           <xsl:for-each select="$allinheritedattrs">
             <xsl:sort select="@name"/>            
             <link linkend="{@id}"><xsl:value-of select="@name"/></link>

Modified: openlaszlo/branches/paperpie/docs/src/xsl/simple-driver.xsl
===================================================================
--- openlaszlo/branches/paperpie/docs/src/xsl/simple-driver.xsl	2007-11-13 04:37:13 UTC (rev 7228)
+++ openlaszlo/branches/paperpie/docs/src/xsl/simple-driver.xsl	2007-11-13 04:37:43 UTC (rev 7229)
@@ -22,6 +22,7 @@
 <!ENTITY isvisible      '(contains("public", @access))'>
 
 <!ENTITY ispublic       '(@access="public")'>
+<!ENTITY isevent        '((doc/tag[@name="lzxtype"]/text) = "event" or @type="LzEvent")'>
 
 
 
@@ -82,8 +83,8 @@
         </xsl:for-each>
         
         
-        instancevariables: 
-        <xsl:for-each select="$instancevariables">
+        non-event instancevariables: 
+        <xsl:for-each select="$instancevariables[not &isevent;]">
             <xsl:sort select="@name" />            
             <xsl:value-of select="@name"/>,             
         </xsl:for-each>            



More information about the Laszlo-checkins mailing list