Received: by 2002:a05:6a10:22f:0:0:0:0 with SMTP id 15csp3759709pxk; Tue, 22 Sep 2020 01:35:21 -0700 (PDT) X-Google-Smtp-Source: ABdhPJy0xwH3fA19FQ719CzNKZ3n9rsSszQhaWZj3OgDE+KR25MPBykHIjNhHWYkLqvIz6Yl7DwK X-Received: by 2002:a17:906:bcd5:: with SMTP id lw21mr3720460ejb.430.1600763721084; Tue, 22 Sep 2020 01:35:21 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1600763721; cv=none; d=google.com; s=arc-20160816; b=P3y4XdUfa2PD1RrT0+4bACtUtQO+oeBKubHagtgl354gFN5N1JpjpMkIhW0VeSxoc4 1+URPau1bZ94yS9DQmJ+2OoA2CCXEEjskLqBjZjz2zcxjmUEndLd5/AnRnQ9a5SK2OMo veIw0y3hoSiX4MweckIOa6Zs4CC3sYlfompGseRmipoXNOVWqSRedCLNnSLoBsJjV2u0 BQkSF0j21ZIVA6inncSC5H0CKVIs5eUZkCXZNmf7n6SniMKwXao47bx463Zg5j8kPo0l ajw/9ejROqLhaIdgwEi0mo/5DA1Su1hRqxsZ9tA4jzq3c4HPak8gxYUgSjajR5rKD4N1 Z8JA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:cc:to:subject:message-id:date:from:in-reply-to :references:mime-version:dkim-signature; bh=Kjqu8oiQnpukngndV4Aa0Ssw8pga7Wr4GCqPnaHdW3s=; b=HjpBuI0tSuwuhd2wGm/RfUq1y83LwY9t5szHS7x2uXtOrc2uRAwv1dv+y/q+8iyT0k wn85mZkZrcMYNZo7ff9VHb8L9LPxGM3TauKANvGo1IicuhrtwsfOMTvPyEOt8iomYa1g cEept1kfab8SworcYUrI6LbiR5yA0+mbnJxbXmawad37YjwbZsk0plh35EhUC4JzQ+Ee 8XpJ8kmHPx/Ytv9F0gojE7/1oVwA2hB6vp+wrwbFGG2y/15QUJtMa76B0ISWZRMxmpPD pV2sD/SC65qqLN7BxkhYVo8HwSF/UvUy1Ma35k1q0cx0kUdF/2tvvDDYdnPD+mRClN1e 0CKQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=Mre6u2EH; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id p2si10062741ejw.176.2020.09.22.01.34.57; Tue, 22 Sep 2020 01:35:21 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=Mre6u2EH; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726608AbgIVILT (ORCPT + 99 others); Tue, 22 Sep 2020 04:11:19 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35516 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726436AbgIVILT (ORCPT ); Tue, 22 Sep 2020 04:11:19 -0400 Received: from mail-pg1-x542.google.com (mail-pg1-x542.google.com [IPv6:2607:f8b0:4864:20::542]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 412F0C061755; Tue, 22 Sep 2020 01:11:19 -0700 (PDT) Received: by mail-pg1-x542.google.com with SMTP id f2so11326063pgd.3; Tue, 22 Sep 2020 01:11:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=Kjqu8oiQnpukngndV4Aa0Ssw8pga7Wr4GCqPnaHdW3s=; b=Mre6u2EH7OYjPAiCgPg6+fmLT8kIuFDLJREv4dIau4eqCOoQcu89o7n/TC4B4U041W ev8R11UyS28+pccci62N8TcY6kw995XrJLppjvZwBn54pn15d6OV17l3bsi/J3WwQgrq vUb1cUAuGYs0/WrgutX+GYaxYnX/Yd3l6na8oMZ3QN6DVOXxy0AlR6kfEk62JIl33lCn rOUuxcYv1p+3nWn5hX/vLOAzp5BJydRqH5uEMn1ELQZJnkLbZNLWvQR0F/K2ll+vGPPT k4ACKaPY3q2UWmlBA5mxRuv5OycO+JvBDO5uZhU5Zwm/GIJhVPndPyga2U2a1nhY+jft S6rw== 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=Kjqu8oiQnpukngndV4Aa0Ssw8pga7Wr4GCqPnaHdW3s=; b=f0Ppwej04rV/E5bzlDlMMma9ptIvWOsqeHefQN6KxgzUJ4ImW+CBrfcPle050a5nE6 RZ7jumGHGApk0Z/Dh5XcwPmSL0YrOlLYmnWv5asUzVPxr6DyV7+vq/GbZvlizdbtF9rk ++cSvQ0/gr8vNrSIqkTNRaaOIMiAYGguVwN6Hv1YIsBLQyczZIM4185aoaboXEewguqo OtbabWiptDlCJ1zEUg2pl+zpFvgFG9L8qYvmUKlBhPzU06vybvmeneiAL851UlFeHZVA 1+dePBE4jUwugIP4ullIjUcjpZsgYa5UqzIzTNVGX11kH2Vs+xuOs1x1233BUUW6hk6P Y9HA== X-Gm-Message-State: AOAM531ksOT4h2M2gVU7LKV7USVpYTu5VF3v4D4xs6Y48pA6mXxdgzk1 CyvwH7iJ1nQPlrEgKLEYz6Djb8fkGd5ZikKAPhI= X-Received: by 2002:a17:902:778b:b029:d1:bb21:513d with SMTP id o11-20020a170902778bb02900d1bb21513dmr3493734pll.17.1600762278657; Tue, 22 Sep 2020 01:11:18 -0700 (PDT) MIME-Version: 1.0 References: <20200922023151.387447-1-warthog618@gmail.com> <20200922023151.387447-14-warthog618@gmail.com> In-Reply-To: From: Andy Shevchenko Date: Tue, 22 Sep 2020 11:11:02 +0300 Message-ID: Subject: Re: [PATCH v9 13/20] gpio: uapi: document uAPI v1 as deprecated To: Arnd Bergmann Cc: Kent Gibson , "linux-kernel@vger.kernel.org" , "open list:GPIO SUBSYSTEM" , Bartosz Golaszewski , Linus Walleij Content-Type: text/plain; charset="UTF-8" Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Sep 22, 2020 at 10:49 AM Arnd Bergmann wrote: > On Tue, Sep 22, 2020 at 4:36 AM Kent Gibson wrote: > > /* > > * ABI v1 > > + * > > + * This version of the ABI is deprecated and will be removed in the future. > > + * Use the latest version of the ABI, defined above, instead. > > */ > > How intentional is the wording here? It seems unrealistic that the v1 ABI > would be removed any time soon if there are existing users and applications > cannot yet rely on v2 to be present in all kernels, so it sounds like a hollow > threat. I have similar thoughts when commenting on previous versions of this piece. > At the same time I can see that telling users it will be removed can lead to > them moving on to the new version more quickly, so maybe a hollow threat > is in fact appropriate here ;-) Users all know that if something will be broken, they may escalate to Linus T. and get things reverted. So, above depends on the user's knowledge about the process. -- With Best Regards, Andy Shevchenko