]> xenbits.xensource.com Git - libvirt.git/commitdiff
docs: newapi: Don't generate empty <div> in template for ACL permissions
authorPeter Krempa <pkrempa@redhat.com>
Thu, 22 Feb 2024 12:29:07 +0000 (13:29 +0100)
committerPeter Krempa <pkrempa@redhat.com>
Fri, 1 Mar 2024 11:51:56 +0000 (12:51 +0100)
If an API has no ACLs an empty <div class='acl'/> would be generated
which is mis-interpreted by browsers when creating DOM to nest any
subsequent elements under it.

Don't generate the ACL section div unless it will be filled.

Best viewed with 'git show -w'

Signed-off-by: Peter Krempa <pkrempa@redhat.com>
Reviewed-by: Pavel Hrdina <phrdina@redhat.com>
docs/newapi.xsl

index 38cefb2ca8f5381939990c8defe6c78b0c27cae3..b60680ae97d261f5aad4c4108724e8eab6b6d418 100644 (file)
   <xsl:template name="aclinfo">
     <xsl:param name="acl"/>
 
-    <xsl:if test="count($acl/check) > 0">
-      <h5>Access control parameter checks</h5>
-      <table>
-        <thead>
-          <tr>
-            <th>Object</th>
-            <th>Permission</th>
-            <th>Condition</th>
-          </tr>
-        </thead>
-        <xsl:apply-templates select="$acl/check" mode="acl"/>
-      </table>
-    </xsl:if>
-    <xsl:if test="count($acl/filter) > 0">
-      <h5>Access control return value filters</h5>
-      <table>
-        <thead>
-          <tr>
-            <th>Object</th>
-            <th>Permission</th>
-          </tr>
-        </thead>
-        <xsl:apply-templates select="$acl/filter" mode="acl"/>
-      </table>
+    <xsl:if test="count($acl/check) > 0 or count($acl/filter) > 0">
+      <div class="acl">
+        <xsl:if test="count($acl/check) > 0">
+          <h5>Access control parameter checks</h5>
+          <table>
+            <thead>
+              <tr>
+                <th>Object</th>
+                <th>Permission</th>
+                <th>Condition</th>
+              </tr>
+            </thead>
+            <xsl:apply-templates select="$acl/check" mode="acl"/>
+          </table>
+        </xsl:if>
+        <xsl:if test="count($acl/filter) > 0">
+          <h5>Access control return value filters</h5>
+          <table>
+            <thead>
+              <tr>
+                <th>Object</th>
+                <th>Permission</th>
+              </tr>
+            </thead>
+            <xsl:apply-templates select="$acl/filter" mode="acl"/>
+          </table>
+        </xsl:if>
+      </div>
     </xsl:if>
   </xsl:template>
 
         </xsl:if>
       </dl>
     </xsl:if>
-    <div class="acl">
-      <xsl:call-template name="aclinfo">
-        <xsl:with-param name="acl" select="acls"/>
-      </xsl:call-template>
-    </div>
+    <xsl:call-template name="aclinfo">
+      <xsl:with-param name="acl" select="acls"/>
+    </xsl:call-template>
   </xsl:template>
 
   <xsl:template match="exports" mode="toc">