From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id EF31EA00C4; Fri, 5 Jun 2020 09:54:51 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id A72E21D5DC; Fri, 5 Jun 2020 09:54:51 +0200 (CEST) Received: from mail-wr1-f67.google.com (mail-wr1-f67.google.com [209.85.221.67]) by dpdk.org (Postfix) with ESMTP id D80A71D5DA for ; Fri, 5 Jun 2020 09:54:49 +0200 (CEST) Received: by mail-wr1-f67.google.com with SMTP id l10so8689371wrr.10 for ; Fri, 05 Jun 2020 00:54:49 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:message-id:subject:from:to:date:in-reply-to :references:content-transfer-encoding:user-agent:mime-version; bh=cGZPrEpVx+qq64z0ZvOeZUFLEaW8mUs7ATrlsFpIEO8=; b=EJCiOjCD13e29xf8nqLf8wYus0xwgXQ4ip0RSdUHc+IcdS5mqhwDBPYzZtc23rDxdY 82pnzkgIJyOoAOo2zRhShsxYdCEsgZcWR3v9ikeMm16Z7kHLUg83/KasmaJHVakIJ5F/ Q8U8lCHmdYaLYU8asIKRSahS5FsoPRJkeknAsHYTWiSM5ba5s3m5i3UNoH/lTrr/sFT/ 4M56++E6SvX9TCzLFKUflj0bu17/v4vmpEbxlgfq1MuYVH+Yvj1t62t8K0JSPyChwtbR HhkFYHIHlN6Yq+kt9DuRdbwwMUaqX8ZIgiDNCENWn6ME+R9R8iv+aSpBY0qJmRwnrqoJ mNgQ== X-Gm-Message-State: AOAM5301342GtB73nxQWkdenIsAPvilLUgdGH8XAYk3y/Pexd70cSISD S5DWFxkwnUhU0fD/SK1e8Uy+P3Ivsl0= X-Google-Smtp-Source: ABdhPJwyNhjUDYVOZXNG/ppbkGaISNQYNTMKOeW/4+1eLrV8nyyXNkt2TVTDNEySVSJ6DT6NHoQ8XQ== X-Received: by 2002:a5d:69cb:: with SMTP id s11mr8271939wrw.91.1591343688891; Fri, 05 Jun 2020 00:54:48 -0700 (PDT) Received: from localhost ([88.98.246.218]) by smtp.gmail.com with ESMTPSA id s72sm10320259wme.35.2020.06.05.00.54.48 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 05 Jun 2020 00:54:48 -0700 (PDT) Message-ID: From: Luca Boccassi To: Stephen Hemminger , dev@dpdk.org Date: Fri, 05 Jun 2020 08:54:47 +0100 In-Reply-To: <20200604210200.25405-1-stephen@networkplumber.org> References: <20200604210200.25405-1-stephen@networkplumber.org> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.30.5-1.1 MIME-Version: 1.0 Subject: Re: [dpdk-dev] [RFC] doc: change to diverse and inclusive language 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" On Thu, 2020-06-04 at 14:02 -0700, Stephen Hemminger wrote: > For diversity reasons, the DPDK should take every effort > to eliminate master and slave terminology. The actual code change > is just syntax, but it has bigger impacts. >=20 > Lets announce this now and do it in the next API changing > release. > --- > doc/guides/rel_notes/deprecation.rst | 27 +++++++++++++++++++++++++++ > 1 file changed, 27 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/= deprecation.rst > index 0bee924255af..6b5cbf8d0b0c 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -138,3 +138,30 @@ Deprecation Notices > driver probe scheme. The legacy virtio support will be available throu= gh > the existing VFIO/UIO based kernel driver scheme. > More details at https://patches.dpdk.org/patch/69351/ > + > +* eal: To be more inclusive in choice of naming, the DPDK project > + will follow established diversity guidelines. > + The code base will be changed to replace references to sexist > + and offensive terms used in function, documentation and variable > + names. This change will be progressive across several releases. > + > + The immediate impact to the API/ABI is that references to > + master and slave related to DPDK lcore will be changed to > + primary and secondary. > + > + For example: ``rte_get_master_lcore()`` will be renamed > + to ``rte_get_primary_lcore()``. For the 20.11, release > + both names will be present and the old function will be > + marked with the deprecated tag. > + > + The macros related to primary and secondary lcore will also > + be change: ``RTE_LCORE_FOREACH_SLAVE`` will be replaced > + with ``RTE_LCORE_FOREACH_SECONDARY``. > + > + Drivers and source not governed by API/ABI policy will change > + as soon as practical. > + > + This change aligns DPDK with the MIT diversity guidelines: > + https://www.cs.cmu.edu/~mjw/Language/NonSexist/vuw.non-sexist-language= -guidelines.txt > + and follows precedent of other open source projects: Django, Gnome, > + ISC, Python, Rust Acked-by: Luca Boccassi Thanks for doing this! --=20 Kind regards, Luca Boccassi