Received: by 2002:a05:7412:3290:b0:fa:6e18:a558 with SMTP id ev16csp735803rdb; Fri, 26 Jan 2024 09:06:06 -0800 (PST) X-Google-Smtp-Source: AGHT+IHvsWBoGcu/1vvDumpw4PL9nXX2N8YFE46heobBB0/aM7HnAB/CvpOOTz+Iz4/19UFuoS2K X-Received: by 2002:a17:90a:fb58:b0:291:2af:efa7 with SMTP id iq24-20020a17090afb5800b0029102afefa7mr136861pjb.90.1706288766660; Fri, 26 Jan 2024 09:06:06 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1706288766; cv=pass; d=google.com; s=arc-20160816; b=Yk8ZVIwZfOoKU5tO02MZyzqD8E3z7D2Ian5+rHj8GjAfi49FPqo7l2xkFUqmMXurWt hWNa6zP+D5Kcq0b8FQf4TTuqtQ/x6JD6Njd/WCjKv9asym9+HOqNhvwQgamwdeAaZVzE fNHIOSaJ1QDwSa9kWM0hvvMsn4FFeDh5yW7tfyBCLnE54FKd1EvBZGLnyEzeKWQ7dcJF MD/2brZoUJeh0nDwIh6XsaeVXD3dkAtH7KeGEHp5tK4+Rh2oWgK7Wbuc5Ffs2BJUTPpX Ruqrazd6ORjrZF5RE+eyz+jD0rncP5+6PIgTedjLT3BRFsZqTecZZIfanQMhWVBWe7Kr 4/YA== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:date:message-id:dkim-signature; bh=RdSQHsJ3t+MiU0FH+ji6aHzNmBTJjrA4QMAmImMSrt4=; fh=6j/jqSQuXm3l5Fs4Mtz/40tAOySkgynbt/ojjerVTyM=; b=rLkEaC0ynNjAmehc7iHFlwjNKQkz6ODpFIrgEQJoKxwy4IJgbyJBwI2Be6+znsarvE uhTZdEGQC57+aA9GFbce0xOz4DOeN8fadrKDQiefWZWhYP3AHVhyMJdl4jT/pbrn1IfZ zgD6a/KmwRLVf7vd0rdRlLPei6fnjkcQ/ScitjUP33Bdbscw6Sh4ljpbyCO9htC3VDJl NvT0ww2epwqsVfyfudQx56uCqLMwwwXv+icIy8FNnsBlD1Uxho/3qtCXfyoTgxK0jhcQ PfgI9Ijx3bXZ6bjtufZorfJ6V3I6t8+mPlsDxNvTLPNRdG5e/5WU/jFgukFF6nlxRIzV JrIw== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@quicinc.com header.s=qcppdkim1 header.b=I5aaFhk5; arc=pass (i=1 spf=pass spfdomain=quicinc.com dkim=pass dkdomain=quicinc.com dmarc=pass fromdomain=quicinc.com); spf=pass (google.com: domain of linux-wireless+bounces-2572-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-wireless+bounces-2572-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=quicinc.com Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [139.178.88.99]) by mx.google.com with ESMTPS id ik14-20020a17090b428e00b002905770297asi3341663pjb.190.2024.01.26.09.06.06 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 26 Jan 2024 09:06:06 -0800 (PST) Received-SPF: pass (google.com: domain of linux-wireless+bounces-2572-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=@quicinc.com header.s=qcppdkim1 header.b=I5aaFhk5; arc=pass (i=1 spf=pass spfdomain=quicinc.com dkim=pass dkdomain=quicinc.com dmarc=pass fromdomain=quicinc.com); spf=pass (google.com: domain of linux-wireless+bounces-2572-linux.lists.archive=gmail.com@vger.kernel.org designates 139.178.88.99 as permitted sender) smtp.mailfrom="linux-wireless+bounces-2572-linux.lists.archive=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=quicinc.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 5080F2843F6 for ; Fri, 26 Jan 2024 17:05:44 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 8ED621EB3D; Fri, 26 Jan 2024 17:05:37 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=quicinc.com header.i=@quicinc.com header.b="I5aaFhk5" X-Original-To: linux-wireless@vger.kernel.org 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 938141E87E; Fri, 26 Jan 2024 17:05:35 +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=1706288737; cv=none; b=nNoA4ypc/pzZ34LnRSKsydCl4JZ1v/P56TmrpidPoHnuWn3bTSxKz9/0VTwbXznVPWV+VKeNxIOrX07IjSSkRczl9Bac3nhtcR+aerrfkNqaafQ0rsM00Dtj6S7bqoniEwnAXLqX3ka4sodyNRbhrxZpwDsqkkmW62q+MqnOnIM= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1706288737; c=relaxed/simple; bh=xMkMfsrSpNWQZGAM70Gd7lQkYVBZgVzLEOPwbhwZxG4=; h=Message-ID:Date:MIME-Version:Subject:To:CC:References:From: In-Reply-To:Content-Type; b=YJW4k/m05GzbQ4pMvbyogtEz4mJpdTALihpkRc+7BRhACEIKMw5cSkFd6UuGBXCD6XfOAvuHmpWgESDlI0QKp86QWqnIjapQ0bMwlL4ujmvJ65yP++YADWDRnrh8htisocMF/NA8yKhtftRfN8i5B3I1qLP5GChRTW/4qNT93nE= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=quicinc.com; spf=pass smtp.mailfrom=quicinc.com; dkim=pass (2048-bit key) header.d=quicinc.com header.i=@quicinc.com header.b=I5aaFhk5; arc=none smtp.client-ip=205.220.180.131 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=quicinc.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=quicinc.com Received: from pps.filterd (m0279870.ppops.net [127.0.0.1]) by mx0a-0031df01.pphosted.com (8.17.1.24/8.17.1.24) with ESMTP id 40QFcBVJ024782; Fri, 26 Jan 2024 17:05:29 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=quicinc.com; h= message-id:date:mime-version:subject:to:cc:references:from :in-reply-to:content-type:content-transfer-encoding; s= qcppdkim1; bh=RdSQHsJ3t+MiU0FH+ji6aHzNmBTJjrA4QMAmImMSrt4=; b=I5 aaFhk5fKxO+TRBSRcEagEkcLrlOjcmaHPbn0Z7WvntBS5WT2x6ydoidz/MMQbO/o 29Sp7+3jgH+r6R2ZGuHHUi+m+eDt5ZEDs57a6hbi9a7Vq65roSBe6PtPjMuQPG+R HzLtOpxO1drIe6EE/FTkz6F4oGFRHW5GazBNGwJKibLooFueAfJQPeTseREND+1Y R+jLnqanbnk30pa091l+AEIHx8OhAfOqeaVO3/4hy997e+tXaqsDT7KhGF0s2OMp zG0TiIgkyvJvelsRSTk2XGbxwLowUuuURwQQlNiswm4tgQoVrmcHdDcBRsRHyvC3 TGTWLoGoaRbtItotkshg== Received: from nalasppmta04.qualcomm.com (Global_NAT1.qualcomm.com [129.46.96.20]) by mx0a-0031df01.pphosted.com (PPS) with ESMTPS id 3vuypkj7rq-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 26 Jan 2024 17:05:29 +0000 (GMT) Received: from nalasex01a.na.qualcomm.com (nalasex01a.na.qualcomm.com [10.47.209.196]) by NALASPPMTA04.qualcomm.com (8.17.1.5/8.17.1.5) with ESMTPS id 40QH5SZi022328 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Fri, 26 Jan 2024 17:05:28 GMT Received: from [10.110.0.209] (10.80.80.8) by nalasex01a.na.qualcomm.com (10.47.209.196) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.1118.40; Fri, 26 Jan 2024 09:05:27 -0800 Message-ID: <9c321dfc-f10d-4092-a1cd-30952e4da695@quicinc.com> Date: Fri, 26 Jan 2024 09:05:26 -0800 Precedence: bulk X-Mailing-List: linux-wireless@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH] wifi: ath11k: document HAL_RX_BUF_RBM_SW4_BM Content-Language: en-US To: Kalle Valo CC: , , 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> From: Jeff Johnson In-Reply-To: <87ttn0xc9y.fsf@kernel.org> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 7bit X-ClientProxiedBy: nasanex01a.na.qualcomm.com (10.52.223.231) To nalasex01a.na.qualcomm.com (10.47.209.196) X-QCInternal: smtphost X-Proofpoint-Virus-Version: vendor=nai engine=6200 definitions=5800 signatures=585085 X-Proofpoint-ORIG-GUID: gkv8LedZGgzdaSeIP6bj1Fbt-7xPr8kz X-Proofpoint-GUID: gkv8LedZGgzdaSeIP6bj1Fbt-7xPr8kz X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.272,Aquarius:18.0.1011,Hydra:6.0.619,FMLib:17.11.176.26 definitions=2024-01-25_14,2024-01-25_01,2023-05-22_02 X-Proofpoint-Spam-Details: rule=outbound_notspam policy=outbound score=0 mlxscore=0 lowpriorityscore=0 suspectscore=0 spamscore=0 malwarescore=0 priorityscore=1501 phishscore=0 adultscore=0 bulkscore=0 clxscore=1015 mlxlogscore=641 impostorscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.19.0-2401190000 definitions=main-2401260126 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. /jeff