Received: by 2002:a05:7412:8d10:b0:f3:1519:9f41 with SMTP id bj16csp6034328rdb; Thu, 14 Dec 2023 06:47:54 -0800 (PST) X-Google-Smtp-Source: AGHT+IEKACIWhyDrdGYjnTz5pIEERUF0zU6K3tH6sZ0/uYJII2bEgW+1i5EqEbFzOo7jiBSrP4BT X-Received: by 2002:a05:6e02:1a29:b0:35d:59a2:2d7 with SMTP id g9-20020a056e021a2900b0035d59a202d7mr13828074ile.119.1702565274667; Thu, 14 Dec 2023 06:47:54 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1702565274; cv=none; d=google.com; s=arc-20160816; b=YhbZS054j/NwXKhQrdy0R8cBf9ZxYtnQXrCr9+IuDpemACk1bv+h8YId+GVOFXMjiN sojcNA4qFIXUf1m/FMQpDaTc6G++NX3gj8uhmtq7tqw1ijHH/GVctdSCnDh+iZCC+BL1 ELo7YF0xrZIYKQKJull66jk7+oQ+PDljt6hlPkIh9gLx3II+K+rvBvzkkhpRO8hGIR6o z8V39gpER0RYh3MAFVgRED50zNvc64L9NcBo27/0UDk8C00HCpfca9AFqezFFbS/2Wo8 H5jbsmybXEBNmxAj7jRKp6BdTquK1CHZRaCJF33VuAm0of2U6PPt5y4WGGZemVj8yxyP S+Ww== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:in-reply-to:content-disposition:mime-version :references:message-id:subject:cc:to:from:date:dkim-signature; bh=sof1gkerYbku5v+b3jW5lmXu1VdUZ0QZgBhWQoXBGdc=; fh=JQuCuTmtpe770U/EjoFOYWKrhTpVWH6ywEqFQCyG1jE=; b=OOqOg9IL1FaKTsEhSt6uqfr46T50oyajG2R4plr9Ek7EuA5QKhxFabphBLoJNz8l2D H121NAvTPGsxTF7rImMU3sDc6DqDN6dzPD5rr9U0DPs1ARmx0AP0Vw/7pLeK58bLTUkE FPxV1Yoigl+uw7fWfQ4rOk92+GPr0hPZAmd12y+N6UK3AFfXQi3lC1SeQuj9iEaoiTJw CBUWQNPKzyqIrZjLKOzSWTHBQXS6o2x1eU4JsRb3FU8dr6qggPx3QN0f1hdBiJa8CH58 Tvou/b9NE2oXlC9P3OvBiK7UHAm5Iw1Jly/EaPL47Nme0IixDxjIkDpzqvukSS3ga8tC H3Iw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=Kkp5xwOt; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 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 howler.vger.email (howler.vger.email. [23.128.96.34]) by mx.google.com with ESMTPS id k24-20020a6568d8000000b005c66616240bsi11424461pgt.567.2023.12.14.06.47.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Dec 2023 06:47:54 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 as permitted sender) client-ip=23.128.96.34; Authentication-Results: mx.google.com; dkim=pass header.i=@gmail.com header.s=20230601 header.b=Kkp5xwOt; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.34 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by howler.vger.email (Postfix) with ESMTP id 7A4AA833CE25; Thu, 14 Dec 2023 06:47:49 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at howler.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1573388AbjLNOrd (ORCPT + 99 others); Thu, 14 Dec 2023 09:47:33 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:45428 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S230012AbjLNOrc (ORCPT ); Thu, 14 Dec 2023 09:47:32 -0500 Received: from mail-pg1-x52e.google.com (mail-pg1-x52e.google.com [IPv6:2607:f8b0:4864:20::52e]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id AF9C0115; Thu, 14 Dec 2023 06:47:39 -0800 (PST) Received: by mail-pg1-x52e.google.com with SMTP id 41be03b00d2f7-5c701bd9a3cso2405347a12.0; Thu, 14 Dec 2023 06:47:39 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1702565259; x=1703170059; darn=vger.kernel.org; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:from:to:cc:subject:date:message-id:reply-to; bh=sof1gkerYbku5v+b3jW5lmXu1VdUZ0QZgBhWQoXBGdc=; b=Kkp5xwOtxrYv10OSa5shZ21cAy928zSXM36Qw1ckljhPbPIGgnp5VIFhO04gf2ms49 lwMhceJJEhjJesldb717PFdsOWpIMPPdTP7pPN1e0AQj8hdzZhfejl6BJw+pHQ1fV8nW 13ERwX6ypl3x5UW42Tbdq2eZWa3nw2oNHW8zBBg/OMSDwdllQnuFQKUPWFZNtt7M1TnV NMlqxndxrnPYARe8XBCIo8SyCeHvyoRSPvYKpScYRvAIa07Tlg5ZK4nBwh41h/4G9f8i GwqfJdrwW8tYQHbSEuT735zHRaac1nhDvLPzqnWmcEwxtfDhG+VuJfhc2dSGSPqQBrBd IZFA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1702565259; x=1703170059; h=in-reply-to:content-disposition:mime-version:references:message-id :subject:cc:to:from:date:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=sof1gkerYbku5v+b3jW5lmXu1VdUZ0QZgBhWQoXBGdc=; b=me0jY1fgPwEfhYun08c2BU6iKeZuX/N5dkk8aeba+BMS3DuFLzI7zUgCoxrrVAxEMs 7V0IcNcHpzmQqA6r4ch2r+XiVP2EdLUOIgCrHsTu9PYxDpgMW2bYstIT0NDkwyxOUehL fDxeVd3+KXGcyiKtawOOcWDDYZxISlfPAo9PBPFK13i0y3w/gSTJ8WnhjKS8GcKMjoXV rWfKYgjUwhlAxp/6ADwahrxMEVxj5mqvKN+hjF+kFYMVvuwXTqdeJF0WLseMAevy5E/i vpkrWOg/XKt65rhTLvynb7OKE8eaEVujBFf6QvN47k1oDVF0Dy+Pe45MnVxVfenFZ/KL sMgA== X-Gm-Message-State: AOJu0YxQ3ira8sxeg1kp3tS8dfNj4pkwbcN1cwbpWvkekVzMuVc9QeBj 061n226x2G/cl7+b8RxpPaBvE3GHAcE= X-Received: by 2002:a05:6a20:1445:b0:18c:14e2:ad8c with SMTP id a5-20020a056a20144500b0018c14e2ad8cmr4954016pzi.25.1702565259046; Thu, 14 Dec 2023 06:47:39 -0800 (PST) Received: from rigel (60-241-235-125.tpgi.com.au. [60.241.235.125]) by smtp.gmail.com with ESMTPSA id d18-20020aa78692000000b006bdd7cbcf98sm11901912pfo.182.2023.12.14.06.47.36 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Dec 2023 06:47:38 -0800 (PST) Date: Thu, 14 Dec 2023 22:47:34 +0800 From: Kent Gibson To: Andy Shevchenko Cc: Bartosz Golaszewski , linux-kernel@vger.kernel.org, linux-gpio@vger.kernel.org, linus.walleij@linaro.org Subject: Re: [PATCH 1/4] gpiolib: cdev: relocate debounce_period_us from struct gpio_desc Message-ID: References: MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: X-Spam-Status: No, score=-0.6 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FORGED_FROMDOMAIN,FREEMAIL_FROM, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,SPF_HELO_NONE, SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on howler.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (howler.vger.email [0.0.0.0]); Thu, 14 Dec 2023 06:47:49 -0800 (PST) On Thu, Dec 14, 2023 at 04:35:09PM +0200, Andy Shevchenko wrote: > On Thu, Dec 14, 2023 at 10:40:26AM +0100, Bartosz Golaszewski wrote: > > ... > > > > Opinions? > > > > Yeah, don't make it a kernel doc. It's a private structure, no need to > > expose documentation for it in docs. Just use a regular comment - say > > what it is and why it's here. > > I agree with Bart, make it plain comment if needed. > It is a plain comment in v2. Cheers, Kent.