Received: by 2002:a05:7412:e794:b0:fa:551:50a7 with SMTP id o20csp3290848rdd; Sun, 14 Jan 2024 04:02:15 -0800 (PST) X-Google-Smtp-Source: AGHT+IFv3RpUF04n5jiivmqDElLkEArBHQ4tmUCYh0m6JnZHq+izrvJ98KTkJ7KPb2zpRVBkMZKG X-Received: by 2002:ad4:4eae:0:b0:680:c838:5f76 with SMTP id ed14-20020ad44eae000000b00680c8385f76mr4144075qvb.66.1705233734896; Sun, 14 Jan 2024 04:02:14 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1705233734; cv=none; d=google.com; s=arc-20160816; b=A/LjtSCPfrhDsE9sJNz1iv+/znh82lRWNUJvsUB9w6rASrahv0oozXo16EYV7gsyW6 0p8o3OWerqnEEddsZwgICwVSQS1SE0rZrewaCu9GjuvFLbg1m4eaddTHX7ABvz3vawL5 /13fPcIUGLCsbUY0qQw7NF6a+NZUrRyYc2lfpIIxWbLi2kLQgROEwkV3QIvoPgTYONMW Rr3CtmRmtfco5WF/E3NwPZNAbFGi9l3GkJPDawQU4zikoyw0kq1I/cxpkxR3Cm1lsF6l YrsRTSlA5ka1Uz5RgLduwEoN9IkzyTQ5fpXsibeBb5dwR1WMNplbPxSKNLmUphv7eouz 4WMA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:list-unsubscribe:list-subscribe :list-id:precedence:dkim-signature; bh=+JvC2Re5lYPMbZUi9fLmETjp9DMCjOJIrIyXzMKB7F8=; fh=mCNskkAe340YJBEOrBgstUsXdEVZyvA51sKcDfvglHQ=; b=uFlHFpvzo8utK7q69S51TyBcMXn+R6hT/3GAmzotXqY+Rea+cQQ2U4HyJ2alxhn2fk /LWzDgtEtl5MO128KHq3JCLihCQkn7ujBBrrQX8myGlo0G1XizgQDFH2s2TeMxQx/R8n 1PeXOi1lKikR0iuIGP04LkuLqSHbwHf+JzIAyteJuIavP47/oY9GA9Fa9FNXwOwrclwA 9vX6zwt0THUt8bglCjJs5LdNnjivXsDhFzSpwq2CKn6ynsjImo7YQ4iDjktmsxR5Tfik o7A8dK5RVQloRmGvjS+nukvfcNr232FFa7z4+aFh8R+FV5ccjrhqKpqVwbrONrklMXBp 0b1Q== ARC-Authentication-Results: i=1; mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20230601 header.b=cujmPQdB; spf=pass (google.com: domain of linux-kernel+bounces-25453-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-25453-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [2604:1380:45d1:ec00::1]) by mx.google.com with ESMTPS id k6-20020a0cabc6000000b0067fa0a44a82si6096722qvb.497.2024.01.14.04.02.14 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 14 Jan 2024 04:02:14 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-25453-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1; Authentication-Results: mx.google.com; dkim=neutral (body hash did not verify) header.i=@gmail.com header.s=20230601 header.b=cujmPQdB; spf=pass (google.com: domain of linux-kernel+bounces-25453-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-25453-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=fail (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id 986291C20C25 for ; Sun, 14 Jan 2024 12:02:14 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 452C42109; Sun, 14 Jan 2024 12:02:10 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=fail reason="signature verification failed" (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="cujmPQdB" Received: from mail-ej1-f43.google.com (mail-ej1-f43.google.com [209.85.218.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 0CFF42581; Sun, 14 Jan 2024 12:02:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-ej1-f43.google.com with SMTP id a640c23a62f3a-a28da6285c1so1416043966b.0; Sun, 14 Jan 2024 04:02:07 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1705233726; x=1705838526; darn=vger.kernel.org; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=ZWRjRFXEceL8YNoAA8HuRe3I9HTaS3BgE69HQr1Lej0=; b=cujmPQdBni2WgUop8fyyZmElk5DpZTyqryW2gvr2Ma7mpCsIhJRTA4AYTcce9hvID6 nCXHDpdGHSk41CloZH1taUea/vymyacT020OVfnR7aq+MVeHLGNYxSNNiku0EmhqjvkI RYltP2AJe3JV7wBfNuk+h381vQ6wIjW844cQlt67a39K4BWHELDfcr/R2vFuFAbGfSiY 2CI/Yyn/DcKDkcspChONgNV1+wjCdWPS3Vytw94kSQyjxriKr4rT6Zy/AjmJDi3J3WC2 sS+CJ83pkRU8tX9bwCEqA1sjFMdDOtOlTVCHd1wOSDZDEEenYZxG73pZxa6RsXugMSn5 pseA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1705233726; x=1705838526; h=content-transfer-encoding:cc:to:subject:message-id:date:from :in-reply-to:references:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=ZWRjRFXEceL8YNoAA8HuRe3I9HTaS3BgE69HQr1Lej0=; b=SkmU5qSCzP7yoBe6rzEBPPPuJOcQMaN4xkHPT1jVlJWjD0qiYVpN6TtoSJxsNoyirH Wx3t1cCY2Q/RfjI2c+BFMiilIsxYT8kPo832zAa7BtT11HDGwAYYbPxPBqnZjkPklNov k6rLFwz0qCqHxUcT78cpyOvcpYbSnDKQmO8sLbXEOYze7HZ3jYZCyrFDAtkzVw+O8EOl nepUDp4U/o6cahYVsaL3HTyJ/5uqFols/BLzxVU22cV41iYWUIMjdA2l22ezftWRqViO 7JR5gecw0AmLJE+Y25uHtvcZfmU8ixtKpK+EePSnVMvvh2Vu85FWf6ISyGgUh7OfbgHJ KQ+A== X-Gm-Message-State: AOJu0YxAaODKJ927iC5rVnOWqQWLC3rP2t9idfoC5IySQMPne7GAC0BD PiDMlDY+M9i93QkvDE6+FR9xPqWtwd/CgNTkeso= X-Received: by 2002:a17:907:1992:b0:a29:fb9a:a3a0 with SMTP id li18-20020a170907199200b00a29fb9aa3a0mr5147704ejc.1.1705233725850; Sun, 14 Jan 2024 04:02:05 -0800 (PST) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20240109135952.77458-1-warthog618@gmail.com> <20240114024724.GA20870@rigel> In-Reply-To: <20240114024724.GA20870@rigel> From: Andy Shevchenko Date: Sun, 14 Jan 2024 14:01:29 +0200 Message-ID: Subject: Re: [PATCH 0/7] Documentation: gpio: add character device userspace API documentation To: Kent Gibson Cc: linux-kernel@vger.kernel.org, linux-gpio@vger.kernel.org, linux-doc@vger.kernel.org, brgl@bgdev.pl, linus.walleij@linaro.org, andy@kernel.org, corbet@lwn.net Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Sun, Jan 14, 2024 at 4:47=E2=80=AFAM Kent Gibson = wrote: > On Tue, Jan 09, 2024 at 09:59:45PM +0800, Kent Gibson wrote: > > My new year's resolution was to improve the documentation of the > > character device API and gpio in general, so here we are. .. > While preparing the v2 version of this series, I'm now wondering > if this should be changed to "obsolete" rather than "deprecated", to > better fit with the interface lifecycle, to indicate there is an > alternative, and to emphasise that it is scheduled for removal. > i.e. from a userspace perspective "obsolete" is the clearer term. > > Is that a change worth making? From my p.o.v. yes, as it makes it consistent with what we already have in the sysfs/obsolete. --=20 With Best Regards, Andy Shevchenko