From patchwork Fri Mar 1 08:18:02 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Yang Li X-Patchwork-Id: 208694 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7301:2097:b0:108:e6aa:91d0 with SMTP id gs23csp940909dyb; Fri, 1 Mar 2024 00:41:58 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCUkcxXS4b5x8giuzCG47nfw1SijoMjuVAJz5IX3geTLaW39WNdQ+LjkI3sdSTtM2O51aHFgJTCBXhfXdp57LajFIlsPyg== X-Google-Smtp-Source: AGHT+IFTUv1N2K6dY8C/t4PyxdgWxPH3X7AVjSNoYCP4PJUyESBg+GB8BUyoCNa2xASwyIXU7Y6F X-Received: by 2002:a05:6a21:1a4:b0:1a0:c470:aacc with SMTP id le36-20020a056a2101a400b001a0c470aaccmr963122pzb.21.1709282518171; Fri, 01 Mar 2024 00:41:58 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1709282518; cv=pass; d=google.com; s=arc-20160816; b=gHrBOdbeeNjThbDlcP+HHR1kHD94567G5SCd17LvDGi5+Lw+ajnKTqsfetem83OXjB 4knpAiTA5+BQdb94k1UniHxELjMwrluFrd+5fSr6jCj9QD1IS7+iiXfVaF9neTJkuEKO 1huWEubZhbwCaO8xa1dxCoT0kkq04PFasXiS5GaQIRsEMi4gQmVxRJFArOcXlITF38NC sUehYBpDSpiprAIaa3YshnIUrUHEb1b8nRdad4n8jSDhg4FZ4QOJrwHxDtHtY29Lzx74 Z603XvPhsn9qW2ZRJFaoy6I5892nQEwzizdoD8quomFwlCgnCiN6R16eQEo0oSN4NZgS 6R6Q== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:message-id:date:subject:cc:to :from:dkim-signature; bh=/fhMqxBCkmmn8CH6FRiUPSq20rCPOyTNVQl0VCwCg98=; fh=26zRUuY1Xo8rZWRD+yg3gfGKZqDIQZ/0qFUBkt07SEY=; b=Ya+K51ztaiGhyQ3hOqCdy1cS4RfXUfYYnKRnnpYxxdKgdk3pZ+HgwvRB5eOVyGfcad P79ZV4ZK53jRFSYrDnc0SWR1QKcEJUdMiAAjmY8I1GX2y1mwYeiJ7rxBj7g2SNGx8dQG tlFUO7BEVv1MBFUbjUlx8rM3ymume/6pQg6py8Yox7xuSjM5fNPHIrXOIiozRabJFm8+ kFXiIIK+rJbseGmxib6KM5d00uavkCvqUKDEIsybakNEE8ukVxYjrYIjqpMUiM4ZniDD 6Rsc7P/sznwY2W9JibXf3Mg2R8NBfyN77H0KsRxdSOe8pFLCfwU4ilfBz/znFzzhAdU6 4LuQ==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@linux.alibaba.com header.s=default header.b=HTEBLvZM; arc=pass (i=1 spf=pass spfdomain=linux.alibaba.com dkim=pass dkdomain=linux.alibaba.com dmarc=pass fromdomain=linux.alibaba.com); spf=pass (google.com: domain of linux-kernel+bounces-88092-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-88092-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linux.alibaba.com Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id h6-20020a635306000000b005d9b919b94asi3308482pgb.311.2024.03.01.00.41.58 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 01 Mar 2024 00:41:58 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-88092-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) client-ip=2604:1380:45e3:2400::1; Authentication-Results: mx.google.com; dkim=pass header.i=@linux.alibaba.com header.s=default header.b=HTEBLvZM; arc=pass (i=1 spf=pass spfdomain=linux.alibaba.com dkim=pass dkdomain=linux.alibaba.com dmarc=pass fromdomain=linux.alibaba.com); spf=pass (google.com: domain of linux-kernel+bounces-88092-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-88092-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=linux.alibaba.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 sv.mirrors.kernel.org (Postfix) with ESMTPS id C3C1F2857EA for ; Fri, 1 Mar 2024 08:41:20 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 5BF446A8C6; Fri, 1 Mar 2024 08:40:33 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=linux.alibaba.com header.i=@linux.alibaba.com header.b="HTEBLvZM" Received: from out30-113.freemail.mail.aliyun.com (out30-113.freemail.mail.aliyun.com [115.124.30.113]) (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 025346997D; Fri, 1 Mar 2024 08:40:26 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=115.124.30.113 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709282430; cv=none; b=Pq9gpSVT5X7n5OFxElQOQRI4mMbenS4gaZrqMCFKuhHXeS3jebG0FOP+MRyuI07vTzkOpaptAqHMUhFQFL7SnYtiYeec4gDOTf0BiYFER88ZJxwnlzxkQTgfozagsDecjMMhn7pjNfgsF2/pQ4wgs+XWH42BD901hwwg1ad2pd0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1709282430; c=relaxed/simple; bh=JpANkCjtetYRdF5bevCopBm1xT0VWZ4TSa3drrOENZo=; h=From:To:Cc:Subject:Date:Message-Id:MIME-Version; b=nEGjxr5ImZlJexoKT+CVzA3jZNyP7A39K53Z1CKgDDMc6LI4ddAr7491SYly0dS8QST/TgGySzWFvqgVxzgTBqhU2c3qVzWtRJboz++zQ7MJINrXGBnMyO7DAXAgvmljsImvg95h3wD6zeKhMjAMe8kRp9gsirJg00YDkGCmshw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.alibaba.com; spf=pass smtp.mailfrom=linux.alibaba.com; dkim=pass (1024-bit key) header.d=linux.alibaba.com header.i=@linux.alibaba.com header.b=HTEBLvZM; arc=none smtp.client-ip=115.124.30.113 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=linux.alibaba.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=linux.alibaba.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.alibaba.com; s=default; t=1709282419; h=From:To:Subject:Date:Message-Id:MIME-Version; bh=/fhMqxBCkmmn8CH6FRiUPSq20rCPOyTNVQl0VCwCg98=; b=HTEBLvZMpm15fEpSEOj7Iez298xUmJH8SlSBwNfdgmz9VdNsz8AMCVRqBn3/W4q9g0cDxkOrLcvWrnAg8vYg40JU6O3VL2JUqk0zz7MeeHBIKtpYKQES71TxVrz9qlObMPI3NJUw0BsyAR+WSay0WnvPHslgJ67azXwAvEfsb+A= X-Alimail-AntiSpam: AC=PASS;BC=-1|-1;BR=01201311R131e4;CH=green;DM=||false|;DS=||;FP=0|-1|-1|-1|0|-1|-1|-1;HT=ay29a033018045170;MF=yang.lee@linux.alibaba.com;NM=1;PH=DS;RN=5;SR=0;TI=SMTPD_---0W1a.nJe_1709282417; Received: from localhost(mailfrom:yang.lee@linux.alibaba.com fp:SMTPD_---0W1a.nJe_1709282417) by smtp.aliyun-inc.com; Fri, 01 Mar 2024 16:40:18 +0800 From: Yang Li To: daniel.lezcano@kernel.org, rafael@kernel.org Cc: linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org, Yang Li Subject: [PATCH -next] powercap: dtpm: Fix kernel-doc for dtpm_create_hierarchy function Date: Fri, 1 Mar 2024 16:18:02 +0800 Message-Id: <20240301081802.114308-1-yang.lee@linux.alibaba.com> X-Mailer: git-send-email 2.20.1.7.g153144c Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1792312626054452618 X-GMAIL-MSGID: 1792312626054452618 The existing comment block above the dtpm_create_hierarchy function does not conform to the kernel-doc standard. This patch fixes the documentation to match the expected kernel-doc format, which includes a structured documentation header with param and return value. Signed-off-by: Yang Li Reviewed-by: Randy Dunlap --- drivers/powercap/dtpm.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/drivers/powercap/dtpm.c b/drivers/powercap/dtpm.c index ce920f17f45f..f390665743c4 100644 --- a/drivers/powercap/dtpm.c +++ b/drivers/powercap/dtpm.c @@ -522,7 +522,7 @@ static int dtpm_for_each_child(const struct dtpm_node *hierarchy, /** * dtpm_create_hierarchy - Create the dtpm hierarchy - * @hierarchy: An array of struct dtpm_node describing the hierarchy + * @dtpm_match_table: Pointer to the array of device ID structures * * The function is called by the platform specific code with the * description of the different node in the hierarchy. It creates the