From patchwork Mon Aug 10 09:24:07 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ray Kinsella X-Patchwork-Id: 75330 X-Patchwork-Delegate: david.marchand@redhat.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 281A2A04C1; Mon, 10 Aug 2020 11:24:27 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 5A3EB25D9; Mon, 10 Aug 2020 11:24:26 +0200 (CEST) Received: from dal1relay34.mxroute.com (dal1relay34.mxroute.com [199.181.239.34]) by dpdk.org (Postfix) with ESMTP id 39BD92142 for ; Mon, 10 Aug 2020 11:24:25 +0200 (CEST) Received: from filter003.mxroute.com ([168.235.111.26] 168-235-111-26.cloud.ramnode.com) (Authenticated sender: mN4UYu2MZsgR) by dal1relay34.mxroute.com (ZoneMTA) with ESMTPSA id 173d7af5dca000825f.001 for (version=TLSv1/SSLv3 cipher=ECDHE-RSA-AES128-GCM-SHA256); Mon, 10 Aug 2020 09:24:21 +0000 X-Zone-Loop: 1fc2feaf9aeb3e6676854a7f4b7e3765adfa44a4e6b8 X-Originating-IP: [168.235.111.26] Received: from echo.mxrouting.net (echo.mxrouting.net [116.202.222.109]) by filter003.mxroute.com (Postfix) with ESMTPS id A15B06000D; Mon, 10 Aug 2020 09:24:19 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=ashroe.eu; s=x; h=Message-Id:Date:Subject:Cc:To:From:Sender:Reply-To:MIME-Version: Content-Type:Content-Transfer-Encoding:Content-ID:Content-Description: Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID: In-Reply-To:References:List-Id:List-Help:List-Unsubscribe:List-Subscribe: List-Post:List-Owner:List-Archive; bh=gi6HJNWWRnuKFuSdJCWLf70J/nZiS28ZXyDYafC4DWc=; b=Tfo21AsREMrULl3EIw8QGUGyUD uTKf/Mc3CLD+8zzbuHErKpIEK/YiZJcM6EOjSFw8otLAfJGgAPn8/MjLWqx8NywX/dbVL3sQDwtwJ QxapjT04kDbxSxBR7+BCIqgE0/G2nT9A5pL5Gq2XhOYxadyPMrb+Zylw0oZ46DtHvaAdluoP7qpiU tH+wISW20Y8UrnbUqYLI6D0shG4WM4ixRHpCvcFeMVxH2DUxxd9Zy/iFy+dtbCd0pzToSWq0yZRmH 8iBm+ApTjGQ/5tlreiO4/6VJEeUx2sVXgomU2y3F8l40gnWolI8UpYNkrpMownOxAd/OPduRC6Poe eAp7d2uQ==; From: Ray Kinsella To: dev@dpdk.org Cc: ferruh.yigit@intel.com, Ray Kinsella , John McNamara , Marko Kovacevic Date: Mon, 10 Aug 2020 10:24:07 +0100 Message-Id: <1597051449-500-1-git-send-email-mdr@ashroe.eu> X-Mailer: git-send-email 2.7.4 X-AuthUser: mdr@ashroe.eu Subject: [dpdk-dev] [PATCH] doc: clarify abi reference version to use in patches X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Clarify the ABI reference version (DPDK_ABI_REF_VERSION) tag, to use when testing builds with devtools/test_build[_meson].sh before submitting patches. Signed-off-by: Ray Kinsella Reviewed-by: David Marchand --- doc/guides/contributing/patches.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/doc/guides/contributing/patches.rst b/doc/guides/contributing/patches.rst index de493a9..877d2e2 100644 --- a/doc/guides/contributing/patches.rst +++ b/doc/guides/contributing/patches.rst @@ -532,7 +532,8 @@ Checking ABI compatibility By default, ABI compatibility checks are disabled. To enable them, a reference version must be selected via the environment -variable ``DPDK_ABI_REF_VERSION``. +variable ``DPDK_ABI_REF_VERSION``. Contributors should ordinarily reference the +git tag of most recent release of DPDK in DPDK_ABI_REF_VERSION. The ``devtools/test-build.sh`` and ``devtools/test-meson-builds.sh`` scripts then build this reference version in a temporary directory and store the