Received: by 2002:a05:7412:d1aa:b0:fc:a2b0:25d7 with SMTP id ba42csp314616rdb; Mon, 29 Jan 2024 03:14:47 -0800 (PST) X-Google-Smtp-Source: AGHT+IEFuH3XTPfk6dqUqoaPA1x6Ps/lHi16NY4nyiylELRoByD6kYQeiSZGTnUx+BoB9PXqPyBu X-Received: by 2002:a05:6902:2cb:b0:dc6:7937:53da with SMTP id w11-20020a05690202cb00b00dc6793753damr927917ybh.39.1706526887544; Mon, 29 Jan 2024 03:14:47 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706526887; cv=pass; d=google.com; s=arc-20160816; b=ynFaFby9JJIfvF/TU+SjObbSubrO70r3XYnoMwCNIjocG4TyZksCInKmOYOpCfi1qD 2UjLtjPYJ+Nud1NlXLlyiehaZZWfieaeeHwsFeTzXd1SIqDuNGNS1PshgWFaRdsPkHgi rJBeC+z7YJEeHuay6PxMJInXHlGZIEjziOReCFm/avOsl6A6z2mN5Di3xHAdrGMS+8fh pVCEEjULYKyJF/J+O4RN7/R24Y1rL+Kjyj6JmGFs6XxUiH+eBlyk0Xze/cp8jpz9l931 f+uxX0/yvx79lRujR4dmuqB7E9Oal6nSxih9AyYbW0B60q2HVlt8WQC7bs8mgIuFQ/LI Xwag== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=mime-version:list-unsubscribe:list-subscribe:list-id:precedence :user-agent:message-id:in-reply-to:date:references:subject:cc:to :from:dkim-signature; bh=M/YNNP3dQ096/ctf1cO2Y/8JuPGQvKQjrgzL4GgK9KU=; fh=JG8laRgMebNGcIJ0/LFt2bSW2VJa0625FxZyJFZI3o4=; b=gZ6dlKFCqhUMIwJvSbZG18R9Okv/QEsOR4adGVb+PCEKu4YtgLYaZYC3Xf4XfIf1Tr koViEBg4OHtnU26TvhDfS56HlkMhU42UscU/8Cn0+Iia6HaSB8n17IshtzDgP9ry41jB 9GEFZbOBR2zxAijtPzVf/X1hwvMZcLvJlqpdlom2jzGrol+SDk9V0aFwnsTzgXMZjY5q F9LRdZ7AfNpJfbjscj8sNed56XD3Zxdjjw9ZM8++gXqUADacpsonhkw79dC1XsUnNWSh Vqz/NsEoniK8AL5rV4MGAM3gfI2NZ1FC7NIg3uOkvkLT1whgBu2DqesppMOkVosJUYJm athg==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=AJX8NpXl; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-wireless+bounces-2662-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-wireless+bounces-2662-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org X-Forwarded-Encrypted: i=1; AJvYcCXRExXMB5PvSkQ8wiZbACiIpVha20mJWo3EgseuGVMoVqFiiaZTSwiNdPsuLCY0t7EqKk3WulqYL7gE65CjyynJtxfY+HNTWwjZyhhpDQ== Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [139.178.88.99]) by mx.google.com with ESMTPS id q65-20020a632a44000000b005cd8b5dfe9csi5520013pgq.491.2024.01.29.03.14.47 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 29 Jan 2024 03:14:47 -0800 (PST) Received-SPF: pass (google.com: domain of linux-wireless+bounces-2662-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) client-ip=139.178.88.99; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=AJX8NpXl; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-wireless+bounces-2662-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-wireless+bounces-2662-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=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 sv.mirrors.kernel.org (Postfix) with ESMTPS id 01213285808 for ; Mon, 29 Jan 2024 11:14:47 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id BB9285B5A5; Mon, 29 Jan 2024 11:14:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="AJX8NpXl" X-Original-To: linux-wireless@vger.kernel.org Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (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 92B5155E7B; Mon, 29 Jan 2024 11:14:43 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706526883; cv=none; b=oKfxkSb+XnQxPA+splkMaCXl3+mq70ZAyEcn8N4WHntypb29lbkUAr++rgMnZhzhMLPp2cqExH9VDjmhZjXvb0bce23YQMQah5h3NIkrXPX5hiXD1X+WH4lG8Hq3lzbPY7S/3JxCq3fbY8CW1EJU450+CzPH+Oo7+/FwEu5Okrg= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706526883; c=relaxed/simple; bh=WmE0fsg1x9uaRKxDdJFE55N2p6ZINp1Yi48GoUlIIsc=; h=From:To:Cc:Subject:References:Date:In-Reply-To:Message-ID: MIME-Version:Content-Type; b=txSPEwseNWkxQeBXVvP0rf8c9SV7HAqkhv14P6/KcsSK2k+SBr9jVKz+uErrG4v4tpkTejD63rz1sVQpXtGrQ+3nLzEM0DNilcRVE5iAroBq/qiCqRvoezyaMnAlctIKa5yCe1dYzqHvUiZl8qYS5k9mJmayRzgt2JaCKJDPMhM= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=AJX8NpXl; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 18052C433C7; Mon, 29 Jan 2024 11:14:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1706526883; bh=WmE0fsg1x9uaRKxDdJFE55N2p6ZINp1Yi48GoUlIIsc=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From; b=AJX8NpXlwvyEcyqETHycRIfU3BmA3IJvX2EJsIH3Gx9wsO+hpJHCwvbBJv32e0dq5 JJPI+NDMTp6rTf85q2yrnQbTLr+O/KBdG/im06hpX1g2L6694mR12w0sUJn9gBdyb5 9LjJ5ds6YmXZyyFIQl7G7kqsnDDYweO25nuZheOQOOMd2Nt/+ScABH7J9PLdq4dATI R0+JbPVCDlIM/HIs2XrREgL7/armESBa1z65Pwo5fIDkVQsNmMyhiK/Xw2q15aCXQa kQeRE89hu0SLGHDhtTLQ8qHZaRgWKfpUMt/y9FSI1D/0Om13MA3JoNWrCQ0SC31MrY plnmHKajOTBYg== From: Kalle Valo To: Jeff Johnson Cc: , , Subject: Re: [PATCH] wifi: ath11k: document HAL_RX_BUF_RBM_SW4_BM References: <20240111-document-hal_rx_buf_rbm_sw4_bm-v1-1-ad277e8ab3cc@quicinc.com> <874jfg7xm4.fsf@kernel.org> <875xzq526o.fsf@kernel.org> <87ttn0xc9y.fsf@kernel.org> <9c321dfc-f10d-4092-a1cd-30952e4da695@quicinc.com> Date: Mon, 29 Jan 2024 13:14:38 +0200 In-Reply-To: <9c321dfc-f10d-4092-a1cd-30952e4da695@quicinc.com> (Jeff Johnson's message of "Fri, 26 Jan 2024 09:05:26 -0800") Message-ID: <875xzcxug1.fsf@kernel.org> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.2 (gnu/linux) Precedence: bulk X-Mailing-List: linux-wireless@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain Jeff Johnson writes: > On 1/26/2024 8:58 AM, Kalle Valo wrote: >> Jeff Johnson writes: >>> They have the same problem I'm trying to fix ;) >>> % scripts/kernel-doc -Werror -none \ >>> $(find drivers/net/wireless/intel/iwlwifi -name '*.[ch]') >>> ... >>> 322 warnings as Errors >>> % >> >> Ouch. But I'm surprised why nobody has reported these before? Are the >> kernel-doc warnings ignored by everyone? > > There are folks who use the kernel 'make' command to build the > documentation, and report issues from that. But my understanding is that > 'make' only processes the source files that are referenced by the > kernel's .rst files. So if a source file has documentation, but that > source file is not included by one of the .rst files, it won't normally > be processed. > > It is only by running kernel-doc directly against the sources that you > can spot these issues. Ah, thanks for the explanation. -- https://patchwork.kernel.org/project/linux-wireless/list/ https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches