From nobody Sun May 5 21:01:25 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1548775974525635.9417959143348; Tue, 29 Jan 2019 07:32:54 -0800 (PST) Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id 71864C03347E; Tue, 29 Jan 2019 15:32:50 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 27A2E5C25D; Tue, 29 Jan 2019 15:32:50 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id CDC0E18033A3; Tue, 29 Jan 2019 15:32:49 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id x0TFWhS6005045 for ; Tue, 29 Jan 2019 10:32:43 -0500 Received: by smtp.corp.redhat.com (Postfix) id A44145D97E; Tue, 29 Jan 2019 15:32:43 +0000 (UTC) Received: from angien.brq.redhat.com (unknown [10.43.2.229]) by smtp.corp.redhat.com (Postfix) with ESMTP id 295725D97A for ; Tue, 29 Jan 2019 15:32:42 +0000 (UTC) From: Peter Krempa To: libvir-list@redhat.com Date: Tue, 29 Jan 2019 16:32:35 +0100 Message-Id: <95820193af6253002f024854331461bf54ad36c0.1548775904.git.pkrempa@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH v2 1/2] docs: Format bit shift and hex notation for bitwise flag enums X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.32]); Tue, 29 Jan 2019 15:32:51 +0000 (UTC) Content-Type: text/plain; charset="utf-8" Big number itself does not make much sense in some cases. Format the bitshift format as well. Changes our web page docs from: VIR_MIGRATE_POSTCOPY =3D 32768 : Setting the VIR_MIGRATE_POSTCOPY... VIR_MIGRATE_TLS =3D 65536 : Setting the VIR_MIGRATE_TLS flag... to: VIR_MIGRATE_POSTCOPY =3D 32768 (0x8000; 1 << 15) : Setting the VIR_MIGRATE= _POSTCOPY... VIR_MIGRATE_TLS =3D 65536 (0x10000; 1 << 16) : Setting the VIR_MIGRATE= _TLS flag... Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/apibuild.py | 10 ++++++++++ docs/libvirt.css | 4 ++++ docs/newapi.xsl | 22 ++++++++++++++++++++-- 3 files changed, 34 insertions(+), 2 deletions(-) diff --git a/docs/apibuild.py b/docs/apibuild.py index 3ef5d0f554..9e04871220 100755 --- a/docs/apibuild.py +++ b/docs/apibuild.py @@ -2117,12 +2117,22 @@ class docBuilder: self.modulename_file(id.header))) if id.info is not None: info =3D id.info + valhex =3D "" if info[0] is not None and info[0] !=3D '': try: val =3D eval(info[0]) + valhex =3D hex(val) except: val =3D info[0] output.write(" value=3D'%s'" % (val)) + + if valhex !=3D "": + output.write(" value_hex=3D'%s'" % (valhex)) + + m =3D re.match("\(?1<<(\d+)\)?", info[0]) + if m: + output.write(" value_bitshift=3D'%s'" % (m.group(1))) + if info[2] is not None and info[2] !=3D '': output.write(" type=3D'%s'" % info[2]) if info[1] is not None and info[1] !=3D '': diff --git a/docs/libvirt.css b/docs/libvirt.css index e590b33cfb..c5fe27fa3f 100644 --- a/docs/libvirt.css +++ b/docs/libvirt.css @@ -537,3 +537,7 @@ dl.mail dt a:hover { color: rgb(255, 230, 0); text-decoration: none; } + +td.enumvalue { + white-space: nowrap; +} diff --git a/docs/newapi.xsl b/docs/newapi.xsl index 8d4c032c03..c808fe5ff8 100644 --- a/docs/newapi.xsl +++ b/docs/newapi.xsl @@ -288,6 +288,24 @@ + + + + + + + ( + + + + + ; 1 << + + + ) + + +

<= /a>

@@ -306,7 +324,7 @@ =3D - +
@@ -316,7 +334,7 @@ - + --=20 2.20.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list From nobody Sun May 5 21:01:25 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; envelope-from=libvir-list-bounces@redhat.com; helo=mx1.redhat.com; Authentication-Results: mx.zohomail.com; spf=pass (zoho.com: domain of redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass(p=none dis=none) header.from=redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by mx.zohomail.com with SMTPS id 1548775971086778.9972889096629; Tue, 29 Jan 2019 07:32:51 -0800 (PST) Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id C50858830E; Tue, 29 Jan 2019 15:32:47 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 88EF75C25D; Tue, 29 Jan 2019 15:32:47 +0000 (UTC) Received: from lists01.pubmisc.prod.ext.phx2.redhat.com (lists01.pubmisc.prod.ext.phx2.redhat.com [10.5.19.33]) by colo-mx.corp.redhat.com (Postfix) with ESMTP id 2F520180339F; Tue, 29 Jan 2019 15:32:47 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx04.intmail.prod.int.phx2.redhat.com [10.5.11.14]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id x0TFWikZ005053 for ; Tue, 29 Jan 2019 10:32:44 -0500 Received: by smtp.corp.redhat.com (Postfix) id 754C55D985; Tue, 29 Jan 2019 15:32:44 +0000 (UTC) Received: from angien.brq.redhat.com (unknown [10.43.2.229]) by smtp.corp.redhat.com (Postfix) with ESMTP id F011B5D97A for ; Tue, 29 Jan 2019 15:32:43 +0000 (UTC) From: Peter Krempa To: libvir-list@redhat.com Date: Tue, 29 Jan 2019 16:32:36 +0100 Message-Id: In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH v2 2/2] docs: css: Make docs page wider while still accomodating narrow screens X-BeenThere: libvir-list@redhat.com X-Mailman-Version: 2.1.12 Precedence: junk List-Id: Development discussions about the libvirt library & tools List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Transfer-Encoding: quoted-printable Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.28]); Tue, 29 Jan 2019 15:32:49 +0000 (UTC) Content-Type: text/plain; charset="utf-8" Bump the width to 85em while keeping a maximum width of 90%. Signed-off-by: Peter Krempa Reviewed-by: J=C3=A1n Tomko --- docs/libvirt.css | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/libvirt.css b/docs/libvirt.css index c5fe27fa3f..dcae2a338a 100644 --- a/docs/libvirt.css +++ b/docs/libvirt.css @@ -100,14 +100,15 @@ margin-right: auto; padding: 0px; padding-bottom: 1em; - max-width: 60em; + max-width: 90%; + width: 85em; } body.index #content, body.docs #content, body.hvsupport #content { - max-width: inherit; + width: inherit; } pre { --=20 2.20.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list