Changeset 6875 in vbox

Timestamp:

Feb 10, 2008 2:37:24 PM (17 years ago)

Author:

vboxsync

Message:

Main: Updated Doxygen XSL to properly suffix array parameters with [].

File:

• trunk/src/VBox/Main/idl/doxygen.xsl (modified) (5 diffs)

trunk/src/VBox/Main/idl/doxygen.xsl

@@ -7 +7 @@
 
      Copyright (C) 2006-2007 innotek GmbH
-    
+
      This file is part of VirtualBox Open Source Edition (OSE), as
      available from http://www.virtualbox.org. This file is free software;
@@ -393 +393 @@
 -->
 <xsl:template match="interface//attribute | collection//attribute">
+  <xsl:if test="@array">
+      <xsl:message terminate="yes">
+          <xsl:value-of select="concat(../../@name,'::',../@name,'::',@name,': ')"/>
+          <xsl:text>'array' attributes are not supported, use 'safearray="yes"' instead.</xsl:text>
+      </xsl:message>
+  </xsl:if>
     <xsl:apply-templates select="@if" mode="begin"/>
     <xsl:apply-templates select="desc"/>
@@ -526 +532 @@
             <xsl:message terminate="yes">
                 <xsl:value-of select="concat(../../@name,'::',../@name,'::',@name,': ')"/>
-                <xsl:text>return array parameters are not currently supported</xsl:text>
+                <xsl:text>return 'array' parameters are not supported, use 'safearray="yes"' instead.</xsl:text>
             </xsl:message>
         </xsl:if>
@@ -580 +586 @@
     <xsl:variable name="self_target" select="current()/ancestor::if/@target"/>
 
+    <xsl:if test="../@array and ../@safearray='yes'">
+        <xsl:message terminate="yes">
+            <xsl:value-of select="concat(../../../@name,'::',../../@name,'::',../@name,': ')"/>
+            <xsl:text>either 'array' or 'safearray="yes"' attribute is allowed, but not both!</xsl:text>
+        </xsl:message>
+    </xsl:if>
+
     <xsl:choose>
         <!-- modifiers (ignored for 'enumeration' attributes)-->
         <xsl:when test="name(current())='type' and ../@mod">
-            <xsl:if test="../@array">
-                <xsl:message terminate="yes">
-                        <xsl:value-of select="concat(../../../@name,'::',../../@name,'::',../@name,': ')"/>
-                    <xsl:text>either 'array' or 'mod' attribute is allowed, but not both!</xsl:text>
-                </xsl:message>
-            </xsl:if>
             <xsl:choose>
                 <xsl:when test="../@mod='ptr'">
@@ -683 +690 @@
         </xsl:otherwise>
     </xsl:choose>
+  <xsl:if test="../@safearray='yes'">
+    <xsl:text>[]</xsl:text>
+  </xsl:if>
 </xsl:template>