From mboxrd@z Thu Jan 1 00:00:00 1970 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 CA22F2E091D for ; Fri, 14 Nov 2025 18:58:26 +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=1763146706; cv=none; b=rrYrL2SREa1UM8d1PrzJ1ky2VhVosFeTEqm+8m8PParVy6eut7fKRmj4yLGtANrXgmbMpcNkX38E00lkPu6vmzI31TDmWZIcLJW28fQaLTo79kf0X9dG6DTAdUintky4U+VcqVvH5Bh05suAyeBrBbFGGiNFtq/Ffgl2tfVgeMc= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1763146706; c=relaxed/simple; bh=q8dXv2gjCb0HMRBIrn6CM4/Luf/0a9+wSuIdaXVvnWs=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=SkNGTmVG2XCWq687iyfuJw873gjSaGkyaLhFPjwWqPuj3hrGAdLm24fixHJQsPSvn8V3ft2gqfl6NJ/+ooz/lF0WLnxZOcYDE0fIBNa6YbIQxAZFFLZlsmKaSxILSEnPgfyisMaedbnmqIaLaRvXOZogKSMiaGpFb2szTocD/Tg= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=H23QOJNA; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="H23QOJNA" Received: by smtp.kernel.org (Postfix) with ESMTPSA id A47DFC116D0; Fri, 14 Nov 2025 18:58:25 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1763146706; bh=q8dXv2gjCb0HMRBIrn6CM4/Luf/0a9+wSuIdaXVvnWs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=H23QOJNAmfIooILQcJU0nWREuupZ9HKMZm+PDExS9jes0DChBpbCpnRKJKxx9I81F sHXxOJ9vb9QrO09jAOTXANY23sACCj67L6DxyfC6o+uwSryT+QIMOI4mPNoAITw5K0 0zerQWZsOMk1rO1pgIkdOvovZ5vy79854PUlRr0TmfP1eaLJwjSr5T8r348tvgRObC S9M07Mu1tDr9wRoYxnDa6qb9VbxLzYxK5lLWJx26j0Xy330s6dek4peMQ9p6J1lCYu bdCDLYtr4OikWq8/pUOIBMGjNIQiRgb6gSGvf4IK19a3xiWBPukmTRdd2/VKET9CyB tyyU/DCUEVbZA== From: Dinh Nguyen To: linux-kernel@vger.kernel.org Cc: dinguyen@kernel.org, gregkh@linuxfoundation.org, arnd@arndb.de, Stephen Rothwell Subject: [PATCH 2/3] firmware: stratix-svc: fix make htmldocs warning Date: Fri, 14 Nov 2025 12:58:14 -0600 Message-ID: <20251114185815.358423-2-dinguyen@kernel.org> X-Mailer: git-send-email 2.42.0.411.g813d9a9188 In-Reply-To: <20251114185815.358423-1-dinguyen@kernel.org> References: <20251114185815.358423-1-dinguyen@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Stephen Rothwell reports htmldocs warnings when merging char-misc tree: WARNING: drivers/firmware/stratix10-svc.c:58 This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * Total number of transaction IDs, which is a combination of WARNING: drivers/firmware/stratix10-svc.c:302 This comment starts with '/**', but isn't a kernel-doc comment. Refer Documentation/doc-guide/kernel-doc.rst * svc_mem_lock protects access to the svc_data_mem list for Fixes: bcb9f4f07061 ("firmware: stratix10-svc: Add support for async communication") Reported-by: Stephen Rothwell Closes: https://lore.kernel.org/linux-next/20251114153347.16001109@canb.auug.org.au/ Signed-off-by: Dinh Nguyen --- drivers/firmware/stratix10-svc.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/drivers/firmware/stratix10-svc.c b/drivers/firmware/stratix10-svc.c index ebf3a591efc6..515b948ff320 100644 --- a/drivers/firmware/stratix10-svc.c +++ b/drivers/firmware/stratix10-svc.c @@ -55,7 +55,7 @@ #define MAX_SDM_JOB_IDS 16 /* Number of bits used for asynchronous transaction hashing. */ #define ASYNC_TRX_HASH_BITS 3 -/** +/* * Total number of transaction IDs, which is a combination of * client ID and job ID. */ @@ -300,7 +300,7 @@ struct stratix10_svc_chan { static LIST_HEAD(svc_ctrl); static LIST_HEAD(svc_data_mem); -/** +/* * svc_mem_lock protects access to the svc_data_mem list for * concurrent multi-client operations */ -- 2.42.0.411.g813d9a9188