From patchwork Wed Mar 13 17:11:32 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Cole Robinson X-Patchwork-Id: 160259 Delivered-To: patch@linaro.org Received: by 2002:a02:5cc1:0:0:0:0:0 with SMTP id w62csp14555870jad; Wed, 13 Mar 2019 10:11:54 -0700 (PDT) X-Google-Smtp-Source: APXvYqwie8rIjwvqc6HItlXsFolHmO1lgwuGnRNiSm+QTRjgCoMAMAfs1idKyiBK8vgMVy7riZg4 X-Received: by 2002:a37:7e84:: with SMTP id z126mr32025720qkc.31.1552497114447; Wed, 13 Mar 2019 10:11:54 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1552497114; cv=none; d=google.com; s=arc-20160816; b=uXl7K3yy15pBIqZY9l1okedIR2891KBRcYLH74GsspvcWcx7Oi9EPNzI2wwhLOb4Zc D1wOLEA9ss9+ZQznO5ruv23DicT16BRSRKobM+EJQVKMcrHrAlwLg/4MHWt8RQmIWfHy 9NdrS4YvuWVE86eDwQW1GK8C9QiaE9LbGC+e4aRpS/PwGdOYPeTf9i0ks7NZVWTqTJDf PbUXP6VdSka8joVEywHC6x9tIqqV7V/lyP/YQf+KGlO1GNE8ZUJjH8rH92eKY9U16xey bioBdIU9UbLObQl0uddNciDKJ8CXEwI7n0eifrAWdX5fB9+Y/+y8XDBvegDCW7Fu81Rc 7Uxw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=errors-to:sender:content-transfer-encoding:list-subscribe:list-help :list-post:list-archive:list-unsubscribe:list-id:precedence:subject :mime-version:references:in-reply-to:message-id:date:to:from :delivered-to; bh=FXJwjP9nto8BpQLkHloAcBZYE6RU2DcMpoAlbgSTjDA=; b=CW3Xa0D0ymHTeEzVMJAIy1m+XTtGFurZMYClL7WvXcV/E+OBIrOoe4OCzvHSVHg0KT M7ndBlwWVlc9i3dldH/pjwX7d7eKM+97Ak87AX6317pnAF+MHGlpTZNiBYa68VmlYFWK dSV2tzpQs4KfNXxeqqPLrANtLD0GCqMbBpF96DBOwYNqQ4x6tySU0X8LbXGlc6Gk3TEe xkZy/TvdjNb2bTydfD4we1kWTeNcWWvfM0rQ9cy/E3yCgPk222Q7ClUlBcrIjIclEbqI 4BBfjIh8VYBSWiq7c1VixxXyoQGOc7QYDX1k7CF3hMqTIcjROHuc5lmhqDVqp8fObFaC wFVg== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of libvir-list-bounces@redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Return-Path: Received: from mx1.redhat.com (mx1.redhat.com. [209.132.183.28]) by mx.google.com with ESMTPS id t25si373832qtt.104.2019.03.13.10.11.54 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Wed, 13 Mar 2019 10:11:54 -0700 (PDT) Received-SPF: pass (google.com: domain of libvir-list-bounces@redhat.com designates 209.132.183.28 as permitted sender) client-ip=209.132.183.28; Authentication-Results: mx.google.com; spf=pass (google.com: domain of libvir-list-bounces@redhat.com designates 209.132.183.28 as permitted sender) smtp.mailfrom=libvir-list-bounces@redhat.com; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=redhat.com Received: from smtp.corp.redhat.com (int-mx07.intmail.prod.int.phx2.redhat.com [10.5.11.22]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mx1.redhat.com (Postfix) with ESMTPS id F0A1730EEF99; Wed, 13 Mar 2019 17:11:52 +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 C8A661024940; Wed, 13 Mar 2019 17:11:52 +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 768D9181A136; Wed, 13 Mar 2019 17:11:52 +0000 (UTC) Received: from smtp.corp.redhat.com (int-mx01.intmail.prod.int.phx2.redhat.com [10.5.11.11]) by lists01.pubmisc.prod.ext.phx2.redhat.com (8.13.8/8.13.8) with ESMTP id x2DHBmmb016881 for ; Wed, 13 Mar 2019 13:11:48 -0400 Received: by smtp.corp.redhat.com (Postfix) id 184FB87A6; Wed, 13 Mar 2019 17:11:48 +0000 (UTC) Delivered-To: libvirt-list@redhat.com Received: from worklaptop.redhat.com (ovpn-124-40.rdu2.redhat.com [10.10.124.40]) by smtp.corp.redhat.com (Postfix) with ESMTP id 16FC0605A8; Wed, 13 Mar 2019 17:11:42 +0000 (UTC) From: Cole Robinson To: libvirt-list@redhat.com Date: Wed, 13 Mar 2019 13:11:32 -0400 Message-Id: <6a3cf5c22c9a83c33bf68cd8ab50643bab3c6ace.1552496850.git.crobinso@redhat.com> In-Reply-To: References: MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.11 X-loop: libvir-list@redhat.com Subject: [libvirt] [PATCH 2/2] docs: hacking: Add 'Code coverage reports' section 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.84 on 10.5.11.22 X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.5.16 (mx1.redhat.com [10.5.110.48]); Wed, 13 Mar 2019 17:11:53 +0000 (UTC) Signed-off-by: Cole Robinson --- docs/hacking.html.in | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+) -- 2.20.1 -- libvir-list mailing list libvir-list@redhat.com https://www.redhat.com/mailman/listinfo/libvir-list Reviewed-by: Martin Kletzander diff --git a/docs/hacking.html.in b/docs/hacking.html.in index f99d143b7b..56608fbc9e 100644 --- a/docs/hacking.html.in +++ b/docs/hacking.html.in @@ -1412,5 +1412,34 @@ int foo() in the same way, but still make sure they get reviewed if non-trivial. +

Code coverage reports

+ +

+ Code coverage HTML reports can be generated with: +

+ +
+  make coverage
+
+ +

+ Reports will be generated in the cov/ directory. Point a + web browser at cov/index.html for the full report. +

+ +

+ The make coverage target is provided by gnulib. + It is a convenience helper for calling the following 3 targets in order. + It may be useful to occasionally call these directly. + +

    +
  • make init-coverage: run make clean and + remove all code coverage counter files (*.gcno, etc)
    • +
  • make build-coverage: run make and + make check with CFLAGS filled in with + necessary coverage flags.
    • +
  • make gen-coverage: generate the HTML report
    • +
+