From nobody Sat May 4 17:34:35 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1667478807; cv=none; d=zohomail.com; s=zohoarc; b=OMUcd1RJZtsgP7Atd/2apTJZ+z0gaHhjlpxBlJ55OqjOLStNM3EKex7s6+N6XswtsjaBIAx6bqgDsVkHClvAPvWjsp5bJvnGsH3W7l2X8d9ut1fOqJUmFvNQB/iXjlkO/pL+fWVRe0u6uptOvTSiEOPrrr9ukb+4duoL1AiBj4k= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1667478807; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=5DOOaICRvg37cpB/9+tdzJutXjAz9vv9cCCDX9S5IKc=; b=LsGgJk5dbN9eyUWDzvUlw/FBfIkpf6iVyx5QJqeWXeORNQtkJ9Oj6olsqrjOOjqZZtxDM0GO3pGipzkPowTTAXE2We76vNrCJYkveYrXqjK1ac6lIFA9i0IJfQu62hWyzbjaTQwkeE+nZYan12ILrPK6D1107jV76A1F5J5qgss= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1667478807066396.2820168150133; Thu, 3 Nov 2022 05:33:27 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-77-cSmfEdJiM9qvKcna8RxJOw-1; Thu, 03 Nov 2022 08:33:23 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 107642823801; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 076DF1415123; Thu, 3 Nov 2022 12:33:19 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id D21D319465A4; Thu, 3 Nov 2022 12:33:18 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 9490C1946594 for ; Thu, 3 Nov 2022 12:33:18 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 7B6FE39D7C; Thu, 3 Nov 2022 12:33:18 +0000 (UTC) Received: from speedmetal.redhat.com (ovpn-208-3.brq.redhat.com [10.40.208.3]) by smtp.corp.redhat.com (Postfix) with ESMTP id D0C544EA55 for ; Thu, 3 Nov 2022 12:33:17 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1667478806; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=5DOOaICRvg37cpB/9+tdzJutXjAz9vv9cCCDX9S5IKc=; b=iZla0ubdYe/ajm+rNaI0ksS0m0QVQfhnW1OatV50hsVKyORtEudHjEhv6BhH1vAUpYGzI+ 5lPIVI5LLsYMq5FzCIVo5KrE3jDJsBkfYRyni5Qpna/ehkoK61q6hTYDxyqW3uHkJuWhn8 SIiWnK0XkXyi2sz3ppHWRXCgo3CfWMw= X-MC-Unique: cSmfEdJiM9qvKcna8RxJOw-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 1/5] docs: xsl: newapi: Remove unused 'navbar' template Date: Thu, 3 Nov 2022 13:33:11 +0100 Message-Id: <96bee7665a7b8c378005e17377c94dca36f401d9.1667478479.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.5 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.7 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1667478808354100001 Content-Type: text/plain; charset="utf-8" The template is unused since commit 9092c3d491047539e376a496d1520249 Remove also the up|right|left|home.png files which were only used by code generated by the unused template. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/html/home.png | Bin 654 -> 0 bytes docs/html/left.png | Bin 459 -> 0 bytes docs/html/meson.build | 13 ------------- docs/html/right.png | Bin 472 -> 0 bytes docs/html/up.png | Bin 406 -> 0 bytes docs/newapi.xsl | 22 ---------------------- 6 files changed, 35 deletions(-) delete mode 100644 docs/html/home.png delete mode 100644 docs/html/left.png delete mode 100644 docs/html/right.png delete mode 100644 docs/html/up.png diff --git a/docs/html/home.png b/docs/html/home.png deleted file mode 100644 index 17003611d9df2b066afc682cbde962f3a575002d..000000000000000000000000000= 0000000000000 GIT binary patch literal 0 HcmV?d00001 literal 654 zcmV;90&)F`P)~yY zO1cF+0vxb!W?!x?K+*#62Jq)nA4q`)5S6sgX4ao{=3D)(Mgq+YMr)7sjak|a^9)zS!j zlk{-n29mabXYF=3D7SYBQx&vO8xC}MYams+hxqtO7sImhPaCf@rq;I^3!#u*2aUP)55 zT2&N90xmEJ0s&fGT~(T<3d2xYmK9C>IP*x-M@ib*+0pFm>>uW37N2Wzaq-fCnIZE9 zpb8}0+uN+KuQM2oZVHfP8U6kQdo3?>Wo2dT)WeM9So8DqhLi#T0 z-i(>mfjhvbsYV`;4sgfJ-p>G-SqJ!fjR6BQYs1h*y9xaN0l{VB;o%`08yiy@)$8@~ z2PD1gcDuiy;j1tR0v#V8OH%W)25-YKyx(j#IXO9*YWf0mb8}QG6@b@;cHxh9{t7+@ o!Yd`f8L$sLH?yBt^q3C6015TtIu@BS5dZ)H07*qoM6N<$f*igdr~m)} diff --git a/docs/html/left.png b/docs/html/left.png deleted file mode 100644 index 2d05b3d5b4aeec9384bbfe404bfc4ed0897051c4..000000000000000000000000000= 0000000000000 GIT binary patch literal 0 HcmV?d00001 literal 459 zcmV;+0W|)JP)40xL?wO*>WZ(J#ML5j2<9jD6A%Q&kC}jOeEc;X{s;`zcnxLeZR6?6h#^ihmNF6NpGdilO$m<82oD9WQ|6nVv1`? z>KufRi{?QPXg;4;wroQu4?mN1Ydd@|kaQ|ZyWLK!)yi7Wb%=3D0{}lD)tfliHAUyWRQ+fD_;aV6j->y6!O_8bENg6P)Cd4HCN^TYHBC0dz3r5|}*T3c5!K}0^NPTey!^rYo;W&eW{b1SE%dR-1ljcju- zJITo5P_e{cPDWDszO|97o#m$fni3V4d%~7^?0HU4-k!+X`e~w55Q}HA=3Dc?CM9`EK` z^o5GF_RsnG`ey+9wOf8O4bzg>7W*;jU~M?g`OZAA$mNp|Lz<$s+~N9!2`ir8RcClo$(Q~19INM~9}j;&*|enC yGd}kJak0wj?aUKd8;%}`i}SSew>!A-2iw}^5}Rh(M>+vRkipZ{&t;ucLK6U4uc96R diff --git a/docs/newapi.xsl b/docs/newapi.xsl index f2e8bd5334..d48b1fbecd 100644 --- a/docs/newapi.xsl +++ b/docs/newapi.xsl @@ -91,28 +91,6 @@ - - - - - - - - - - - - - - - - - - -
<= img src=3D"left.png" width=3D"24" height=3D"24" border=3D"0" alt=3D"Prev"><= /img>3D"Up"API documentation3D"Home"The virtualizatio= n API3D"Next"
-
- --=20 2.37.3 From nobody Sat May 4 17:34:35 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1667478808; cv=none; d=zohomail.com; s=zohoarc; b=HSO3dwGOSoszx/PLFnfPjpCSaQm5cBY0JCX7VhkFmS+Uzq1mucwFWICDimJDcBZIkeCL1bb7+vJg16Sk51jtm6gyRBrphzS7boxMkxvxiSOcPHdA3rIvO7Y9Z0m9av8GKLSo7tzuMYc7cEuAC58/LQGuZs1FUVmTQ2BoiE8g+QA= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1667478808; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=qrJS4KYKLXYHUAQInQpPqKKfSTDT1suL8HCGB/3/itM=; b=RUEDxsDBBkVBWQKgOXs3vsnIhYXeONNmtx3SEpePy9CUxl0ytjIhdktqMABD67VjGyubfDfHC87amfOZDb7/Sn4Ciqr2aS9BBOZ1bjM4jBav3WJrqbGg4aBSJcs1jt9FKZTUX2jIJ3inDhoWWLIeV6cQ09NijdWeERf6MPdV/Mg= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1667478808350152.94883402793187; Thu, 3 Nov 2022 05:33:28 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-592-vGDp9qpbP8C1Z6zPixv-9w-1; Thu, 03 Nov 2022 08:33:23 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 4A4F23816EBC; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 2E78E1402BD9; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 20E9819465A4; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 990581946594 for ; Thu, 3 Nov 2022 12:33:19 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 6E59E39D7C; Thu, 3 Nov 2022 12:33:19 +0000 (UTC) Received: from speedmetal.redhat.com (ovpn-208-3.brq.redhat.com [10.40.208.3]) by smtp.corp.redhat.com (Postfix) with ESMTP id DA8594EA4C for ; Thu, 3 Nov 2022 12:33:18 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1667478807; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=qrJS4KYKLXYHUAQInQpPqKKfSTDT1suL8HCGB/3/itM=; b=Jo49Tqat1Yi+E3PtBpv6bmT0fk86dH8XE7oqkpPGdF4rTjqOfJTrzBvW93RZdymcJEvCFm rnJNgXq6t5WuQqsM+F7sv/u0RqpzKHIpzFBx0SBpHsf8SDumdzl3lPOFtGvzMhkStMBUbK rMKrQJPJ1amT0y7/vg0gfggq3beyoK4= X-MC-Unique: vGDp9qpbP8C1Z6zPixv-9w-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 2/5] docs: xsl: Don't format empty sections in API manual Date: Thu, 3 Nov 2022 13:33:12 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.5 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.7 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1667478810330100004 Content-Type: text/plain; charset="utf-8" The LXC module has no exported 'Types' but the XSL template which generates the 'libvirt-libvirt-lxc.html' page would try to format it anyways. This would result in an empty non-pair version of the '
'
tag to be used in the page, which didn't render well with modern
browsers for some reason. All following sections would become children
of the non-pair 
.

Fix the XSL template to not generate empty 'Types' or 'Functions'
sections similarly to how we do with 'Macros'.

Signed-off-by: Peter Krempa 
Reviewed-by: J=C3=A1n Tomko 
---
 docs/newapi.xsl | 48 ++++++++++++++++++++++++++++--------------------
 1 file changed, 28 insertions(+), 20 deletions(-)

diff --git a/docs/newapi.xsl b/docs/newapi.xsl
index d48b1fbecd..7b0085930f 100644
--- a/docs/newapi.xsl
+++ b/docs/newapi.xsl
@@ -756,18 +756,22 @@
             
           
-

Types

-
-          
-            
-          
-        
-

Functions

-
-          
-            
-          
-        
+ 0"> +

Types

+
+            
+              
+            
+          
+
+ 0"> +

Functions

+
+            
+              
+            
+          
+

Description

@@ -777,14 +781,18 @@ -

Types

- - - -

Functions

- - - + 0"> +

Types

+ + + +
+ 0"> +

Functions

+ + + +
--=20 2.37.3 From nobody Sat May 4 17:34:35 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1667478849; cv=none; d=zohomail.com; s=zohoarc; b=YhAR65E2baHa6yTmU9xlvyqGCrdBHgLV0vXaftvavkgxVf7UhVrPh9caDTCHuC6Xz+U90shP40I03guUJ4VBQ6LWeyDUjf8m36vQZ4VPya6AzFxHhO750UzNCRMsGv1TsMPXayE2jBCBljbuqqVOFdqslkEgjbGvXePV+orpqkc= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1667478849; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=rB/uFIKm1YHZvpt67Pzl9acxLC1iViqecVtKIolC+Yo=; b=BUVsMG0BM0DL0diRN6sWGMpS8jjsojzydxQcYjmft9/PJ0RNCoj/ZD4TNt8xpxhwDRKNDkrB+0KW4Xh8jfxuFul4LOzuP6c3fPtX9fFbDv3nSB0eXkWYU4O3jba6TMkc9TmfXl0PoMNy18ZsPTaT6B+vZDaKz9ijq9yoS5vl5j8= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1667478849300398.9576812493692; Thu, 3 Nov 2022 05:34:09 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-475-8bGq4XQiPPa8rr2xxmH9FA-1; Thu, 03 Nov 2022 08:33:24 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.rdu2.redhat.com [10.11.54.1]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id A0F592823824; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8787840C83F1; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 752B01946A62; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 62D131946594 for ; Thu, 3 Nov 2022 12:33:20 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 59DE44EA55; Thu, 3 Nov 2022 12:33:20 +0000 (UTC) Received: from speedmetal.redhat.com (ovpn-208-3.brq.redhat.com [10.40.208.3]) by smtp.corp.redhat.com (Postfix) with ESMTP id C80E439D7C for ; Thu, 3 Nov 2022 12:33:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1667478848; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=rB/uFIKm1YHZvpt67Pzl9acxLC1iViqecVtKIolC+Yo=; b=TK/sn7dkELFBwxFWULwZcF/eSVWMw0kHDAYNk3V8pHI9nTKqQcIPu1hWR2RF4BYlHjqiee AS2YmhTbgf4nl8GB59eKUJZHsO3JVx7AueH4epDXsy2jf2pouvaJsjLEBKZrHXVaoTj++H OB3SrONiKtdFTgNmXJqOVw7xl70uQs8= X-MC-Unique: 8bGq4XQiPPa8rr2xxmH9FA-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 3/5] apibuild: Don't include the Copyright in the of a module Date: Thu, 3 Nov 2022 13:33:13 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.5 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.1 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1667478850492100001 Content-Type: text/plain; charset="utf-8" When building the top level description from a header file the 'parseTopComment' method of the 'CParser' would include all trailing lines into the field. This was designed to concatenate multi-line descriptions, but unfortunately in all cases also included the Copyright statement which followed. Explicitly end the scanning of the header on a line which starts with 'Copyright (C)' and truncate the spaces from the end of the last item. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- scripts/apibuild.py | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/scripts/apibuild.py b/scripts/apibuild.py index c232b4e2c8..4ded66bc02 100755 --- a/scripts/apibuild.py +++ b/scripts/apibuild.py @@ -721,6 +721,14 @@ class CParser: item =3D m.group(1) line =3D m.group(2).lstrip() + # don't include the Copyright in the last 'item' + if line.startswith("Copyright (C)"): + # truncate any whitespace originating from newlines + # before the Copyright + if item: + res[item] =3D res[item].rstrip() + break + if item: if item in res: res[item] =3D res[item] + " " + line --=20 2.37.3 From nobody Sat May 4 17:34:35 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) client-ip=170.10.129.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1667478809; cv=none; d=zohomail.com; s=zohoarc; b=a13AgaaCI9vMcKU+JnUDc6KHYeHNqc55evLRKwMWm7xuRIH98s9aehkI2961q20LnYYn8LmCZ95SfmDG285md9ezEzy1oLLkk7p570ZYtRQhjDsEzaZZ7CfZa0oLkIsDojG1hmY4p91GlWB5UopK0yVMQSt1qYcbuGGWoeHSk0I= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1667478809; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=P8FzljJL0f5urrHRv/gsL55DxmzFxGani5ptl+C0HZ4=; b=QH4+0L1hDp0U/gikd/yCya+UFfDaPtTse+9WJQNf23XU1aNLpXKsdsfg70rvjQhedwBS5ywT6TOGaf6YrFTsl/rhnA5Pj+jpnNfLNO8vbbIQuDt2AQHz2YATzIWdT6jT8wKYopd44tL7F08X1Nh0yeW8DtQ7fOxawicXZwQf10c= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.129.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) by mx.zohomail.com with SMTPS id 1667478809025979.2852296412027; Thu, 3 Nov 2022 05:33:29 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mx3-rdu2.redhat.com [66.187.233.73]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-373-eoYGiATSPT2U7ffAcqUntQ-1; Thu, 03 Nov 2022 08:33:25 -0400 Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.rdu2.redhat.com [10.11.54.7]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 9E5EB3C0F42A; Thu, 3 Nov 2022 12:33:22 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id 8B2741401C21; Thu, 3 Nov 2022 12:33:22 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 74DB019465A4; Thu, 3 Nov 2022 12:33:22 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 4E2331946A6C for ; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 428054EA53; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) Received: from speedmetal.redhat.com (ovpn-208-3.brq.redhat.com [10.40.208.3]) by smtp.corp.redhat.com (Postfix) with ESMTP id B1E7D63A55 for ; Thu, 3 Nov 2022 12:33:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1667478808; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=P8FzljJL0f5urrHRv/gsL55DxmzFxGani5ptl+C0HZ4=; b=SVfO/ELmoJgrLw0QArra/VSXRd43WfclJq5Ocr1VhEbQ+Aazk3oDUSfzT0L4HYkx3M0GFh VihZjIPBU0cqJfGxrT6jZfT3J9ysOwfd7SL5N73IrA8+De4PjMdY0TUKarRf1XHy4WGjTf NHAyB4iFx6iBr2KvsfNM369O78dkhNI= X-MC-Unique: eoYGiATSPT2U7ffAcqUntQ-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 4/5] docs: Link directly to admin|qemu|lxc API reference pages Date: Thu, 3 Nov 2022 13:33:14 +0100 Message-Id: <1acf2e36516a84aacc3907b82dc6219e31eb0315.1667478479.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.5 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.7 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1667478810326100003 Content-Type: text/plain; charset="utf-8" Fix the main links in docs.rst main page to go to the full docs rather than prompting one more click to the index page. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/docs.rst | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/docs.rst b/docs/docs.rst index de08a778dc..a826bd128c 100644 --- a/docs/docs.rst +++ b/docs/docs.rst @@ -72,9 +72,9 @@ Application development `secret `__, `storage `__, `stream `__ and - `admin `__, - `QEMU `__, - `LXC `__ libs + `admin `__, + `QEMU `__, + `LXC `__ libs `Language bindings and API modules `__ Bindings of the libvirt API for --=20 2.37.3 From nobody Sat May 4 17:34:35 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) client-ip=170.10.133.124; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-124.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com ARC-Seal: i=1; a=rsa-sha256; t=1667478812; cv=none; d=zohomail.com; s=zohoarc; b=b6Mj5OkVaqGKEhyK9zZBX3NVAVPxxjGIXyY5EV1vFJ04M2IUC/10I+EM2fXVzDcT/EMJw5QoAcUUA4OcjZIpC2PEVzpmG8SE9V0f1KiqibpteujmUF3NSVIBbGAe0+f+MTqBBAKoVn9LSpxUv8LW7kpFGLWOqlWc2tbtgS/z0+g= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1667478812; h=Content-Type:Content-Transfer-Encoding:Date:From:In-Reply-To:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:References:Sender:Subject:To; bh=Z5kbreVjAUNLm2hc+Hx1p6jCpG+fZJeAgGGGszmqh3c=; b=eRoivjKeHkrFRRVreWPixoYAClJKUkpvct+QaZtIoKSbToQTJsvVB390GQASwSvbTg9HOjKfcZpR1UqI0Pt7VReMmKvEPm2qmO76INOrykIqLZNwnCWg5mbMgfpIgr+D04zCoKfk4U2xdJ9uGAyPMu2/ucpWT0HvWGQuzspL0Ys= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 170.10.133.124 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by mx.zohomail.com with SMTPS id 1667478812828208.0349849766351; Thu, 3 Nov 2022 05:33:32 -0700 (PDT) Received: from mimecast-mx02.redhat.com (mimecast-mx02.redhat.com [66.187.233.88]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id us-mta-658-gP2pf_d9OlmTmKvsgd1C0Q-1; Thu, 03 Nov 2022 08:33:26 -0400 Received: from smtp.corp.redhat.com (int-mx03.intmail.prod.int.rdu2.redhat.com [10.11.54.3]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx02.redhat.com (Postfix) with ESMTPS id 059E3101A52A; Thu, 3 Nov 2022 12:33:24 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (unknown [10.30.29.100]) by smtp.corp.redhat.com (Postfix) with ESMTP id E27211121331; Thu, 3 Nov 2022 12:33:23 +0000 (UTC) Received: from mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (localhost [IPv6:::1]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id B5EFD19465A4; Thu, 3 Nov 2022 12:33:23 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.rdu2.redhat.com [10.11.54.5]) by mm-prod-listman-01.mail-001.prod.us-east-1.aws.redhat.com (Postfix) with ESMTP id 453681946594 for ; Thu, 3 Nov 2022 12:33:22 +0000 (UTC) Received: by smtp.corp.redhat.com (Postfix) id 392454EA4C; Thu, 3 Nov 2022 12:33:22 +0000 (UTC) Received: from speedmetal.redhat.com (ovpn-208-3.brq.redhat.com [10.40.208.3]) by smtp.corp.redhat.com (Postfix) with ESMTP id A36D339D7C for ; Thu, 3 Nov 2022 12:33:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1667478811; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post; bh=Z5kbreVjAUNLm2hc+Hx1p6jCpG+fZJeAgGGGszmqh3c=; b=BVaM4CPOIhgFZdpVl/x7aqoaKSM5qs8rR0SHTYGj2qYT9vHjORYz6oSTsR4wrHPll1GHoD U1BwhslvrGyRBW+6us4MQSt8aQTBLQAT4RCh3uj9ZQ0PtLOYP6kGCMVsVzM5bh9qdD4GmQ VUF2VjkhWXrwSd8w8EKlDWv7na3uQwo= X-MC-Unique: gP2pf_d9OlmTmKvsgd1C0Q-1 X-Original-To: libvir-list@listman.corp.redhat.com From: Peter Krempa To: libvir-list@redhat.com Subject: [PATCH 5/5] docs: xsl: Don't generate pointless index pages for qemu/admin/lxc API Date: Thu, 3 Nov 2022 13:33:15 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 3.1 on 10.11.54.5 X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.29 Precedence: list List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: libvir-list-bounces@redhat.com Sender: "libvir-list" X-Scanned-By: MIMEDefang 3.1 on 10.11.54.3 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) X-ZM-MESSAGEID: 1667478814608100001 Content-Type: text/plain; charset="utf-8" The index page only really makes sense for the top level directory. The specific index files are unreferenced since last commit. Drop them. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/html/meson.build | 3 +-- docs/newapi.xsl | 28 +++++++++++++++------------- 2 files changed, 16 insertions(+), 15 deletions(-) diff --git a/docs/html/meson.build b/docs/html/meson.build index 83dee91ec5..b18a8ccb5f 100644 --- a/docs/html/meson.build +++ b/docs/html/meson.build @@ -28,6 +28,7 @@ index_api_gen =3D custom_target( xsltproc_prog, '--nonet', '-o', docs_builddir, '--stringparam', 'builddir', meson.project_build_root(), '--stringparam', 'timestamp', docs_timestamp, + '--stringparam', 'indexfile', 'index.html', '@INPUT@', ], install: true, @@ -48,14 +49,12 @@ foreach name : [ 'admin', 'lxc', 'qemu' ] get_variable('docs_@0@_api_xml'.format(name)), ], output: [ - 'index-@0@.html'.format(name), 'libvirt-libvirt-@0@.html'.format(name), ], command: [ xsltproc_prog, '--nonet', '-o', docs_builddir, '--stringparam', 'builddir', meson.project_build_root(), '--stringparam', 'timestamp', docs_timestamp, - '--stringparam', 'indexfile', 'index-@0@.html'.format(name), '@INPUT@', ], install: true, diff --git a/docs/newapi.xsl b/docs/newapi.xsl index 7b0085930f..3de603bb00 100644 --- a/docs/newapi.xsl +++ b/docs/newapi.xsl @@ -22,7 +22,7 @@ - + html @@ -823,18 +823,20 @@ - - - - - - - - + + + + + + + + + + --=20 2.37.3