From nobody Mon Feb 9 06:33:59 2026 Delivered-To: importer@patchew.org Received-SPF: none (zohomail.com: 8.43.85.245 is neither permitted nor denied by domain of lists.libvirt.org) client-ip=8.43.85.245; envelope-from=devel-bounces@lists.libvirt.org; helo=lists.libvirt.org; Authentication-Results: mx.zohomail.com; spf=none (zohomail.com: 8.43.85.245 is neither permitted nor denied by domain of lists.libvirt.org) smtp.mailfrom=devel-bounces@lists.libvirt.org; dmarc=fail(p=none dis=none) header.from=redhat.com Return-Path: Received: from lists.libvirt.org (lists.libvirt.org [8.43.85.245]) by mx.zohomail.com with SMTPS id 1709219311386262.91421823710573; Thu, 29 Feb 2024 07:08:31 -0800 (PST) Received: by lists.libvirt.org (Postfix, from userid 996) id 3730D1EA0; Thu, 29 Feb 2024 10:08:30 -0500 (EST) Received: from lists.libvirt.org (localhost [IPv6:::1]) by lists.libvirt.org (Postfix) with ESMTP id 644741B52; Thu, 29 Feb 2024 09:59:17 -0500 (EST) Received: by lists.libvirt.org (Postfix, from userid 996) id 6A3991B52; Thu, 29 Feb 2024 09:58:36 -0500 (EST) Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by lists.libvirt.org (Postfix) with ESMTPS id 71C651A39 for ; Thu, 29 Feb 2024 09:58:32 -0500 (EST) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-307-eWvpGJ_5NJ-aWG9Mmp_k2Q-1; Thu, 29 Feb 2024 09:58:30 -0500 Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 56373185A784 for ; Thu, 29 Feb 2024 14:58:30 +0000 (UTC) Received: from speedmetal.redhat.com (unknown [10.45.242.25]) by smtp.corp.redhat.com (Postfix) with ESMTP id C44331BDB1 for ; Thu, 29 Feb 2024 14:58:29 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on lists.libvirt.org X-Spam-Level: X-Spam-Status: No, score=-0.8 required=5.0 tests=HEADER_FROM_DIFFERENT_DOMAINS, MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_NONE, T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.4 X-MC-Unique: eWvpGJ_5NJ-aWG9Mmp_k2Q-1 From: Peter Krempa To: devel@lists.libvirt.org Subject: [PATCH 6/9] docs: newapi: Avoid empty
s when there is no description Date: Thu, 29 Feb 2024 15:58:20 +0100 Message-ID: <237ca029e7a5170f56278af8c3fb27f4805f125d.1709218314.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.4.1 on 10.11.54.5 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Message-ID-Hash: CX6PNSM3XLQTTRIQDYACFI3LE4ACBYTT X-Message-ID-Hash: CX6PNSM3XLQTTRIQDYACFI3LE4ACBYTT X-MailFrom: pkrempa@redhat.com X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-config-1; header-match-config-2; header-match-config-3; header-match-devel.lists.libvirt.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.2 Precedence: list List-Id: Development discussions about the libvirt library & tools Archived-At: List-Archive: List-Help: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable X-ZM-MESSAGEID: 1709219312458100001 The various objects we generate API for may have empty description in which case an empty div would be generated when processing the API description. As we're using XML output mode the generator would shorten such divs to the non-pair empty element version, which doesn't work well with HTML5 parsers requiring a pair tag for
Avoid empty description
elements altogether by skipping it if the description is empty. Signed-off-by: Peter Krempa --- docs/newapi.xsl | 40 +++++++++++++++++++++++++--------------- 1 file changed, 25 insertions(+), 15 deletions(-) diff --git a/docs/newapi.xsl b/docs/newapi.xsl index b60680ae97..539e0a4175 100644 --- a/docs/newapi.xsl +++ b/docs/newapi.xsl @@ -222,6 +222,19 @@ + + + + + +
+ + + +
+ + + #define @@ -287,11 +300,10 @@

-
- + + description - 
         enum 
@@ -343,11 +355,10 @@
         ;
-
- + + description -
@@ -452,11 +463,11 @@ 

#define =
-
- + + description -
+ @@ -604,11 +615,10 @@ ) -
- + + description -
@@ -680,11 +690,11 @@ ) -
- + + description -
+
--=20 2.43.0 _______________________________________________ Devel mailing list -- devel@lists.libvirt.org To unsubscribe send an email to devel-leave@lists.libvirt.org