From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <luca.boccassi@gmail.com>
Received: from mail-wm1-f67.google.com (mail-wm1-f67.google.com
 [209.85.128.67]) by dpdk.org (Postfix) with ESMTP id D3DDD1B39D
 for <dev@dpdk.org>; Mon, 14 Jan 2019 14:41:12 +0100 (CET)
Received: by mail-wm1-f67.google.com with SMTP id a62so8945285wmh.4
 for <dev@dpdk.org>; Mon, 14 Jan 2019 05:41:12 -0800 (PST)
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to
 :references:mime-version:content-transfer-encoding;
 bh=4O4sbry72PyCY3xt4Ack/l1qwW3KOuw7ilyazs9WrTI=;
 b=EE2mjT6W3eiVKsfnp7hUqy9jZoiB+/BVIT+OawCfIEh9t2v3VNozXTsf0pwCgXdwoK
 14/p7pIwyy/LM+AXNOIHEhYeR5CJKMajyj1BhzzshahOQ9g0ZesiliuJNfKpYDAven03
 CE4xAfOuPypaE9KS/CXS4kNIz+2PNoMe9qTLwLwobS59mrMvPfh8q1sTYYlRmfjyYSec
 7ZRo7acObHDn0QKs8UhBgApA30BCoX/+ElyK9ZgpVdFYLpTfEUjI5P0yZnMian1v9Jnl
 TSpS3ZKSGMDY6vDhd2MYEkBufeoi+2U+dyxXUjanVYEUFqQX07zTmD3p2k13bCb77WOr
 g4Ug==
X-Gm-Message-State: AJcUukfdwf3sITZNVItADw87NHvF25AKj+doX2yEvZ9ThpJ8Y8G2hSWw
 8EvUyCdb/xY/aL33VAjR36Cy/EIfW7w=
X-Google-Smtp-Source: ALg8bN46Rn1MrXCcl2SFvsoqiKrR2t3Nmw9w3dASd2cUd1hlLa3YVjEEMaQng2yy97t+XQXsAFfXTQ==
X-Received: by 2002:a1c:4855:: with SMTP id v82mr11994529wma.15.1547473272060; 
 Mon, 14 Jan 2019 05:41:12 -0800 (PST)
Received: from localhost ([2a01:4b00:f419:6f00:8361:8946:ba2b:d556])
 by smtp.gmail.com with ESMTPSA id w80sm38827976wme.38.2019.01.14.05.41.11
 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256);
 Mon, 14 Jan 2019 05:41:11 -0800 (PST)
From: Luca Boccassi <bluca@debian.org>
To: dev@dpdk.org
Cc: jerinj@marvell.com, bruce.richardson@intel.com,
 Luca Boccassi <bluca@debian.org>,
 Christian Ehrhardt <christian.ehrhardt@canonical.com>
Date: Mon, 14 Jan 2019 13:41:06 +0000
Message-Id: <20190114134106.17383-1-bluca@debian.org>
X-Mailer: git-send-email 2.20.1
In-Reply-To: <20190114112331.15761-1-bluca@debian.org>
References: <20190114112331.15761-1-bluca@debian.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: [dpdk-dev] [PATCH v2] build: mention machine=default and its use in
	documentation
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
X-List-Received-Date: Mon, 14 Jan 2019 13:41:12 -0000

Document the new value, as it's useful for distributions and users
who need to use a stable baseline -march

Signed-off-by: Luca Boccassi <bluca@debian.org>
Reviewed-by: Christian Ehrhardt <christian.ehrhardt@canonical.com>
---
v2: fix typo, add commit body and reviewed-by

 doc/build-sdk-meson.txt | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/doc/build-sdk-meson.txt b/doc/build-sdk-meson.txt
index 29a8bd387..ab33ca82a 100644
--- a/doc/build-sdk-meson.txt
+++ b/doc/build-sdk-meson.txt
@@ -87,6 +87,8 @@ Project-specific options are passed used -Doption=value::
 
 	meson -Denable_docs=true fullbuild  # build and install docs
 
+	meson -Dmachine=default  # use builder-independent baseline -march
+
 Examples of setting the same options using meson configure::
 
 	meson configure -Dwerror=true
@@ -103,6 +105,9 @@ should be used to change the build settings within the directory, and when
 ``ninja`` is called to do the build itself, it will trigger the necessary
 re-scan from meson.
 
+NOTE: machine=default will use the minimum required -march on all architectures
+regardless of the capabilities of the machine where the build is happening.
+
 As well as those settings taken from ``meson configure``, other options
 such as the compiler to use can be passed via environment variables. For
 example::
-- 
2.20.1