From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mx0b-0031df01.pphosted.com (mx0b-0031df01.pphosted.com [205.220.180.131]) (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 1519E3A6B9C for ; Tue, 18 Aug 2026 11:50:30 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=205.220.180.131 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787053832; cv=none; b=aHRcsx/1Y14MPiDH7K4gXCUoGKXnolKWAMLlBCHRjdc0odCZRhCwrC5NHdSqkhaQWmz4WVyyXBHiV/uta4wlJzxQtIB5yX4xQtaboqhFzpgRdHOwtMqErBdlQ20JT0pdTZLTzoosP7GyRWHAZ6oAO8ynb0nWOK9ZUnH0X5/nfic= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1787053832; c=relaxed/simple; bh=kqMgyjlZy37WZDYVadqnRsGo+CDsIryLtrrmBvu9aGo=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=Gc5/lzE87FT+Pw69mdlPk6GidXP8ok5NBOBjRIvbSPekzk829FWs3v0GzQaqP/MGVvlo9ofkziDxCwql7PDQ/yVCjraoJ6Yk7ALDa7u+WvrSXw06G3ZR9Gtk0B6NzN5ju+ksOdl7G8F+A+0o/f+1uhQi36aIzBr3VDXN2CipdfE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com; spf=pass smtp.mailfrom=oss.qualcomm.com; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b=GT94uP5F; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b=XntwuY2w; arc=none smtp.client-ip=205.220.180.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=reject dis=none) header.from=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=oss.qualcomm.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=qualcomm.com header.i=@qualcomm.com header.b="GT94uP5F"; dkim=pass (2048-bit key) header.d=oss.qualcomm.com header.i=@oss.qualcomm.com header.b="XntwuY2w" Received: from pps.filterd (m0279870.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.18.1.11/8.18.1.11) with ESMTP id 67IABUTd1021537 for ; Tue, 18 Aug 2026 11:50:30 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=qualcomm.com; h= cc:content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to; s=qcppdkim1; bh= YI75CANUnv9CmAm1KpPbTLntPhs3IAB736oHOTFVSXM=; b=GT94uP5FMkl9oeZI rlXPmEkRCl4JlIrWsRbNg0OzapVUz2UXRn+ypmBc1Xexy2O/E3mjbMBQbMQh31bb Fzy4Z4u0D8OJ5G7Jpx4FPvns4Dsopdyf1QfCuLsiltwL/fvCt3piLkqJYCcyfPCQ vm04ReWddmU+ZbgvCypei7xBG8suqMSDi0xuwbR8p4u/U45ksha1tKlBT4eSKDAq OekqW54jPiJa90IXObMuZPp9z3hLjK3fzjU/RX8mXJxz4fvj8IYQ6lTaP0Sk7etL o18WUaSpciHLAtRYpnDZcIX/10vbP3629iZKscetLQGO+SzJOInoYTVhy/7X1jBO +aLe6w== Received: from mail-qt1-f198.google.com (mail-qt1-f198.google.com [209.85.160.198]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 4g48q0uguw-1 (version=TLSv1.3 cipher=TLS_AES_128_GCM_SHA256 bits=128 verify=NOT) for ; Tue, 18 Aug 2026 11:50:29 +0000 (GMT) Received: by mail-qt1-f198.google.com with SMTP id d75a77b69052e-51c9e97b626so5562261cf.1 for ; Tue, 18 Aug 2026 04:50:29 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oss.qualcomm.com; s=google; t=1787053829; x=1787658629; darn=vger.kernel.org; h=content-transfer-encoding:content-type:in-reply-to:from :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:from:to:cc:subject:date:message-id:reply-to :content-type; bh=YI75CANUnv9CmAm1KpPbTLntPhs3IAB736oHOTFVSXM=; b=XntwuY2w4vKKH0dZUUoR0CrdHCUjMtA0LjpBpylq54cug+tROIbzP8duk/qx0pLg4S 5oCvYqr0sPyKzq2SDoFz4yzBJkz6WqbfUA7viJRBqIWI6anT1qlno8TvGP7zbfDAO6yz 5ayRvWF6Qo43986znC0+9wzXLZpwxYZjiVNYZ5IZVlSxNRjaLHdKVFO97AQkAS0DeFC3 CQAvizamADQIrrcuGkIqZohn1Zeb3G/KyBJ13hpoRvRi/GWRtgwW68+Ip3CBQyhl/TmU 35NvY5uAcpagW9x141PeU0KsWriuverpJxKynts0ChXhyeY1r6MLkLgahhNbDqJ9usqt pSsQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1787053829; x=1787658629; h=content-transfer-encoding:content-type:in-reply-to:from :content-language:references:cc:to:subject:user-agent:mime-version :date:message-id:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to:content-type; bh=YI75CANUnv9CmAm1KpPbTLntPhs3IAB736oHOTFVSXM=; b=HjQ0qlaO8bWaoBXM1lVJWBetwFHruM9dmv+K6Q+2rfNJFnWD+xylv5PCwRiHOL2EMj DxblarW/ZNfFDxeWIFTszGCwWKPUoVkRMOCE6Ddxu2vVNGjJ2FthgJnk00OO4lBXJUUe ETD9zz0Mw6ZGvblxqehQxk4qfSD15lGzV6lDqsdCBdnk3eFmr1PuMQW/ldw1/2RVhCaV vx4s3GoMijtZiaJKGmPgTBOrLuOja3xytSZL1OHPW4faZgX5mtf05Ygb3yXNvSU9hGG4 b4ZRuzvhHwAMFhjjeC7/sS3mkMJEgb/4Wm0INW9kdZ1xVienbdKcSVWAPjQq2bAC2FuH tkCA== X-Forwarded-Encrypted: i=1; AHgh+Rq0UEfwg6BXmcEQPvx6nFpkEu6tQfti3HWdS/TyNaz5CBOtYErkMETKLN3btV94x/mK9v75wWiBz409lNI=@vger.kernel.org X-Gm-Message-State: AOJu0Yyt/kneKhsQg/MhdSX4BJ4nXYObdiIGaD67kCZzLhCNC2KWpcz3 UN3/3iB4Lx/YXeg76HrxdNulzDewCsA8HWD7xt5xLZkyXco/HAqCai1QNB2e6SdUWRzGOsFKniV aGG0SpPHCRvokn91Jg3BKLC4cbY+5SS8AcCTZTiqK+k9HFyvyEttKeRh3tnQcToD1PVU= X-Gm-Gg: AR+sD10zpyngWOhgTd46/TTrRcNMc6cw/x6P9OKbHyDwN0fHTBNOVZP+VMwEGFNTlcJ eLVXNS1/ZzgrePxgKEZ0nkg5+C+yTVQCQYd/jA8dFbyPFwzQWLF+QnN+tBpzICrd+ibu3YtoqPu FRbTIhbK82uyf04JlSlObt5js01hXKjn2d6mqGFP38W5Pj1NDLxdhAHv+RXjIR4peguhEtGf8Jb j00yT1bL36tDKU0IbaER7bDB4hTJphvUzdCzuw/J6SH8fCFcksIeimK9zaEPTZnf4bzmvfrgVqP N0CG50fdXPJaK4TIttZwboJ5B5IF2h+mWzmFVo752ii4vot58/cOsUCAqvo9xSYlFN5dFbDJh3l r3jiCAU126m/iXL/A9nx1bT0T X-Received: by 2002:a05:622a:1787:b0:51b:f40b:2faf with SMTP id d75a77b69052e-52d854b8b9dmr256287761cf.4.1787053829373; Tue, 18 Aug 2026 04:50:29 -0700 (PDT) X-Received: by 2002:a05:622a:1787:b0:51b:f40b:2faf with SMTP id d75a77b69052e-52d854b8b9dmr256287351cf.4.1787053828985; Tue, 18 Aug 2026 04:50:28 -0700 (PDT) Received: from [192.168.120.193] ([178.235.128.140]) by smtp.gmail.com with ESMTPSA id a640c23a62f3a-c217fe7b86esm170051166b.1.2026.08.18.04.50.27 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Tue, 18 Aug 2026 04:50:28 -0700 (PDT) Message-ID: <286f9938-1cd7-4015-8971-1f6f4e23dbff@oss.qualcomm.com> Date: Tue, 18 Aug 2026 13:50:26 +0200 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH 1/3] soc: qcom: rpmh-internal: fix kernel-doc issues in rpmh-internal.h To: Maulik Shah , Bjorn Andersson , Konrad Dybcio Cc: linux-arm-msm@vger.kernel.org, linux-kernel@vger.kernel.org References: <20260802-b4b4-rpmh-kdoc-v1-0-0f5026293d9a@oss.qualcomm.com> <20260802-b4b4-rpmh-kdoc-v1-1-0f5026293d9a@oss.qualcomm.com> Content-Language: en-US From: Konrad Dybcio In-Reply-To: <20260802-b4b4-rpmh-kdoc-v1-1-0f5026293d9a@oss.qualcomm.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-Proofpoint-Spam-Info: AW1haW4tMjYwODE4MDA4NyBTYWx0ZWRfX+1krJC19pv0q a6fkMa+WW9oCfF2VQE4/+3EYd/xkH3OHlZg38IBEJ5Eiaectfo+0+WjdV9xYzsImphQmW0ookxZ sl0r69mxqlIMOdFAApP2DV1TJzYILuA= X-Authority-Analysis: v=2.4 cv=VuITxe2n c=1 sm=1 tr=0 ts=6a844705 cx=c_pps a=mPf7EqFMSY9/WdsSgAYMbA==:117 a=PRfkaYvzSr8QmIIGAkY2Sg==:17 a=IkcTkHD0fZMA:10 a=Sv0fKeRqtYgA:10 a=s4-Qcg_JpJYA:10 a=VkNPw1HP01LnGYTKEx00:22 a=u7WPNUs3qKkmUXheDGA7:22 a=gowsoOTTUOVcmtlkKump:22 a=EUspDBNiAAAA:8 a=JsEN5u44QsUbvw9GR8QA:9 a=QEXdDO2ut3YA:10 a=dawVfQjAaf238kedN5IG:22 X-Proofpoint-GUID: zasuOp9ucnH-mDcbGaun56Z4agRclpza X-Proofpoint-Spam-Details-Enc: AW1haW4tMjYwODE4MDA4NyBTYWx0ZWRfX+D9n/JzXd58L d8Cy2dP597nI/rYHZvCEm1cwt78NtIHFPFyTaNzn8AbGS4dg56YtW6QIsvqTgARCHvD1qaS37i5 JtCI0E3x2uWszo7qHFyo+vyEjmTt1LHoc7xnx53Fx16+H0Ha87xP6OssxaLlKwi3bZ2BltdPj2Z cuXhLEEPUV0y6sX2bD5Ub0W6ApD5cTsZGr1Bn+5DEIgtVM2SLWvR6OlkGFK+0kClsrMPWgWf80t wVvHfsbanndoeBzK/OfxgtVFLcXy51QgSYaJN+GQ2IGkp3m4QLj7SRA1rGFvBXxsgxQE1NCZ6Be pn8lo8NMN0brb5iEQH7rDvSZky8k3DX9JpCb2FNIfRjMop/C+g+2IcOy9d13lMMfKhuiHURRds5 sD5mAc0+nH1WxVYt6VF12vkLsl/rGZFa1fq848vZNNSeHHOjnY+aUYfJgLuvwYheRqVr6+ghwc3 cyPnKTbdUi+/xlolZxw== X-Proofpoint-ORIG-GUID: zasuOp9ucnH-mDcbGaun56Z4agRclpza X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.293,Aquarius:18.0.1176,Hydra:6.1.134,FMLib:17.12.100.49 definitions=2026-08-18_01,2026-08-12_01,2025-10-01_01 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 suspectscore=0 priorityscore=1501 clxscore=1015 spamscore=0 adultscore=0 impostorscore=0 lowpriorityscore=0 bulkscore=0 malwarescore=0 phishscore=0 classifier=typeunknown authscore=0 authtc= authcc= route=outbound adjust=0 reason=mlx scancount=1 engine=8.22.0-2606150000 definitions=main-2608180087 On 8/2/26 3:28 PM, Maulik Shah wrote: > kernel-doc emits two warnings for rpmh-internal.h: > > Warning: drivers/soc/qcom/rpmh-internal.h:136 struct member 'ver' not described in 'rsc_drv' > Warning: drivers/soc/qcom/rpmh-internal.h:136 struct member 'regs' not described in 'rsc_drv' > > Fix them by adding @ver and @regs entries to the struct rsc_drv > documentation. > > While at it, add a missing kernel-doc block for struct rsc_ver, and > update the remaining struct kernel-doc comments (struct tcs_group, > struct rpmh_request, struct rpmh_ctrlr, struct rsc_drv) to use the > 'struct name -' format documented in > Documentation/doc-guide/kernel-doc.rst. > > No functional impact. > > Assisted-by: Claude:claude-sonnet-5 > Signed-off-by: Maulik Shah > --- Reviewed-by: Konrad Dybcio Konrad