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 01D1FA0350; Fri, 5 Jun 2020 23:40:44 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id BE3C81D510; Fri, 5 Jun 2020 23:40:43 +0200 (CEST) Received: from us-smtp-1.mimecast.com (us-smtp-delivery-1.mimecast.com [207.211.31.120]) by dpdk.org (Postfix) with ESMTP id CB13C1D50A for ; Fri, 5 Jun 2020 23:40:42 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1591393241; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=EUcj5SrVOcTMQJj2HG4ECw13yQM4Py3r7iJLW0BYyiw=; b=fZnTOURSTDWWPdGpEjKQDB/xNM/HaqEcwsxpMZlV/Pm8k23T5DQ1DTnpzK7nCwWEG4N+mM cegZosM1V81lv+EK+ODW2vNNZBDHFbGmPYt3cvx9N8gopSiivPwDxfC4lYgBKoZiStpktW AY8qnCThRJv/3ESXHG5u2EYZBKmmbkw= Received: from mimecast-mx01.redhat.com (mimecast-mx01.redhat.com [209.132.183.4]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-305--NfbNgFoOnGbLzXi-rt1Cw-1; Fri, 05 Jun 2020 17:40:27 -0400 X-MC-Unique: -NfbNgFoOnGbLzXi-rt1Cw-1 Received: from smtp.corp.redhat.com (int-mx06.intmail.prod.int.phx2.redhat.com [10.5.11.16]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by mimecast-mx01.redhat.com (Postfix) with ESMTPS id 2EB32107ACCA; Fri, 5 Jun 2020 21:40:26 +0000 (UTC) Received: from dhcp-25.97.bos.redhat.com (ovpn-117-20.rdu2.redhat.com [10.10.117.20]) by smtp.corp.redhat.com (Postfix) with ESMTPS id 6387861475; Fri, 5 Jun 2020 21:40:25 +0000 (UTC) From: Aaron Conole To: Stephen Hemminger Cc: dev@dpdk.org References: <20200604210200.25405-1-stephen@networkplumber.org> Date: Fri, 05 Jun 2020 17:40:23 -0400 In-Reply-To: <20200604210200.25405-1-stephen@networkplumber.org> (Stephen Hemminger's message of "Thu, 4 Jun 2020 14:02:00 -0700") Message-ID: User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.3 (gnu/linux) MIME-Version: 1.0 X-Scanned-By: MIMEDefang 2.79 on 10.5.11.16 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain 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" Stephen Hemminger writes: > 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. > > Lets announce this now and do it in the next API changing > release. > --- Okay. Usually, I am resistant to API/ABI changes - but actually in this case, I think we can do this even *now* without breaking the ABI (IIUC, we can use alias to keep around the old 'functions' - even structures shouldn't have any change). The API, we can carry over the existing stuff, and flag it in documentation as deprecated. Acked-by: Aaron Conole > doc/guides/rel_notes/deprecation.rst | 27 +++++++++++++++++++++++++++ > 1 file changed, 27 insertions(+) > > 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 through > 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