Received: by 2002:ab2:3350:0:b0:1f4:6588:b3a7 with SMTP id o16csp2001643lqe; Tue, 9 Apr 2024 07:04:57 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCVlvycPeENQlq6Xu/Xi/i1QftZEDom6c7n+zRB9Bvn3qZnwSPTNZKvVfk6Kz19Lc/2iiQ32Y8rmsIFwfH1VE22Fhfn8ED77PbEGuZMGCA== X-Google-Smtp-Source: AGHT+IGLUSEDuIx//ThMMLgiUll0Kj0Wwa0JQzMql/vd9D+0j1a/u+QYoJNcX7oOd6l008aQnOPi X-Received: by 2002:ad4:5ccd:0:b0:69b:287a:d2bd with SMTP id iu13-20020ad45ccd000000b0069b287ad2bdmr3834786qvb.32.1712671496986; Tue, 09 Apr 2024 07:04:56 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1712671496; cv=pass; d=google.com; s=arc-20160816; b=QgIzo8yVvqe8kgYf1X67OWxiYsi5QeOxONRCS3miy5ZcVHuImmUOKxAdAMTshN6siX 2xKywz/faKaOHFVg+wcxQUbPM/fMVWc45cD2PpJgl8Fgz0xy/1WKOt/vO02ZCN+nh50F gtEa3XwzVqnyUggw2tU5yP2pvWwnINMY8i77+Sr+skP9CZA85srTB2t8SQOtVgFEQIe1 4SqAhiIs/d7bLStRDOcp2Lngx/dAnwuomMF552puV8trKbgvVO8tJ/q/XBWaG1PERKne w2d0zp5hePOwipUTfFDBGOP1wB9FY26kojOk8kUDui83tVDX+pdJRZ7v2l3s4Ka4kScT 811A== ARC-Message-Signature: i=2; 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=WVcmmCzMCx0qOzeVSGr+rFq9VNZEW9SgsVKpHYBH4Jo=; fh=l5V5IOelutSgsw/rolzED3rJX9LPC2niszbhpV8Z63I=; b=tL2lvVaxmBFKnCtx/fdrSszgc0jcCL2qY2fPnDvzk9lOgNt81AyxL6hFl2a8BB1Zk2 flNh/B0QrFeFsQ8A3jamLimjajxkVQRaQhyOah6stJNDruCvVY3Vuctj60ZJdFEONf6K 3w5BjebQlzn0kRGZKu9DZKaD792QZ9bFHxT3wqAVrGYOoEXB+gu4wTUjUwE2w8ZkGCVK 3AuXQsW+N+IDgv3Ud33ttdu8eJCxc0kEpJTn6OdWNnr8/j2O4Y4qIHobfAxgpGgWZjKE gyEb6YyC4sl2XBh1eQ1+00euGzT2FIvylMcAPDhMaEE1pXzhJZ8ozzf+xT4/9PZlz14K UIPg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@bgdev-pl.20230601.gappssmtp.com header.s=20230601 header.b=CaxnLlfk; arc=pass (i=1 dkim=pass dkdomain=bgdev-pl.20230601.gappssmtp.com); spf=pass (google.com: domain of linux-kernel+bounces-137053-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-137053-linux.lists.archive=gmail.com@vger.kernel.org" Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [2604:1380:45d1:ec00::1]) by mx.google.com with ESMTPS id k17-20020a0cebd1000000b006969e5cabb7si10543739qvq.368.2024.04.09.07.04.56 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Apr 2024 07:04:56 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-137053-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=pass header.i=@bgdev-pl.20230601.gappssmtp.com header.s=20230601 header.b=CaxnLlfk; arc=pass (i=1 dkim=pass dkdomain=bgdev-pl.20230601.gappssmtp.com); spf=pass (google.com: domain of linux-kernel+bounces-137053-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-137053-linux.lists.archive=gmail.com@vger.kernel.org" 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 A45F61C22182 for ; Tue, 9 Apr 2024 14:04:56 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 37538130A43; Tue, 9 Apr 2024 14:01:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=bgdev-pl.20230601.gappssmtp.com header.i=@bgdev-pl.20230601.gappssmtp.com header.b="CaxnLlfk" Received: from mail-lj1-f180.google.com (mail-lj1-f180.google.com [209.85.208.180]) (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 A846313048B for ; Tue, 9 Apr 2024 14:01:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.208.180 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712671318; cv=none; b=WNShhszRdm0iKyfX182zPCc72LUWTp+ot56x0FBvBD8nbspVjApfODcgWmPyhfIvCEDxUF2c/IxeZ4pyqYi1HVaX36jmaj8nrmT5WJwTBlAY7x8YlAwQ3pB0kx31Szwc4yauxL0bR4sbwgokB9r+w+MlO5/d+flJBtfluQy2C9k= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712671318; c=relaxed/simple; bh=WVcmmCzMCx0qOzeVSGr+rFq9VNZEW9SgsVKpHYBH4Jo=; h=MIME-Version:References:In-Reply-To:From:Date:Message-ID:Subject: To:Cc:Content-Type; b=K+L6kd8ZDl79lcJNMBNAjUVjJfDTEeSrEfYeVWshIN+hJMmguhq/lcMrQM1Ywn5u+/K++xvRuUYupQmriCuiACuSHycCfxjfmIDARSgdGCMWi8CkxEVX1tJHLoP44GI9fHRllfqYDE2hCl96E0uml+O/LL5XnRnePil5FP8Fjbk= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=bgdev.pl; spf=none smtp.mailfrom=bgdev.pl; dkim=pass (2048-bit key) header.d=bgdev-pl.20230601.gappssmtp.com header.i=@bgdev-pl.20230601.gappssmtp.com header.b=CaxnLlfk; arc=none smtp.client-ip=209.85.208.180 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=bgdev.pl Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=bgdev.pl Received: by mail-lj1-f180.google.com with SMTP id 38308e7fff4ca-2d8b4778f5fso3378481fa.3 for ; Tue, 09 Apr 2024 07:01:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=bgdev-pl.20230601.gappssmtp.com; s=20230601; t=1712671315; x=1713276115; 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=WVcmmCzMCx0qOzeVSGr+rFq9VNZEW9SgsVKpHYBH4Jo=; b=CaxnLlfkl58JCtUZ30X0CvE8NXIjWzFO+raSJK0f+8v5cA++w8o7nSIKRV/WiXk1Ku Gpx+3WOpNNvwNs34VFEROSlvvHzsAdXrNBWyrn+fI82dYbD/chkBIc3nsGXhtegAykgV OSNUzjdM+N2GULEUYuSuzd6v7fC0Ase8IZ31FfcsGehbn1NXSodIHVNRIQgJkNBLhj6L gybIKYW7pIuWwSd/V+xAXrkYI6i4cE2F5nsNwis8z22FiAh3/+p8KCyDqzU8vfTMk5xx x1xOyeicumDJaw4SeyNQGIPb4YE2skLS6ObYEDdgjK5eEIJursIvu7cs392T572mZHPU PoEg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1712671315; x=1713276115; 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=WVcmmCzMCx0qOzeVSGr+rFq9VNZEW9SgsVKpHYBH4Jo=; b=gJLSdGkKmBDacwGQ4QIt5IgHTP3s+Qlh8FgHzGeXSRbsnw55xZ0A0eq6k0vNKf8+jc 7CJDUrrR225f8B93nGDy3Px/xkYZ/JY8a/txDchYB1ZkIUpz/JRpe3H9MSM5mSD4y1rb mZN5dypcp81CPt7u/xvCfXqSt5f1mnq0kp1kt+aeKvKIayWl4Chk8uoDLS6TxjODRQdQ /FjndfciSP6/ERzKEli9KzLjcOrva7KVUb4GR63usfQiQsUKZQaMUZzEWiYGxGtZ0oqV LCuaI+25S4rhbjYXyz3sY+yvO8Wb4bqC4KgmkByvEXBKNMzOK/TD2qnc5YvbKPgNmRyF PXQg== X-Forwarded-Encrypted: i=1; AJvYcCW92W19GLmtmMQK9cdRcrh/BLGAisn3k9fOa5wi0VKFF/PYWc0H9VzY+T2wBDi4MZmydgKb7WVjoFctl0Vuh+ZIraFiNwsOWWT1osMb X-Gm-Message-State: AOJu0Yy9Vw1uPVl90kbzb3cIC3RSpzdJdejn461GjAgXD0rdfUmpEWu+ 1ESKuOMKV7joMHVEFKmSEfdbWswwD6gu03wDwUpXPB7E80RMBhlR12582aYCwlWka3HOcZGAlgz q4HIr920rxgpNgHJm6gjuf950MTjASO2zQGOGxg== X-Received: by 2002:a2e:87ce:0:b0:2d6:dac4:7d4f with SMTP id v14-20020a2e87ce000000b002d6dac47d4fmr10185577ljj.4.1712671314663; Tue, 09 Apr 2024 07:01:54 -0700 (PDT) Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 References: <20240408231727.396452-1-andriy.shevchenko@linux.intel.com> <20240408231727.396452-3-andriy.shevchenko@linux.intel.com> In-Reply-To: From: Bartosz Golaszewski Date: Tue, 9 Apr 2024 16:01:43 +0200 Message-ID: Subject: Re: [PATCH v2 2/2] gpiolib: Update the kernel documentation - add Return sections To: Andy Shevchenko Cc: Bartosz Golaszewski , Kent Gibson , Linus Walleij , linux-gpio@vger.kernel.org, linux-acpi@vger.kernel.org, linux-kernel@vger.kernel.org, linux-wireless@vger.kernel.org, brcm80211@lists.linux.dev, brcm80211-dev-list.pdl@broadcom.com, Mika Westerberg , Arend van Spriel , Kalle Valo , Charles Keepax , Randy Dunlap Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Tue, Apr 9, 2024 at 2:52=E2=80=AFPM Andy Shevchenko wrote: > > On Tue, Apr 09, 2024 at 02:12:51AM +0300, Andy Shevchenko wrote: > > $ scripts/kernel-doc -v -none -Wall drivers/gpio/gpiolib* 2>&1 | grep -= w warning | wc -l > > 67 > > > > Fix these by adding Return sections. While at it, make sure all of > > Return sections use the same style. > > Since there shouldn't be hard dependency to the first one, can you consid= er > applying this one, so it unblocks me? > I'm not sure what the resolution is for % and HTML tags in the end? Bart