Author: dda
Date: 2008-01-29 08:44:10 -0800 (Tue, 29 Jan 2008)
New Revision: 7913
Modified:
openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
Log:
Change 20080129-dda-r by [EMAIL PROTECTED] on 2008-01-29 11:33:13 EST
in /Users/dda/laszlo/src/svn/openlaszlo/trunk-doc
for http://svn.openlaszlo.org/openlaszlo/trunk
Summary: doc: remove FIXMEs from generated output
New Features:
Bugs Fixed: LPP-5152
Technical Reviewer: (pending)
QA Reviewer: (pending)
Doc Reviewer: liorio (pending)
Documentation:
Release Notes:
Details:
FIXMEs appearing in documentation pointed to issues that needed to be
addressed
in lzx sources. Many of them will be resolved when 'real' classes are made,
some of them need special handling. This change does two things:
- instead of emitting FIXME, something a little more descriptive is shown:
'has setter' means the attribute has a setter, but is not declared as a
'var' attribute.
'unknown' means the attribute exists, but is not declared in a real class.
- during the generation of the doc, warnings are generated so we are
alerted to fix these
problems; it doesn't require eyeballing the output to know about it.
Tests:
Modified: openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl
===================================================================
--- openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl 2008-01-29 16:43:33 UTC
(rev 7912)
+++ openlaszlo/trunk/docs/src/xsl/js2doc2dbk.xsl 2008-01-29 16:44:10 UTC
(rev 7913)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- * X_LZ_COPYRIGHT_BEGIN ***************************************************
-* Copyright 2001-2007 Laszlo Systems, Inc. All Rights Reserved. *
+* Copyright 2001-2008 Laszlo Systems, Inc. All Rights Reserved. *
* Use is subject to license terms. *
* X_LZ_COPYRIGHT_END ****************************************************** -->
<!--
@@ -37,6 +37,7 @@
<!ENTITY readonly '(@modifiers="readonly" or @modifiers="read-only" or
@keywords="read-only" or @keywords="readonly")'>
<!ENTITY final '(@modifiers="final" or @keywords="final")'>
+<!ENTITY virtual '(@modifiers="virtual" or @keywords="virtual")'>
<!ENTITY unwritable '(@modifiers="readonly" or @modifiers="read-only" or
@keywords="read-only" or @keywords="readonly" or @modifiers="final" or
@keywords="final")'>
<!ENTITY isevent '((doc/[EMAIL PROTECTED]"lzxtype"]/text) = "event"
or @type="LzEvent")'>
@@ -1281,9 +1282,28 @@
<xsl:when test="&final; and ($isinstancevar or
$isinitarg)">initialize-only</xsl:when>
<xsl:when test="&readonly;">readonly</xsl:when>
<xsl:when test="not(&unwritable;) and
$isinstancevar">read/write</xsl:when>
- <xsl:when test="not(&unwritable;) and not($isinstancevar) and
not($issetter)">(FIXME: declare attribute (non-setter))</xsl:when>
- <xsl:when test="not(&unwritable;) and not($isinstancevar) and
$issetter">(FIXME: declare attribute (setter))</xsl:when>
- <xsl:otherwise>(FIXME: otherwise) <xsl:if
test="&final;">final</xsl:if> <xsl:if
test="&readonly;">readonly</xsl:if></xsl:otherwise>
+ <xsl:when test="not(&unwritable;) and &virtual;">read/write
(virtual)</xsl:when>
+ <xsl:when test="not(&unwritable;) and not($isinstancevar) and
not($issetter)">
+ <!-- happens when an old style class is encountered -->
+ <xsl:message>
+ Unknown attribute category (no setter) for <xsl:value-of
select="/ancestor-or-self::property//@id" /> : <xsl:value-of select="@name" />
+ </xsl:message>
+ unknown
+ </xsl:when>
+ <xsl:when test="not(&unwritable;) and not($isinstancevar) and
$issetter">
+ <!-- usually happens when there is a setter with no declared var
-->
+ <xsl:message>
+ Unknown attribute category (has setter with no var) for
<xsl:value-of select="ancestor-or-self::property//@id" /> : <xsl:value-of
select="@name" />
+ </xsl:message>
+ has setter
+ </xsl:when>
+ <xsl:otherwise>
+ <xsl:message>
+ Unknown attribute category (otherwise) for <xsl:value-of
select="ancestor-or-self::property//@id" /> : <xsl:value-of select="@name" />
+ </xsl:message>
+ <xsl:if test="&final;">final</xsl:if>
+ <xsl:if test="&readonly;">readonly</xsl:if>
+ </xsl:otherwise>
</xsl:choose>
<xsl:if test="&isevent;">
event
@@ -1300,4 +1320,4 @@
</xsl:template>
-</xsl:stylesheet>
\ No newline at end of file
+</xsl:stylesheet>
_______________________________________________
Laszlo-checkins mailing list
[email protected]
http://www.openlaszlo.org/mailman/listinfo/laszlo-checkins
