From nobody Thu Mar 28 23:36:14 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
ARC-Seal: i=1; a=rsa-sha256; t=1567684028; cv=none;
d=zoho.com; s=zohoarc;
b=Bj6sCUfK0ixMUCvo2y9b68rNZnTENeblKIzYgFcZLF0Hh1afxGCjzhfRM9niK2WZeiurGQdvRVQOa6mi2ab3DGL1gnO1y/JljrPD+1bhvUmRX40y0jJyv1KNqPIfzGLlkkBMwOy1WkN763OtXk9FDiZAsBcdA3/sodBHNNNR730=
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zoho.com;
s=zohoarc;
t=1567684028;
h=Content-Type:Content-Transfer-Encoding:Date:From:List-Subscribe:List-Post:List-Id:List-Archive:List-Help:List-Unsubscribe:MIME-Version:Message-ID:Sender:Subject:To:ARC-Authentication-Results;
bh=yp1r4Cc/ehUXdcmUX8+Xn61WKe4X52/EkMsiwzgDiuQ=;
b=L9QePCia3yxktOK4T1B6qqecvGnLCT6RBEdi4SVgXwYTJ2MYKyKy9QVP26ucQP2dk9hJUqeYHcrdzm+pfGsXuJRPqF7vqiO45sBW5ojI797EXhUY5sSfVFwS8PT6afyzwi1huxCpwoG4kNVkYPQsEB5DTBhFyFr2EyUX4C+bj9E=
ARC-Authentication-Results: i=1; mx.zoho.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 header.from= (p=none dis=none)
header.from=
Return-Path:
Received: from mx1.redhat.com (mx1.redhat.com [209.132.183.28]) by
mx.zohomail.com
with SMTPS id 156768402889857.63249462649401;
Thu, 5 Sep 2019 04:47:08 -0700 (PDT)
Received: from smtp.corp.redhat.com (int-mx02.intmail.prod.int.phx2.redhat.com
[10.5.11.12])
(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
(No client certificate requested)
by mx1.redhat.com (Postfix) with ESMTPS id 56E3E308FC20;
Thu, 5 Sep 2019 11:47:07 +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 086B860BE1;
Thu, 5 Sep 2019 11:47:07 +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 0FEB31802218;
Thu, 5 Sep 2019 11:47:06 +0000 (UTC)
Received: from smtp.corp.redhat.com (int-mx05.intmail.prod.int.phx2.redhat.com
[10.5.11.15])
by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP
id x85Bl4ql030676 for ;
Thu, 5 Sep 2019 07:47:04 -0400
Received: by smtp.corp.redhat.com (Postfix)
id B752E5D713; Thu, 5 Sep 2019 11:47:04 +0000 (UTC)
Received: from catbus.gsslab.fab.redhat.com (dhcp-32.gsslab.fab.redhat.com
[10.33.9.32])
by smtp.corp.redhat.com (Postfix) with ESMTP id 2903D5D704;
Thu, 5 Sep 2019 11:47:01 +0000 (UTC)
From: =?UTF-8?q?Daniel=20P=2E=20Berrang=C3=A9?=
To: libvir-list@redhat.com
Date: Thu, 5 Sep 2019 12:42:37 +0100
Message-Id: <20190905114237.19748-1-berrange@redhat.com>
MIME-Version: 1.0
X-Scanned-By: MIMEDefang 2.79 on 10.5.11.15
X-loop: libvir-list@redhat.com
Subject: [libvirt] [PATCH] docs: document that C & Python are the preferred
languages
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-Type: text/plain; charset="utf-8"
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.12
X-Greylist: Sender IP whitelisted,
not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.43]);
Thu, 05 Sep 2019 11:47:07 +0000 (UTC)
Blacklist Perl and Shell code in favour of Python for
sake of readability and portability.
Signed-off-by: Daniel P. Berrang=C3=A9
---
docs/hacking.html.in | 30 ++++++++++++++++++++++++++++++
1 file changed, 30 insertions(+)
diff --git a/docs/hacking.html.in b/docs/hacking.html.in
index 90376968c3..8572eb65a6 100644
--- a/docs/hacking.html.in
+++ b/docs/hacking.html.in
@@ -343,6 +343,36 @@
Richard Jones' guide to working with open source projects.
=20
+
+
+
+ The libvirt repository makes use of a large number of programming
+ languages. There is a general desire to phase out some of the
+ existing languages used to reduce the knowledge burden on
+ developers, and facilitate introduction of new languages in
+ the future.
+
+
+
+ The preferred languages at this time are
+
+
+
+ - C - for the main libvirt codebase. Dialect supported by
+ GCC/CLang only.
+ - Python - for supporting build scripts / tools. Code must
+ run with both version 2.7 and 3.x at this time.
+
+
+
+ Languages that should not be used for any new contributions.
+
+
+
+ - Perl - build scripts must be written in Python instead.
+ - Shell - build scripts must be written in Python instead.
+
+
=20
--=20
2.21.0
--
libvir-list mailing list
libvir-list@redhat.com
https://www.redhat.com/mailman/listinfo/libvir-list