Received: by 2002:a05:7412:d008:b0:f9:6acb:47ec with SMTP id bd8csp379122rdb; Tue, 19 Dec 2023 22:35:37 -0800 (PST) X-Google-Smtp-Source: AGHT+IGjT9yN/SDhpsJZGzo2dkPy+xAgd2YjKsqqCWuyAGsUD27UjsuQxXvDyORpA4XS0sTcqzYC X-Received: by 2002:a05:620a:24c7:b0:77f:19b1:fe8 with SMTP id m7-20020a05620a24c700b0077f19b10fe8mr24432242qkn.153.1703054137301; Tue, 19 Dec 2023 22:35:37 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1703054137; cv=none; d=google.com; s=arc-20160816; b=Imif8kHT53XC9cPzVJQRdX5KRb15dX2yRxl1OMoCcX4dMw0lZbs66n55nRlglBtlXF UnWE746M6wrwllppVLlG6vo9G67SGuVtDNAnqCirJpcvUmN14FnOQrIxzaAgbtAWa7jE khxNQNRaCsCCA03VRTAjF1fxR65Qds1gPrt1CLyhpmmVL33iARko5oRgeloYzwcljCxE OBq5lGhVrK3/dv5klwxG9tdbniFwGoO3aJuo2DFBne0CBTpKo5CcRm1wP5FUt3GF+7RP nLyGUhUYqUDNTH8N3KHo0GgvcpVBVYint1ncgeN4GVMh7xlAKq/VTi2QEhTTLi6BDXrP B+7A== ARC-Message-Signature: i=1; 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=3sHafcfpelKJQtis0XChJl5MUAeboN1xEAcItqgj//g=; fh=9zANN8ZEFGK/x8+cnzYiMOed3gsOnWJqw1eHa6flZT8=; b=JNKUCWSSQvk42wXSKigkmq/13eIplfhYjNFNdi5tTAeac3DauksSYVLaPEtdEsSz5e oSfL3HmyWgN0qCHDvFdKJoV5fYXrStHhTCgafMUgOlXWQ0KaKN5zy9gBhpn/kXsevDl6 CBkZRllR7SaFPCqrS90KYi972VF5UUi/xapVPcJh1dONqernP2VODBjHHMlYFrdajOZB qtSTpQadMjo++phJBTZeIRvG4qgTPzGaeNkeOBomYfwa7UJjGEYAYXWQIhrzdW6NXRR1 qHJHMzHJCLFdSKVKNsHDbjo/6KgiHJUlzDPzseA6T1TlzKdqX/7pqieX2qBk0XQ80TN1 +Ebg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b="fbo2/DvG"; spf=pass (google.com: domain of linux-wireless+bounces-1068-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-wireless+bounces-1068-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Return-Path: Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id m8-20020a05620a24c800b0077d7c062e8bsi23433310qkn.568.2023.12.19.22.35.37 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 19 Dec 2023 22:35:37 -0800 (PST) Received-SPF: pass (google.com: domain of linux-wireless+bounces-1068-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=@kernel.org header.s=k20201202 header.b="fbo2/DvG"; spf=pass (google.com: domain of linux-wireless+bounces-1068-linux.lists.archive=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-wireless+bounces-1068-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 ny.mirrors.kernel.org (Postfix) with ESMTPS id 01DD91C21FF5 for ; Wed, 20 Dec 2023 06:35:37 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id AE80C946C; Wed, 20 Dec 2023 06:35:34 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="fbo2/DvG" 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 74E501F5F4; Wed, 20 Dec 2023 06:35:34 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id CCF3BC433C7; Wed, 20 Dec 2023 06:35:32 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1703054133; bh=lSLKKBYH94CYSNWb5usvPbjUUCyG+JLH6+SgLDKnqmU=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From; b=fbo2/DvGJV6hSnLzsIE1z6p1ZBwwi08h6AI8tOQjHE7qFIl7uzGBbu52zKuRY3UOS gGBjdciuFA69Ol9E5hETjcBjCEfwxi7GpArsOmMzHwjEmqlrJDrI+FipXbXozWuc/M ic7+jr4tnIyPRHWcQjiXx8iBynF4EkEL35XdfkxEUOqs1bjPD24ic8AhcGBMFdpp0b NyAeSjodC7b/6/3KCVl9k4b3fkVenqPLpUaE6IYm6KveJ+jLvtAXVRA6zRwRLxgmIY Viw9SOXHHKbobo3vSxX6hwV5wXFiQcBC+lqPnYA5XAinhR+BokiHmmcDfweS14x6fi G273OPQ2BEfIQ== From: Kalle Valo To: Jonathan Corbet Cc: Johannes Berg , linux-wireless@vger.kernel.org, netdev@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] wifi: cfg80211: address several kerneldoc warnings References: <87plz1g2sc.fsf@meer.lwn.net> Date: Wed, 20 Dec 2023 08:35:30 +0200 In-Reply-To: <87plz1g2sc.fsf@meer.lwn.net> (Jonathan Corbet's message of "Tue, 19 Dec 2023 17:01:39 -0700") Message-ID: <87jzp92xfx.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 Jonathan Corbet writes: > include/net/cfg80211.h includes a number of kerneldoc entries for struct > members that do not exist, leading to these warnings: > > ./include/net/cfg80211.h:3192: warning: Excess struct member 'band_pref' description in 'cfg80211_bss_selection' > ./include/net/cfg80211.h:3192: warning: Excess struct member 'adjust' description in 'cfg80211_bss_selection' > ./include/net/cfg80211.h:6181: warning: Excess struct member 'bssid' description in 'wireless_dev' > ./include/net/cfg80211.h:6181: warning: Excess struct member 'beacon_interval' description in 'wireless_dev' > ./include/net/cfg80211.h:7299: warning: Excess struct member 'bss' description in 'cfg80211_rx_assoc_resp_data' > > Remove and/or repair each entry to address the warnings and ensure a proper > docs build for the affected structures. > > Signed-off-by: Jonathan Corbet I try to periodically check for kerneldoc warnings in wireless trees but I have never seen these. Am I missing something or did you do something special (enable new warnings etc.)? -- https://patchwork.kernel.org/project/linux-wireless/list/ https://wireless.wiki.kernel.org/en/developers/documentation/submittingpatches