From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from dpdk.org (dpdk.org [92.243.14.124])
	by inbox.dpdk.org (Postfix) with ESMTP id 7272DA0521;
	Thu,  5 Nov 2020 23:37:48 +0100 (CET)
Received: from [92.243.14.124] (localhost [127.0.0.1])
	by dpdk.org (Postfix) with ESMTP id 6B2182E8F;
	Thu,  5 Nov 2020 23:36:23 +0100 (CET)
Received: from mail-pg1-f196.google.com (mail-pg1-f196.google.com
 [209.85.215.196]) by dpdk.org (Postfix) with ESMTP id 3EA162C15
 for <dev@dpdk.org>; Thu,  5 Nov 2020 23:36:20 +0100 (CET)
Received: by mail-pg1-f196.google.com with SMTP id e21so2353218pgr.11
 for <dev@dpdk.org>; Thu, 05 Nov 2020 14:36:20 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=networkplumber-org.20150623.gappssmtp.com; s=20150623;
 h=from:to:cc:subject:date:message-id:in-reply-to:references
 :mime-version:content-transfer-encoding;
 bh=StbT9fbv6XwLdKGUIWXJcywtHoJ5yTw2p7C78pANLMg=;
 b=lfdmhvXODAYpZgaulcL4GQo+/F5/1IoRUilCTezT9gVhYJU0+z01K6vA77O/xxx9GO
 q6qJRFVeaDMXYQkqOl/pnKPpIU5WmiaipXgKT+DAtyXawzSy2Gr/ZQUDvl/r7TVzq380
 N5IJ09SXb/5wpX0S6dkjahAJc56TcE2sJVW0q57tB1C4s6cFKbpaJ5ZNMdMuL/5AjQn1
 H2SfiR+Q6+y3C/0+gNPvaXaebwlLgsoYwSmHGtkX6w/GZzPuDv83X8+6ggrgO+KY8eA1
 1f+s6g7o83CG7oUhUz8upMPu8mVSgWYxPxFToa40p8V9dcogwS6gHFGaryfIfbYsIeVQ
 TD3g==
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=StbT9fbv6XwLdKGUIWXJcywtHoJ5yTw2p7C78pANLMg=;
 b=ny6N2q6eHU2/irkOlKzAtD5wBc1yiYCn1Q97+OykQCjFdduXzMwb3e7EKTbu2bNpdP
 C3jgEeqV6qrQQ8wU8qQjoHKVCibUPxbsgDz56JtplS6skCWMYs5croA8O1qKc4UHXju/
 INQDabJT8aud52VuCU5sQN8qgOsZJf+oP+ejjNSvj0wKfjXYFJ8S7NuinIqsl7fCrPS5
 QcKvRJBXGxxmdc75wH1i6tK3QzjfA2cwjZptoUgyMr3CK/G2yaTsay70tYt3cpINT/C6
 Dkf0pGT0Hs1X0ljQbCCxSJYoUOLAlUS8YE/chPOCMDhEoZYzLWRYmFIHbjMK9of8/VbT
 ckiA==
X-Gm-Message-State: AOAM530QOI6Brqk7vkoaR/Pe9GUH7SIE5ITzHBmwkj/zb6Ff5yd7rCec
 i5QN+oHni81S642LTAMPsOfZ/2x8NsUedDFv
X-Google-Smtp-Source: ABdhPJwsU52UZvcBsWRX7CHQg7NkRLoX5NxNO7xJOtSZDDZtiW5fSHqCZnS9KT+4LTjFbn4Lh1BN8Q==
X-Received: by 2002:aa7:9341:0:b029:18b:b43:6c7 with SMTP id
 1-20020aa793410000b029018b0b4306c7mr4526635pfn.7.1604615779086; 
 Thu, 05 Nov 2020 14:36:19 -0800 (PST)
Received: from hermes.corp.microsoft.com (204-195-22-127.wavecable.com.
 [204.195.22.127])
 by smtp.gmail.com with ESMTPSA id u5sm1026756pgj.28.2020.11.05.14.36.17
 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);
 Thu, 05 Nov 2020 14:36:18 -0800 (PST)
From: Stephen Hemminger <stephen@networkplumber.org>
To: dev@dpdk.org
Cc: Stephen Hemminger <stephen@networkplumber.org>
Date: Thu,  5 Nov 2020 14:36:02 -0800
Message-Id: <20201105223602.5965-7-stephen@networkplumber.org>
X-Mailer: git-send-email 2.27.0
In-Reply-To: <20201105223602.5965-1-stephen@networkplumber.org>
References: <20200922143202.8755-1-stephen@networkplumber.org>
 <20201105223602.5965-1-stephen@networkplumber.org>
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Subject: [dpdk-dev] [PATCH v9 6/6] doc: update release notes now for block
	allow changes
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>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

Remove the deprecation notice and add description to the release notes.

Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
---
 doc/guides/rel_notes/deprecation.rst   | 23 -----------------------
 doc/guides/rel_notes/release_20_11.rst | 11 +++++++++++
 2 files changed, 11 insertions(+), 23 deletions(-)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index f3258eb3f725..d459a25eabe3 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -28,29 +28,6 @@ Deprecation Notices
 * kvargs: The function ``rte_kvargs_process`` will get a new parameter
   for returning key match count. It will ease handling of no-match case.
 
-* eal: The terms blacklist and whitelist to describe devices used
-  by DPDK will be replaced in the 20.11 relase.
-  This will apply to command line arguments as well as macros.
-
-  The macro ``RTE_DEV_BLACKLISTED`` will be replaced with ``RTE_DEV_EXCLUDED``
-  and ``RTE_DEV_WHITELISTED`` will be replaced with ``RTE_DEV_INCLUDED``
-  ``RTE_BUS_SCAN_BLACKLIST`` and ``RTE_BUS_SCAN_WHITELIST`` will be
-  replaced with ``RTE_BUS_SCAN_EXCLUDED`` and ``RTE_BUS_SCAN_INCLUDED``
-  respectively. Likewise ``RTE_DEVTYPE_BLACKLISTED_PCI`` and
-  ``RTE_DEVTYPE_WHITELISTED_PCI`` will be replaced with
-  ``RTE_DEVTYPE_EXCLUDED`` and ``RTE_DEVTYPE_INCLUDED``.
-
-  The old macros will be marked as deprecated in 20.11 and any
-  usage will cause a compile warning. They will be removed in
-  a future release.
-
-  The command line arguments to ``rte_eal_init`` will change from
-  ``-b, --pci-blacklist`` to ``-x, --exclude`` and
-  ``-w, --pci-whitelist`` to ``-i, --include``.
-  The old command line arguments will continue to be accepted in 20.11
-  but will cause a runtime warning message. The old arguments will
-  be removed in a future release.
-
 * eal: The function ``rte_eal_remote_launch`` will return new error codes
   after read or write error on the pipe, instead of calling ``rte_panic``.
 
diff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst
index 6bbd6ee93922..df955e2214c4 100644
--- a/doc/guides/rel_notes/release_20_11.rst
+++ b/doc/guides/rel_notes/release_20_11.rst
@@ -644,6 +644,17 @@ API Changes
 * sched: Removed ``tb_rate``, ``tc_rate``, ``tc_period`` and ``tb_size``
   from ``struct rte_sched_subport_params``.
 
+* eal: The selection of devices on the EAL command line has been
+  changed from ``--pci-blacklist`` and ``--pci-whitelist``
+  to ``--block`` and ``--allow``. The short form option for
+  using a device is now ``-a`` instead of ``-w``.
+
+  The internal macros for ``RTE_DEV_BLACKLISTED`` and ``RTE_DEV_WHITELISTED``
+  have been replaced with ``RTE_DEV_BLOCKED`` and ``RTE_DEV_ALLOWED``.
+
+  There are compatibility macros and command line mappings to accept
+  the old values but applications and scripts are strongly encouraged
+  to migrate to the new names.
 
 ABI Changes
 -----------
-- 
2.27.0