From nobody Wed May 15 02:39:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) client-ip=205.139.110.61; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 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=1586167649; cv=none; d=zohomail.com; s=zohoarc; b=g/KBE/SzMgXzJQA9TT9QWpxmhqPGF+ifdyTEmmVSciAHRczaBlhRv2o1wqVxMAYzW8FOWAxPZ1qj128b/O1wFu+zaJZ2KLLEYZV4mw1jrZyBxchQhZp5uZVmoNbPwVr36GzkYkX4ZZ3fNoqPg109+CKVLw1xPAFZ9Fd0iKZgwog= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586167649; 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=V4p7G+Yww+sjwxI3Cgce+In+pzEegxaKTPS0w1QKe10=; b=SEGO3xrmoUyTFkp/5v7e8fATzIJsW1R4T6AkCywkfpUmohkSFz7xdwonUiz76Si4j7nLyJMzTtS+Nqjl+rlwaPdAE7hx8tGGqtB+foC/jc3E3Bg0vglCnXu7YL+xB37XxND5KBgDM9oPRPmSFW7KyV98BqBwUA3Kr3bcGBpge0M= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 205.139.110.61 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-1.mimecast.com (us-smtp-2.mimecast.com [205.139.110.61]) by mx.zohomail.com with SMTPS id 1586167649342478.7491425172308; Mon, 6 Apr 2020 03:07:29 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-324-ZF65zqqYMwesEm0XUTqqgg-1; Mon, 06 Apr 2020 06:07:25 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id E29541084439; Mon, 6 Apr 2020 10:07:19 +0000 (UTC) Received: from colo-mx.corp.redhat.com (colo-mx02.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 42DD7118F3E; Mon, 6 Apr 2020 10:07:19 +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 B60E193A66; Mon, 6 Apr 2020 10:07:16 +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 036A7Gld003473 for ; Mon, 6 Apr 2020 06:07:16 -0400 Received: by smtp.corp.redhat.com (Postfix) id 1F2695DA7B; Mon, 6 Apr 2020 10:07:16 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.194.41]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 4E7E55D9C5 for ; Mon, 6 Apr 2020 10:07:14 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586167648; 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=V4p7G+Yww+sjwxI3Cgce+In+pzEegxaKTPS0w1QKe10=; b=PniYOGjCxRVuVKlojhbdxhjRvkK68eteRQmZ0uMM+BIOrO3b33pjGGoPVBXKJ9N18Btw7u RQiptIxbvpR9rjw6bogNbd9kBarYmxdEFkzxVVf9Ezodx0rOFJmPI7ZHTFz4Gz6FhWy3qt /Y76unY220DvIB9n5Oq3lIO+prncJKE= X-MC-Unique: ZF65zqqYMwesEm0XUTqqgg-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 1/2] CONTRIBUTING: Add entry point for new contributors Date: Mon, 6 Apr 2020 12:07:05 +0200 Message-Id: <20200406100706.466011-2-abologna@redhat.com> In-Reply-To: <20200406100706.466011-1-abologna@redhat.com> References: <20200406100706.466011-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-loop: libvir-list@redhat.com 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: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" It's generally expected that a git repository will contain this file, which serves as an entry point for people interested in contributing to the project. In our case, we have extensive documentation available on the website which we don't want to duplicate, so let's just point people there. Signed-off-by: Andrea Bolognani Reviewed-by: J=C3=A1n Tomko --- CONTRIBUTING.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000000..a8551965bd --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,18 @@ +Contributing to libvirt +=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D=3D + +Full, up to date information on how to contribute to libvirt can be +found on the libvirt website: + +[https://libvirt.org/hacking.html](https://libvirt.org/hacking.html) + +To build the same document locally, from the top level directory of +your git clone run: + +``` +$ mkdir build && cd build +$ ../autogen.sh +$ make +``` + +You'll find the freshly-built document in `docs/hacking.html`. --=20 2.25.1 From nobody Wed May 15 02:39:48 2024 Delivered-To: importer@patchew.org Received-SPF: pass (zohomail.com: domain of redhat.com designates 207.211.31.81 as permitted sender) client-ip=207.211.31.81; envelope-from=libvir-list-bounces@redhat.com; helo=us-smtp-delivery-1.mimecast.com; Authentication-Results: mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.81 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=1586167664; cv=none; d=zohomail.com; s=zohoarc; b=LW7GO9VrEdkM8cHHst6vhwlPico1GPo2cxPg8EukCiqCrgMSL30kwWKJgqIuRsM56jLCpSJlJDFJ/yIRvYB76Ys2z/hZPNC2RJ2JCOaNK6IMIDJ5lWe9HGeKxYSb1nQt72lxoeG0kI+KRiplhFBFP9ma3KS8TvYW99h8r8L8ps8= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1586167664; 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=/Bt04EsnVdQ5dlWKQ/fek3r9QUiXYfWn92/yKfC0mG4=; b=Ak4hXk0u04hFjFacSZ4pauVSeCJ2C86LrvHSBFxBtb6cDhMQIbcE0C4/P7HVgUcaDeTHugsg0oODDGMYkuOAZ2vJ83z9MYOU8APpDA6BJHq94CwV08mA2LQ4mvXSzyBx7fBzjaMKLTjXNqGXjkIwdyPtaTUsqj36LeO87cY+JcM= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass; spf=pass (zohomail.com: domain of redhat.com designates 207.211.31.81 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass header.from= (p=none dis=none) header.from= Return-Path: Received: from us-smtp-delivery-1.mimecast.com (us-smtp-2.mimecast.com [207.211.31.81]) by mx.zohomail.com with SMTPS id 1586167664955729.0138134532782; Mon, 6 Apr 2020 03:07:44 -0700 (PDT) Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-291-JLsq-1uzNkWHtdYTz_65Og-1; Mon, 06 Apr 2020 06:07:40 -0400 Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 8B5F718B5F6D; Mon, 6 Apr 2020 10:07:35 +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 4E0C2118F42; Mon, 6 Apr 2020 10:07:35 +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 EC04E18089CE; Mon, 6 Apr 2020 10:07:34 +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 036A7H5T003484 for ; Mon, 6 Apr 2020 06:07:17 -0400 Received: by smtp.corp.redhat.com (Postfix) id C0D275DA7B; Mon, 6 Apr 2020 10:07:17 +0000 (UTC) Received: from kinshicho.usersys.redhat.com (unknown [10.40.194.41]) by smtp.corp.redhat.com (Postfix) with ESMTPS id B308F5D9C5 for ; Mon, 6 Apr 2020 10:07:16 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1586167663; 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=/Bt04EsnVdQ5dlWKQ/fek3r9QUiXYfWn92/yKfC0mG4=; b=AeIorZZLiMJZyPUCChpDNbrMyGedKKVZsyKGp8Cckg1sV4pElifLQd+pGVZI5cMkR9LCis 1SHiz8GfxTR5km3r5scyb0fIlAzE8lg96DP1QyKXn9vcyx0oyx7JDTzcjQDWJGbV/w+p3F tXfP13FMK4PfZEBemjAluugLGSvQDdI= X-MC-Unique: JLsq-1uzNkWHtdYTz_65Og-1 From: Andrea Bolognani To: libvir-list@redhat.com Subject: [libvirt PATCH 2/2] README-hacking: Drop from the git repository Date: Mon, 6 Apr 2020 12:07:06 +0200 Message-Id: <20200406100706.466011-3-abologna@redhat.com> In-Reply-To: <20200406100706.466011-1-abologna@redhat.com> References: <20200406100706.466011-1-abologna@redhat.com> MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.14 X-loop: libvir-list@redhat.com 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: , Sender: libvir-list-bounces@redhat.com Errors-To: libvir-list-bounces@redhat.com X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Transfer-Encoding: quoted-printable X-ZohoMail-DKIM: pass (identity @redhat.com) Content-Type: text/plain; charset="utf-8" The newly-introduced CONTRIBUTING.md serves the same purposes and lives in the path where most people would look for it. Signed-off-by: Andrea Bolognani Reviewed-by: J=C3=A1n Tomko --- README-hacking | 56 -------------------------------------------------- 1 file changed, 56 deletions(-) delete mode 100644 README-hacking diff --git a/README-hacking b/README-hacking deleted file mode 100644 index 89fa86be30..0000000000 --- a/README-hacking +++ /dev/null @@ -1,56 +0,0 @@ --*- outline -*- - -These notes intend to help people working on the checked-out sources. -These requirements do not apply when building from a distribution tarball. -See also docs/hacking.html (after building libvirt using the information -included in this file) for more detailed contribution guidelines. - -* Requirements - -We've opted to keep only the highest-level sources in the GIT repository. -This eases our maintenance burden, (fewer merges etc.), but imposes more -requirements on anyone wishing to build from the just-checked-out sources. -Note the requirements to build the released archive are much less and -are just the requirements of the standard configure && make procedure. -Specific development tools and versions will be checked for and listed by -the bootstrap script. - -Valgrind is also highly recommended, if -Valgrind supports your architecture. - -While building from a just-cloned source tree may require installing a -few prerequisites, later, a plain `git pull && make' should be sufficient. - -* First GIT checkout - -You can get a copy of the source repository like this: - - $ git clone https://libvirt.org/git/libvirt.git - $ cd libvirt - -We require to have the build directory different than the source directory: - - $ mkdir build && cd build - -The next step is to invoke ../autogen.sh: - - $ ../autogen.sh - -And there you are! Just - - $ make - $ make check - -At this point, there should be no difference between your local copy, -and the GIT master copy: - - $ cd .. - $ git diff - -should output no difference. - -Enjoy! - -Local Variables: -indent-tabs-mode: nil -End: --=20 2.25.1