Changeset 93708 in vbox for trunk/doc/manual/docbook-refentry-to-H-help.xsl

Timestamp:

Feb 11, 2022 8:46:11 PM (3 years ago)

Author:

vboxsync

Message:

include/iprt/message.h: Max out the available bits for the scope, we need a lot for the VBoxManage controlvm docs.

docs, VBoxManage: Integrate refman (and fix some content) for VBoxManage startvm and VBoxManage controlvm. Needs about 60 scopes (do RT_BIT_64 is a must have), and for protection against exceeding the limit there are now checks (as AssertCompile).

File:

• trunk/doc/manual/docbook-refentry-to-H-help.xsl (modified) (4 diffs)

trunk/doc/manual/docbook-refentry-to-H-help.xsl

@@ -65 +65 @@
         <xsl:value-of select="$sBaseNm"/>
         <xsl:value-of select="substring('                                               ',1,56 - string-length($sBaseNm) - 11)"/>
-        <xsl:text> RT_BIT_32(HELP_SCOPE_</xsl:text><xsl:value-of select="$sBaseNm"/><xsl:text>_BIT)
+        <xsl:text> RT_BIT_64(HELP_SCOPE_</xsl:text><xsl:value-of select="$sBaseNm"/><xsl:text>_BIT)
         HELP_SCOPE_</xsl:text><xsl:value-of select="$sBaseNm"/><xsl:text>_BIT = 0</xsl:text>
 
@@ -80 +80 @@
           <xsl:value-of select="$sSubNm"/>
           <xsl:value-of select="substring('                                               ',1,56 - string-length($sSubNm))"/>
-          <xsl:text> RT_BIT_32(</xsl:text><xsl:value-of select="$sSubNm"/><xsl:text>_BIT)
+          <xsl:text> RT_BIT_64(</xsl:text><xsl:value-of select="$sSubNm"/><xsl:text>_BIT)
         </xsl:text>
           <xsl:value-of select="$sSubNm"/><xsl:text>_BIT</xsl:text>
         </xsl:for-each>
 
-        <!-- Add scoping info for refsect1, refsect2 and refsect3 IDs that aren't part of the synopsis. -->
-        <xsl:for-each select=".//refsect1[@id] | .//refsect2[@id] | .//refsect3[@id]">
+        <!-- Add scoping info for refsect1 and refsect2 IDs that aren't part of the synopsis. -->
+        <xsl:for-each select=".//refsect1[@id] | .//refsect2[@id]">
           <xsl:variable name="sThisId" select="@id"/>
           <xsl:if test="not($RefEntry[@id = $sThisId]) and not($RefEntry/refsynopsisdiv/cmdsynopsis[@id = concat('synopsis-', $sThisId)])">
@@ -108 +108 @@
             <xsl:value-of select="$sSubNm"/>
             <xsl:value-of select="substring('                                               ',1,56 - string-length($sSubNm))"/>
-            <xsl:text> RT_BIT_32(</xsl:text><xsl:value-of select="$sSubNm"/><xsl:text>_BIT)
+            <xsl:text> RT_BIT_64(</xsl:text><xsl:value-of select="$sSubNm"/><xsl:text>_BIT)
         </xsl:text>
             <xsl:value-of select="$sSubNm"/><xsl:text>_BIT</xsl:text>
@@ -118 +118 @@
         HELP_SCOPE_</xsl:text><xsl:value-of select="$sBaseNm"/><xsl:text>_END
 };
+AssertCompile((int)HELP_SCOPE_</xsl:text><xsl:value-of select="$sBaseNm"/><xsl:text>_END &gt;= 1);
+AssertCompile((int)HELP_SCOPE_</xsl:text><xsl:value-of select="$sBaseNm"/><xsl:text>_END &lt; 64);
+AssertCompile(RT_BIT_64(HELP_SCOPE_</xsl:text><xsl:value-of select="$sBaseNm"/><xsl:text>_END - 1) &amp; RTMSGREFENTRYSTR_SCOPE_MASK);
 </xsl:text>
       </xsl:when>