Received: by 2002:ab2:3350:0:b0:1f4:6588:b3a7 with SMTP id o16csp2003427lqe; Tue, 9 Apr 2024 07:06:57 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCWFqDWpRpT6Gg97HRWl4SIiMxCrfvd8pmTnhuQFhFWkoprCBEHCaSp+8Ih07Zp0w+mVdghIvvQqUtkuMzJCMBnnXfGbQjMcITwnac1wPw== X-Google-Smtp-Source: AGHT+IHM3/oNh2BbhHfX896jxIDiOR9vhE4SopmtmUFvJ2nFnWWwQP0RN71gpl42HZa2OlfvYloK X-Received: by 2002:a05:620a:4304:b0:78c:4dbb:678f with SMTP id u4-20020a05620a430400b0078c4dbb678fmr13761306qko.77.1712671617048; Tue, 09 Apr 2024 07:06:57 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1712671617; cv=pass; d=google.com; s=arc-20160816; b=ceiMtYHeav2u3cadVN5IeNhRuNl3UtrsYEEn+u1KoPNOJmHIAgHNh3YUeCN4AXVnU9 kw2Mt3J13ljOkX1uj8agap0esinbkOfVWw3+dobfrit32lBH/TbWI0m2Blie/VdRbVSB cpW70Sum4pNF4rMHABkZajr89zqZzm2n99ZKg7b3YyDTymQojgRaRbJ6CYfZX2Eym1QX +4PaXOeTkbGNNvuT+edA0OOvLffTD6FoyUPUV268WHIQw44eu5aGBLgaEBd0b/HW/FSe icx8Z4gNr+gfRfcrNfz+eYCQHIzbEcGZUf1AdU9h7PpzWxn1wYU2TB5wGa3d8uAYI5Sn Kkbw== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=organization:in-reply-to:content-transfer-encoding :content-disposition:mime-version:list-unsubscribe:list-subscribe :list-id:precedence:references:message-id:subject:cc:to:from:date :dkim-signature; bh=q6p8Etcgjgo7zGfDLj4240ob0M7QqAL683fEjwDGbZ0=; fh=YsAMdgnuUY3htUXSDWCwvGvbokYGDUFm3mzb8bUGn94=; b=s7f6J3xt2601anWHBF/VMCkWmBIJluxyI1ftwpbM8zNvKRX7iB0QUAbGPz981+Buiv r8Uzp+p1u8zhQ1KXTRjMKVcsICslds0sXKDP3qvTyXZrsw3uboEQ1VQSWY3VAJTux2Re 1ikElgby4sCPcA9twZRTqQWMPdEGAZL/e+K/cGtAmJ3HK76pZVXNym8LOxhpelQqPjVp Ho3iCM3SyQTIeE7msrmv8btE+rTLpHf9aEjJaSiWz7A6Jsw6ZxbLYFMdBwD8kYhZMapo t4PSGSMN6U59iWOZ2xYL7dPfl7+jsj3qRtuQ1cxxmQnTfRhJT/4+bD5BHVvnJEySasOL iB1A==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=CECIG6Ph; arc=pass (i=1 dkim=pass dkdomain=intel.com dmarc=pass fromdomain=linux.intel.com); spf=pass (google.com: domain of linux-wireless+bounces-6026-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-wireless+bounces-6026-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.com Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id o22-20020a05620a229600b0078d65c685absi4384255qkh.48.2024.04.09.07.06.56 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 09 Apr 2024 07:06:57 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-wireless+bounces-6026-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@intel.com header.s=Intel header.b=CECIG6Ph; arc=pass (i=1 dkim=pass dkdomain=intel.com dmarc=pass fromdomain=linux.intel.com); spf=pass (google.com: domain of linux-wireless+bounces-6026-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-wireless+bounces-6026-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=intel.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 C45731C23124 for ; Tue, 9 Apr 2024 14:06:56 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 080AC12F595; Tue, 9 Apr 2024 14:06:51 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b="CECIG6Ph" X-Original-To: linux-wireless@vger.kernel.org Received: from mgamail.intel.com (mgamail.intel.com [198.175.65.14]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 7F3407EEE0; Tue, 9 Apr 2024 14:06:49 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.175.65.14 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712671610; cv=none; b=p1oiaCLOvjjEf2mTLWvEJKV8he4tw3rv/XPO2UTFbrn5m3tmUbXZG6a2xyRW0R1A9hlUfvSzuiICWLpTz0GGRp5kt9X/pUFopTfIOP+WE9B+iW4waPAdIxvCKKApDGyKR1zmdSgunk0G2xmHJeEmMV88Kuz3wXuA4eWuNPDodd4= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1712671610; c=relaxed/simple; bh=P1gNeYkG5bwZnGH03ghwXER+cIJuJOAxd+xPMYGlaCI=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=Y6F8LsTSHyx0RvBXAJB2yIrI+U2ZQVLc610o7F3SAjp3lN8wTzPAqwzagTFJLTxqyREn6KpjEsuRu7vH4EwJvX8Tg6Ie8OIi89tNwCaJYp2XGhD4wqOtmiBNBq7aERvnazGNRTxv3jGjk6qOBZg6kArgZXHxN4Ig8cHoli+0Q+Q= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com; spf=none smtp.mailfrom=linux.intel.com; dkim=pass (2048-bit key) header.d=intel.com header.i=@intel.com header.b=CECIG6Ph; arc=none smtp.client-ip=198.175.65.14 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.intel.com Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=linux.intel.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1712671609; x=1744207609; h=date:from:to:cc:subject:message-id:references: mime-version:content-transfer-encoding:in-reply-to; bh=P1gNeYkG5bwZnGH03ghwXER+cIJuJOAxd+xPMYGlaCI=; b=CECIG6PhoJPLrdMzNAIV1vmPfiYCQtMiWvTM4ql0OtwlGymCTeAxjiGl 6NkPEJukJMAqQ0XPJuNLBMFbRDtBlXdcYoLhQSMN96M8yVVXq+RSeN0Ye N3YcO4dt/o1y4GAN0vBC+BvWYOZA4DTSTSYmdbgAkTMpctR/LDQjF7sif Ex6XipHnLVCQam89eknrWefYdUUgO9+XQMjXJ9HAuF72uHCMmcWN7yFAB 75l8MSk3O8dWYDo6LK0fRCn57/oxTADUveLQp2oOHOnE160bHYD6yH7AD M5iuaSQYCm49MCYBRWyTsOH2CRgfZyScy1Afl9jtmnKHVkUWdP/4EgACN g==; X-CSE-ConnectionGUID: u1vYq9qwR2ajBKvYNeCxaw== X-CSE-MsgGUID: +H+XGrLcRLqlpp9bUYyW9A== X-IronPort-AV: E=McAfee;i="6600,9927,11039"; a="11824762" X-IronPort-AV: E=Sophos;i="6.07,189,1708416000"; d="scan'208";a="11824762" Received: from fmsmga002.fm.intel.com ([10.253.24.26]) by orvoesa106.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Apr 2024 07:06:47 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6600,9927,11039"; a="915400773" X-IronPort-AV: E=Sophos;i="6.07,189,1708416000"; d="scan'208";a="915400773" Received: from smile.fi.intel.com (HELO smile) ([10.237.72.54]) by fmsmga002.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Apr 2024 07:06:44 -0700 Received: from andy by smile with local (Exim 4.97) (envelope-from ) id 1ruC7V-00000002p7w-0HJf; Tue, 09 Apr 2024 17:06:41 +0300 Date: Tue, 9 Apr 2024 17:06:40 +0300 From: Andy Shevchenko To: Bartosz Golaszewski 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 Subject: Re: [PATCH v2 2/2] gpiolib: Update the kernel documentation - add Return sections Message-ID: References: <20240408231727.396452-1-andriy.shevchenko@linux.intel.com> <20240408231727.396452-3-andriy.shevchenko@linux.intel.com> Precedence: bulk X-Mailing-List: linux-wireless@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit In-Reply-To: Organization: Intel Finland Oy - BIC 0357606-4 - Westendinkatu 7, 02160 Espoo On Tue, Apr 09, 2024 at 04:01:43PM +0200, Bartosz Golaszewski wrote: > On Tue, Apr 9, 2024 at 2:52 PM 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 consider > > applying this one, so it unblocks me? > > I'm not sure what the resolution is for % and HTML tags in the end? Most of the constants are without %, so less churn now is to drop %. If you think otherwise, please, fix it and I will rebase my patches later. -- With Best Regards, Andy Shevchenko