Changeset 79737 in vbox

Timestamp:

Jul 12, 2019 1:56:01 PM (5 years ago)

Author:

vboxsync

Message:

Main/apiwrap-server.xsl: Emit proper doxygen @name groupings in headers for better copying & pasting into the implementation.

File:

• trunk/src/VBox/Main/idl/apiwrap-server.xsl (modified) (6 diffs)

trunk/src/VBox/Main/idl/apiwrap-server.xsl

@@ -80 +80 @@
  */
 
-/**
- * Copyright (C) 2010-2016 Oracle Corporation
+/*
+ * Copyright (C) 2010-2019 Oracle Corporation
  *
  * This file is part of VirtualBox Open Source Edition (OSE), as
@@ -120 +120 @@
 
 </xsl:text>
-    <xsl:value-of select="concat('class ATL_NO_VTABLE ', substring(@name, 2), 'Wrap:')"/>
+    <xsl:value-of select="concat('class ATL_NO_VTABLE ', substring(@name, 2), 'Wrap')"/>
     <xsl:text>
-    public VirtualBoxBase,
-</xsl:text>
-    <xsl:value-of select="concat('    VBOX_SCRIPTABLE_IMPL(', @name, ')')"/>
-    <xsl:if test="count(exsl:node-set($addinterfaces)/token) > 0">
-        <xsl:text>,</xsl:text>
-    </xsl:if>
+    : public VirtualBoxBase
+</xsl:text>
+    <xsl:value-of select="concat('    , VBOX_SCRIPTABLE_IMPL(', @name, ')')"/>
     <xsl:value-of select="$G_sNewLine"/>
     <xsl:for-each select="exsl:node-set($addinterfaces)/token">
-        <xsl:value-of select="concat('    VBOX_SCRIPTABLE_IMPL(', text(), ')')"/>
-        <xsl:if test="not(position()=last())">
-            <xsl:text>,</xsl:text>
-        </xsl:if>
+        <xsl:value-of select="concat('    , VBOX_SCRIPTABLE_IMPL(', text(), ')')"/>
         <xsl:value-of select="$G_sNewLine"/>
     </xsl:for-each>
@@ -1563 +1557 @@
         </xsl:when>
         <xsl:when test="$pmode != 'dtrace-probes'">
-            <xsl:value-of select="concat($G_sNewLine, '    // ', $pmode, ' ', $name, ' properties', $G_sNewLine)"/>
+            <xsl:value-of select="concat($G_sNewLine, '    /** @name ', translate(substring($pmode, 1, 1), $G_lowerCase, $G_upperCase), substring($pmode,2), ' ', $name, ' properties', $G_sNewLine)"/>
+            <xsl:text>     * @{ */
+</xsl:text>
         </xsl:when>
     </xsl:choose>
@@ -1615 +1611 @@
         <xsl:otherwise><xsl:message terminate="yes">Otherwise oops in emitAttributes</xsl:message></xsl:otherwise>
     </xsl:choose>
+
+    <!-- close doxygen @name -->
+    <xsl:if test="($pmode != 'code') and ($pmode != 'dtrace-probes')" >
+            <xsl:text>    /** @} */
+</xsl:text>
+    </xsl:if>
 </xsl:template>
 
@@ -2196 +2198 @@
         <xsl:when test="$pmode='dtrace-probes'"/>
         <xsl:otherwise>
-            <xsl:value-of select="concat($G_sNewLine, '    // ', $pmode, ' ', $name, ' methods', $G_sNewLine)"/>
+            <xsl:value-of select="concat($G_sNewLine, '    /** @name ', translate(substring($pmode, 1, 1), $G_lowerCase, $G_upperCase), substring($pmode,2), ' ', $name, ' methods', $G_sNewLine)"/>
+            <xsl:text>     * @{ */
+</xsl:text>
         </xsl:otherwise>
     </xsl:choose>
@@ -2247 +2251 @@
         <xsl:otherwise/>
     </xsl:choose>
+
+    <!-- close doxygen @name -->
+    <xsl:if test="($pmode != 'code') and ($pmode != 'dtrace-probes')" >
+            <xsl:text>    /** @} */
+</xsl:text>
+    </xsl:if>
 </xsl:template>