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 4F427A00BE; Thu, 28 May 2020 08:54:04 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id B7C251DA7D; Thu, 28 May 2020 08:54:03 +0200 (CEST) Received: from us-smtp-delivery-1.mimecast.com (us-smtp-2.mimecast.com [207.211.31.81]) by dpdk.org (Postfix) with ESMTP id 9E8681DA5F for ; Thu, 28 May 2020 08:54:02 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1590648842; 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=bSdM9eY7/iniHgOyrQW/44F00pHqAX3g06AQJZAzPjQ=; b=E+4WSKhsGOFxBMcBXqzDnRZjb3Sq0DlyGfasbs1V4qC9d5V8l5alnz1JIWKlyYUoH/fmZd h8aRuKPIlf+OM127/G4KyDz7LNkkO0sPrKkb54rlfkcD5jo/pACDH7m2Ss6lSPBWKY+bC7 w4W57JsMYxvOEc7WPbsOUFAAE7yBf9M= Received: from mail-vk1-f198.google.com (mail-vk1-f198.google.com [209.85.221.198]) (Using TLS) by relay.mimecast.com with ESMTP id us-mta-77-DByiSYwMO3GTw6NOZU8mZg-1; Thu, 28 May 2020 02:53:58 -0400 X-MC-Unique: DByiSYwMO3GTw6NOZU8mZg-1 Received: by mail-vk1-f198.google.com with SMTP id 68so10012641vkx.22 for ; Wed, 27 May 2020 23:53:58 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=bSdM9eY7/iniHgOyrQW/44F00pHqAX3g06AQJZAzPjQ=; b=evOVYUW85n3kq88a+7Ss5YtR36dtktX6unah2SzxAn1vA8wKQTMTFGdRpGE/PUhpim 10JkYj/yRRuRfAXHo3DIwxAHL6P2DWemPNR0z5Da3yHyqgKX7C6uvNZzGt+vxVleGaMI jhyVgJXPDI/rqsQuNT3Roaf2nRTSjPa9Za83gaCj9YTvdx1O7HVj6pmNqfk5s4fHx4MX bRm/W7J6iTfS7foEsVUbRPKH8XMyDTnVNprmNnPUAnz7dKraPOwxqUzN8cYNyH8zOtXL VI39Ybra/eIYFKxzNYIPgIyk2bMhOBiRODdy3Duv4DzsRGmPlwR6PGcasahpGN/gsqh9 CiQQ== X-Gm-Message-State: AOAM530gDXFZ2+69RO9qPMMDK6j6PwIxaJo2sNzmnoiI3b0Z959ogfPU cZ759GC8ZU8x9XsJjzgF+HjAwX0q7ESbjLsASvsKIFb4FxCNse04y9xuHFaJ5f8qXpMVGdSnDpV Q7N7W7eFoy6/ZIpFylhQ= X-Received: by 2002:a05:6102:2012:: with SMTP id p18mr902695vsr.198.1590648838057; Wed, 27 May 2020 23:53:58 -0700 (PDT) X-Google-Smtp-Source: ABdhPJwDcb5okeT4JDGXAt0PRvR/RCEVeVlR60XrpQdVr9NlVC3FiNrGpW4LSH2SX7Tvji105F3m4ymRSExOarPvA2o= X-Received: by 2002:a05:6102:2012:: with SMTP id p18mr902679vsr.198.1590648837747; Wed, 27 May 2020 23:53:57 -0700 (PDT) MIME-Version: 1.0 References: <20200522065855.31056-1-david.marchand@redhat.com> <20200522065855.31056-4-david.marchand@redhat.com> In-Reply-To: From: David Marchand Date: Thu, 28 May 2020 08:53:46 +0200 Message-ID: To: Honnappa Nagarahalli Cc: "dev@dpdk.org" , "thomas@monjalon.net" , "techboard@dpdk.org" , "stable@dpdk.org" , Nicolas Chautru , Konstantin Ananyev , Fiona Trahe , Ashish Gupta , Vladimir Medvedkin , Bernard Iremonger , Gage Eads , Olivier Matz , Kevin Laatz , nd , Ray Kinsella , Neil Horman X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain; charset="UTF-8" Subject: Re: [dpdk-dev] [PATCH 3/3] lib: remind experimental status in library headers 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" Hello Honnappa, On Fri, May 22, 2020 at 4:16 PM Honnappa Nagarahalli wrote: > > @@ -11,7 +11,8 @@ > > * Wireless base band device abstraction APIs. > > * > > * @warning > > - * @b EXPERIMENTAL: this API may change without prior notice > > + * @b EXPERIMENTAL: > > + * All functions in this file may change or disappear without prior notice. > nit, is 'removed' a better choice instead of 'disappear'? May be something like: > All functions in this file may be changed or removed without prior notice. I used the same form than in the abi policy (that I wanted but forgot to update in patch 1 afterwards... will be fixed in v2). #. Libraries or APIs marked as :ref:`experimental ` may change without constraint, as they are not considered part of an ABI version. Experimental libraries have the major ABI version ``0``. No strong opinion, but I prefer keeping a single phrasing. If we go with your suggestion, I will update the abi policy. -- David Marchand