From patchwork Wed Jan 17 01:09:49 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188707 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp753132dye; Tue, 16 Jan 2024 23:46:01 -0800 (PST) X-Google-Smtp-Source: AGHT+IFf9bzvUk0WBgfjyATMriChO4nMfqBcgZZG/Xs/Q8afZob9Xnkf6cPQSB6DCl7BI/bnx4cT X-Received: by 2002:a17:902:c949:b0:1d4:cc7a:ee46 with SMTP id i9-20020a170902c94900b001d4cc7aee46mr11673340pla.107.1705477561577; Tue, 16 Jan 2024 23:46:01 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705477561; cv=pass; d=google.com; s=arc-20160816; b=JhPQykPcD/hNea4Xs7apUdSpvGAvS/ogao/Cuaa9QcvvaCmbkPRNKU1zRoaJ/MbJKj NRl/V+jkoF50YAyZYOdqbn9aecQEevduJorTCnh7yA31t9/Jm4KpahpwrDR2ViT0Kv9r F44lOSHEVTznlSrnID06mENNbgYjjS8+l6QqqQcngMebS9/5B4GIApdZ9zEcapvs0Y2y MmN0BCeT1u3pEYjgfz7Yn+gfJ5TtVxL/lZji4tuqVJcA4LqcSTdaoIashTkZ4wzhbF9e idFRU+ZDtN2TIz5kFviLe05BvAV8wBC7al41+HQAIlfaKqQnuXu5q7IP87GgOB3BtaZO yuGA== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=GzmUU8PGwflALYNKPwqoYlVViTOygYuZAItzHQWuVIE=; fh=VMpzFrBK+ztgF/4qBQaxEHmgG0/DrXJzv8UTcU5x9W8=; b=YWdhbjqS0ZAp1mNP3/s4TeY0h0UIYHb6y1z3rz+8/8ZyeE0zM0/LKPzT79hheUvuho kLCWhAuDF5up3Dvmv9638JPO+oMZ3VhGZt1LUimZBfo+1YSNj6syCtmm2Ws5W8AyEF9L KN5GYzl0CYh3ovUtgYJEs5Mz5cDbaPcvtNTQnI1omxmla+aqJABlWnyGtQW0Mfv9KaG9 sukWVhZjrsZY8wHUGFoABAtVOG8yp6zW3FKpsMyi0CmpQFPBnoTY7RB8DTliUuZiue6k Li9cz7u3SAfPEZjB1k813zAmYEHk3eko6b1sQYm9vqjGKRaEOVA20Vgo5h65d0gkI7gu 542Q== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=skGViRzC; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28406-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28406-ouuuleilei=gmail.com@vger.kernel.org" Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id k10-20020a170902694a00b001d06d5f9533si12976140plt.619.2024.01.16.23.46.01 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 23:46:01 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28406-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=@infradead.org header.s=bombadil.20210309 header.b=skGViRzC; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28406-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28406-ouuuleilei=gmail.com@vger.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 sv.mirrors.kernel.org (Postfix) with ESMTPS id EFE7E28A1D7 for ; Wed, 17 Jan 2024 01:11:16 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 1E273B654; Wed, 17 Jan 2024 01:10:11 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="skGViRzC" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 7FF761364; Wed, 17 Jan 2024 01:10:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453808; cv=none; b=TI6c6S7vmxwPXwrr47u6K5BkedvLq2tHT9MtucWCETKLWib5C2IM7ooMASe1oJwsmR+7YehaLJbL/2DFod6DS+DiNd5Jg8AP5RdnM8+XZNz/0/rzMzP7fFncp4HKxxvYuzRRIgmiOHS7kHLT8295+v6b2wUME3xG2Y1Ykhwu34o= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453808; c=relaxed/simple; bh=GDGvBeEuZedQmmdqzrb0IUiOWtmnnqmYPR6IwXtu+sA=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=mYc7OZVmfkmOPs/9wTbs89kM0kosg3Oih1jdV/5W8RHgEcz9ewyvaqVzC5HcDDV2YAqXG4+/hcjO0/LnEl3y4raELfwAKdJVP57FBhL/bDXQVFIy0Q4wn7xo7rDnAHasP/rdX9reOdqBYuBaVZzWF6Y45g/jiqwX4f8NTEVBxd4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=skGViRzC; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=GzmUU8PGwflALYNKPwqoYlVViTOygYuZAItzHQWuVIE=; b=skGViRzCgYQcPm6bM40SdWTMuf mSmz7kkMhigWCGztA73qw4c1aGpGx7m2/r5C3XBbtJX2xywSJ4ORAhjybQvCcwYmhjThrV5yEEcHH hloChlU+LXEWBT41UwTIveT4MfHWYa3yPfs5P2bDQO4YQRpj5OVOncoW8TmTNFJAHb1Br0ZU83D83 O5t8iID1tmJCnkYLmmZpg8O6yNa9khNnNpy/9g4BfKr95FZtOV9zZ9V5LmOmiFxmmdccGXDk3A3qM xtMx3MR3HRosv1nYGfkGH3fQUoWYmn0GHgnT3JW90ERp2qMlA2kYzdVLc/msD47oILkh9BEHoXajv UDxxrS/A==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRR-00E6zu-2w; Wed, 17 Jan 2024 01:10:05 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 01/13] ARM: OMAP2+: am33xx-restart: fix function name in kernel-doc Date: Tue, 16 Jan 2024 17:09:49 -0800 Message-ID: <20240117011004.22669-2-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788322839664955077 X-GMAIL-MSGID: 1788322839664955077 Use the correct name in kernel-doc notation to prevent a kernel-doc warning: am33xx-restart.c:20: warning: expecting prototype for am3xx_restart(). Prototype was for am33xx_restart() instead Signed-off-by: Randy Dunlap Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/am33xx-restart.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm/mach-omap2/am33xx-restart.c b/arch/arm/mach-omap2/am33xx-restart.c --- a/arch/arm/mach-omap2/am33xx-restart.c +++ b/arch/arm/mach-omap2/am33xx-restart.c @@ -9,7 +9,7 @@ #include "prm.h" /** - * am3xx_restart - trigger a software restart of the SoC + * am33xx_restart - trigger a software restart of the SoC * @mode: the "reboot mode", see arch/arm/kernel/{setup,process}.c * @cmd: passed from the userspace program rebooting the system (if provided) * From patchwork Wed Jan 17 01:09:50 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188708 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp753177dye; Tue, 16 Jan 2024 23:46:06 -0800 (PST) X-Google-Smtp-Source: AGHT+IFmmYaV8EZscwR8n9mkTv7Fd8eMR7hPNjdhGMpNChrLCl10Mlk8RzqpX9SjWo0FpOIrQQez X-Received: by 2002:aa7:c24e:0:b0:559:ccc4:1a31 with SMTP id y14-20020aa7c24e000000b00559ccc41a31mr351809edo.60.1705477566717; Tue, 16 Jan 2024 23:46:06 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705477566; cv=pass; d=google.com; s=arc-20160816; b=Zg0m0lXx5z6B/UyLgJg6As23tba8R77OIr1HbSFjWIhm8ob9g48k+e4uE3e17UrzYb /DnYsZzJMG0GTVut1QhZYZUGfmIoRpbDO5PNjpRpQdmQr4AQyXoVmSw9Yy3TbzZY/o32 ZZDI54lchjHtSA1NUGW4qFXzfTw5SCLRunaMDAmdqCll49+57Ps7CRNeaTGngSpcTIYV g32DP0ZXidEgndsk0ZQi4czclAMJfWCHN7ZDfbkWjDe/skmfd+zMSSdTphs8pyMkUAyd N5S25+7VHxPds+ouir6qaefYTloMR3BbmhIbnG8XhNY46peZqwDtJE5GfvEqPb6JvAZf Trlg== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=d6sYWXOYku8urx0FvA1UhyCkVYzn1pxHKk2cTNothWk=; fh=eh9p85sUbcLNHVsquqM7JlNHei4DDQWdnGB3akrl0C0=; b=BdRTWPs7Ve12we4s7AvjG+e5H9gE+zGSd5l6jMAhZxgFbE/SC8Vzkr3d60Ll95cCxl E7l+BqcnOcYR79hG8m51HQnjLfYZeiWUSMGqmLxaPs7Xhpi4OVcZLloCTyf/ft7+LaKk lDzupe/qwZMDj5UcP2cyFfX383VGva4eCwsm334xLKHdQ9ZLVqM5SNS5VXOkezc3EYej qG4u8oYDUWq/xDVpClebZePnX/h1bEZfJX+FPTtLq9iZbefBnLOpL6sfTssbWZZEhbns W44bEypjSkwaqvTRWULYiQKW1NzYw/4Y1HqJvTHJkmZjnpRImUlaNTU3vnTSEjprWK4S Vhpw== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=rxFPPkkr; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28409-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28409-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id h20-20020a056402281400b005574ba7cd24si5641792ede.226.2024.01.16.23.46.06 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 23:46:06 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28409-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=rxFPPkkr; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28409-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28409-ouuuleilei=gmail.com@vger.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 am.mirrors.kernel.org (Postfix) with ESMTPS id 193091F273B2 for ; Wed, 17 Jan 2024 01:11:39 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id CFACCC139; Wed, 17 Jan 2024 01:10:11 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="rxFPPkkr" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 E4D73138C; Wed, 17 Jan 2024 01:10:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453808; cv=none; b=CU5xx+D3Ce4MbFohUlvIbkyXWfFxAM49X4E9OeOJUJTAZhpUq19E/STBvOYjSaffbiPbZsZ7tNCsHsI4BHxn9+uiW9cUofgFrn3XC2YqN7gQM4laBZfMm0hWZeXQd29NKeZ9ebJijC6rCNEl2egjiOkYcWNFMBCQiGLbAFrfuaM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453808; c=relaxed/simple; bh=E5a8W/JASgFproKCFJ7dwxpj2fi+/oDl2SPrdRL+xng=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=UL/EsnrHOnWEgvc19wqFh9hBgWyZJb/zyr8ghvnXrRX+8LSOMzmoqQTCpKOS0ovYJJrWZg0ihoBxQxXzJ9kT3LGdjFzKznUVcrWNKao0iFsj/E7+NeSayIWivSa+EphDJvhcDIiymB6zMcMi1xU2KjMk4GbagvyuzC5R3jwElaI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=rxFPPkkr; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=d6sYWXOYku8urx0FvA1UhyCkVYzn1pxHKk2cTNothWk=; b=rxFPPkkrHBZQYce8trpTyuZmRR gCU3ou2FNvI3CXyDn6/kEwLINTVlTok/HXZYFIIVILS+ldB5jpbW38nTYEdFAvHZuXtPkYy0fFluL Igp5fFw0qRNWE8jytnQD3jrbIKzocxvg0hE9X6OE2T5moYdinQ2sow6JYcFiQ8nc8KFCbbomrslxR zcGmkU5VsFUul6lst7oBJegDCLUyEl1E5ORNsQnwc4haStyIu4dzFdvGSKOT0h1KzLgHt4jwGUNji WFa+0HQcCoI0EpxbDL+qe4t8vcpw61Th5DTv0P/8P/3AKLNU2fNjO3z2Hpvtnj9WgxmDFZg8ZEZJ+ yeBi1oZw==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRS-00E6zu-0g; Wed, 17 Jan 2024 01:10:06 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Paul Walmsley , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 02/13] ARM: OMAP2+: clockdomain: fix kernel-doc warnings Date: Tue, 16 Jan 2024 17:09:50 -0800 Message-ID: <20240117011004.22669-3-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788322844760246940 X-GMAIL-MSGID: 1788322844760246940 Use the correct function name in a kernel-doc comment to prevent a kernel-doc warning. Use the correct function parameter name to prevent a kernel-doc warning. clockdomain.c:1003: warning: expecting prototype for clkdm_deny_idle(). Prototype was for clkdm_deny_idle_nolock() instead clockdomain.c:1125: warning: Excess function parameter 'clk' description in 'clkdm_clk_enable' Signed-off-by: Randy Dunlap Cc: Paul Walmsley Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/clockdomain.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff -- a/arch/arm/mach-omap2/clockdomain.c b/arch/arm/mach-omap2/clockdomain.c --- a/arch/arm/mach-omap2/clockdomain.c +++ b/arch/arm/mach-omap2/clockdomain.c @@ -990,7 +990,7 @@ void clkdm_allow_idle(struct clockdomain } /** - * clkdm_deny_idle - disable hwsup idle transitions for clkdm + * clkdm_deny_idle_nolock - disable hwsup idle transitions for clkdm * @clkdm: struct clockdomain * * * Prevent the hardware from automatically switching the clockdomain @@ -1110,7 +1110,7 @@ void clkdm_del_autodeps(struct clockdoma /** * clkdm_clk_enable - add an enabled downstream clock to this clkdm * @clkdm: struct clockdomain * - * @clk: struct clk * of the enabled downstream clock + * @unused: struct clk * of the enabled downstream clock * * Increment the usecount of the clockdomain @clkdm and ensure that it * is awake before @clk is enabled. Intended to be called by From patchwork Wed Jan 17 01:09:51 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188661 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp662588dye; Tue, 16 Jan 2024 19:00:33 -0800 (PST) X-Google-Smtp-Source: AGHT+IHkvAmowCvP6wNNNyf3GcsQg14s4Nev+wjcLzPuTfnJLsQKfMzxFa10SQSuWO9/WHIKydBx X-Received: by 2002:a05:6214:20c1:b0:681:2255:7392 with SMTP id 1-20020a05621420c100b0068122557392mr9979659qve.9.1705460432997; Tue, 16 Jan 2024 19:00:32 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705460432; cv=pass; d=google.com; s=arc-20160816; b=HuinavWSbfU97KJBk9RlM/nVXlfaC98o4TCRnb+/0PnXlyRfm557PsRDhTii+FuqRU rIPCyMgTCxxXs5CkS80WNxwY9yvHXaXKu7kIcoYwH361CV/pO1xmTqJWkvR/Ws05drrx O8CeH3aD/i7BM05EE9d5wojdlE8Sj8VzuErZmsKuWMXT5kOxQmAu1pvyhBtKX5dN/jHU 3DgrggSSwyyxNfGtjvW3UA3FPHiiuuGy60qIkWpQLFV/VOiktk7t9ibmGXyDHUw+AlEE 5dm6iDs6aorOHxtfEUUhROjrebMrOxjEfYKwaNpN8PYhkbXSmmj7eEJ5UWGBUvBLvdiT Zfyg== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=rcWb9ODcVk+PBPlVDZ/HAVR0kff6gEP/cAU5smz8ywA=; fh=VMpzFrBK+ztgF/4qBQaxEHmgG0/DrXJzv8UTcU5x9W8=; b=ocj8boSpAxwr1eUEVV+kjtAm9XMJ8DoWowWLpz+V/w/qXbGIPp7zMQEQ4iftYC+oGH RsU3+2QyWEWbzPPtowEU1TYsjW+JkatrhFhdEriUSS8CPJI+9n0iP2PIu7krWHMZZ/ns cw+aCEvRGEFRRLycyNEAj4h0WLyWJGwloNJfc6mTkEfb5K9KPhI8APNsdP52Ap8Dbr2c 97uVXbB0GmpJiP7XH8BqOdO4KcpOlzhpUzo8qxtm2a2opWIutFWE72YnkXoOE3N6W3i9 +BbT+7tStk02ZCGb1ZU7nq7Akx2SfkXITVCkQEnH7iDlQ7RNa+IMK4eUO6EQTtj0HuS8 PSOA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=zFi3WSi9; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28410-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28410-ouuuleilei=gmail.com@vger.kernel.org" Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [2604:1380:45d1:ec00::1]) by mx.google.com with ESMTPS id y9-20020a0c8ec9000000b0067efac3f6f5si11304260qvb.67.2024.01.16.19.00.32 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 19:00:32 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28410-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=zFi3WSi9; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28410-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28410-ouuuleilei=gmail.com@vger.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 025121C25536 for ; Wed, 17 Jan 2024 01:11:48 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 274B0D2FF; Wed, 17 Jan 2024 01:10:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="zFi3WSi9" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 029B3138E; Wed, 17 Jan 2024 01:10:06 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453809; cv=none; b=GokiWLXH5WFmalUiV7s0039wSz7OF6CMqokJ3oY5hzLxYVCT6wNoFzqVyzmkjK9Iiii5I/lMJn5yJp+0K4tF9JVA3HIXkifpSPaXhItPwjZgsBsxCMe1Q2oHZe5v+MKy+UR7Ej0a8lVHNoRMO7umjnpq0GHuPa8NqhK9siydq5Q= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453809; c=relaxed/simple; bh=aM8ocPmHg0OMLJEWtIxrWWZhPAw14wJ+RT4fBx1Haho=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=uZVdMK7JtTXuZHqtO6ZNcCtybP5a4c498LwvE1VaCzEvrYUT+BYzX111kSG+EIOIAsnRI1EY47yvIcOn6RIzAt92esHFp70oHgGt9t1GQ4FQOHQNziQLXHrgiLDtIPOVMsg+CWBFwNej+1404OY9D0ZUi16aJ9a88UQHYuR2ZrI= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=zFi3WSi9; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=rcWb9ODcVk+PBPlVDZ/HAVR0kff6gEP/cAU5smz8ywA=; b=zFi3WSi96ypWdkqc2v0GH5xW7F eZ/SaBqk+vsXK5QzVZhfENB+bbzBp7ZnUEXHr9Uc2UIA9umORYCJdj0mjZf75oxiLnSMLKMlVvjkr VcbPST2oFBfJM9JSG63i7Vy1zdeVDlBCUPumK/YXswWSYKXYpE/+uqc3YFNQCZI1Vft4XidnPLKhg /XXvCVKUC+iTEklTGnHWcSFdg2tOkHO7fCyRY9wYe9k6CTaxKRQPEFRLT/yAhmE9qkxmOTrf51E+/ 7JfRIUB5X69Gx6xInfh/EqjPdzpblHcMv9GSqifPDr8D/LgUHCOUWHFPwg2UBpM/vyBGJh9kWZfqs ge5aniGQ==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRS-00E6zu-1X; Wed, 17 Jan 2024 01:10:06 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 03/13] ARM: OMAP2+: clock: fix a function name in kernel-doc Date: Tue, 16 Jan 2024 17:09:51 -0800 Message-ID: <20240117011004.22669-4-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788304879336920546 X-GMAIL-MSGID: 1788304879336920546 Use the correct function name in a kernel-doc comment to prevent a kernel-doc warning: clkt2xxx_virt_prcm_set.c:173: warning: expecting prototype for omap2xxx_clkt_vps_check_bootloader_rate(). Prototype was for omap2xxx_clkt_vps_check_bootloader_rates() instead Signed-off-by: Randy Dunlap Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/clkt2xxx_virt_prcm_set.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm/mach-omap2/clkt2xxx_virt_prcm_set.c b/arch/arm/mach-omap2/clkt2xxx_virt_prcm_set.c --- a/arch/arm/mach-omap2/clkt2xxx_virt_prcm_set.c +++ b/arch/arm/mach-omap2/clkt2xxx_virt_prcm_set.c @@ -162,7 +162,7 @@ static int omap2_select_table_rate(struc } /** - * omap2xxx_clkt_vps_check_bootloader_rate - determine which of the rate + * omap2xxx_clkt_vps_check_bootloader_rates - determine which of the rate * table sets matches the current CORE DPLL hardware rate * * Check the MPU rate set by bootloader. Sets the 'curr_prcm_set' From patchwork Wed Jan 17 01:09:52 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188709 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp753192dye; Tue, 16 Jan 2024 23:46:08 -0800 (PST) X-Google-Smtp-Source: AGHT+IGZhbN+W/8516OUDw+sKC2KKPFYKvWio02UqXBRqPTirK6c8lnFHx15oIksrK6tdxOFjtrO X-Received: by 2002:aa7:d893:0:b0:559:b989:d3d3 with SMTP id u19-20020aa7d893000000b00559b989d3d3mr830276edq.54.1705477568301; Tue, 16 Jan 2024 23:46:08 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705477568; cv=pass; d=google.com; s=arc-20160816; b=RFMUhhYu9oK8WQnPJJrtDIR29T6I0Rd67qdmA0Vs6DS2NGMY4fReoMxUSsz7O0lE0X to6YWVb99bm+donCRwaC1bUPFTjD/5O9OtnyBP+dUzbouQszYdrFvPXp5tngDbrRFCVW kg6qdGX2dSKEYUepdckm/3+Q71IAMXh0li7W0ZtMEl6QS0opzbdZp2hTIS5H5Gsza5Sx aKq84JamHotIGcbn99XXf0Pq9u8TSGEgSSNesb7c6NRHwc9JXNvZekCZnbONVvJkXTen W4hIoBUAyiegdr9s1r4JeDhz/aNqDDfFU3bcLOMDjL62NkvL2gq3bMFoY38/04ZS60BX 3ZCA== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=XBmORscXXZHiW56NHRNnc5Yepc4GRt+FSu1EBqfjiI0=; fh=VMpzFrBK+ztgF/4qBQaxEHmgG0/DrXJzv8UTcU5x9W8=; b=Ji+B7WW5Q4htZ9V7AkC6HyLibJHK8NPzVuvs45kq0b1LA90x/WZZAJw+8gRePozCc1 tygXf0VIBhKWQ3FhU0pmCbp9RX1Lqqkw18VMVmjFvDufXNSqnjHN8QJ+5yFRJULqwgtS WSD4x69IuDUYeXHqWQmYn1UjEMAR7atu0Ry56IbCnmklBXPv8lqQv4X/X7AVeUN0Lp2c 0esjfiNcepJ4e2GUHofGxduPnx8emVySgGHhe2wrmvul5XhUcKqP8u050ATceIQoBoFF c7caHcpK2wL/nefiQcnz51EFAu2GLssdyk4zt8HZbUl15oT8zbXIlOKIpRkA1QZaJKTL q8fw== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b="PE/UNjSU"; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28408-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28408-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id es5-20020a056402380500b0055860105da8si5612824edb.54.2024.01.16.23.46.08 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 23:46:08 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28408-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b="PE/UNjSU"; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28408-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28408-ouuuleilei=gmail.com@vger.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 am.mirrors.kernel.org (Postfix) with ESMTPS id 0DC9F1F271D8 for ; Wed, 17 Jan 2024 01:11:34 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id A2937BE62; Wed, 17 Jan 2024 01:10:11 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="PE/UNjSU" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 519D915BF; Wed, 17 Jan 2024 01:10:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453808; cv=none; b=j9JGj7dCyH6ggmkfczQ6QkoWggSD79rytSBIkO+f7MZYHANLeSb8KpGm7draIVsGSe33N4GQzmSNPpnXlKzDWFDs1UfBleRZgrAlITxiiNhH37HE5VWIQjnIf877lJHvYRNaGO0bAdyUVkqBMrWKWM7lKZCa8oCBiiu/QAJ8/cQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453808; c=relaxed/simple; bh=bj1RQ/zuwjkWVOON+ntuZ6l/PDRcucLrnlepmOpz0fo=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=USwirSS7F8wVTpUL+DU6FnjRWcjRkkf2ANJfCEqoBRgtsJ4VFf53m4j1KqXJvAwe+5DIfGMZAS1I945MsrOX1oBaCFiauBhJr6PUZ+N5inoDsoMT5lr5WF7xbwRKuAtAXTFIotY4bRw+f2gGU1ikoBQ9MvnJ2a9UeiRdg6sFk24= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=PE/UNjSU; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=XBmORscXXZHiW56NHRNnc5Yepc4GRt+FSu1EBqfjiI0=; b=PE/UNjSUdImk5gKFwXtQ1Kgtar UJmcWG18mtE+xw+YxDpTozUguLwFIQea+UpLTrVPbjRCr03P+wHx1nYZx69jWLDMAoKlMVbmHfsYh ZqdXECVaUChG0wMaR9AiLZHk+jko7XBn5tVjUJ+AD+0XM5YyZ4QJZi19oBi3FV/7Z7u0jH9tpG1BK cMzN3z0h/YYSBBupAAKTG7AivxJsInI7LnyX4xN32S79dwdCNTUZsN4uMGA1kYBxig8BOhAXynwQN o9GJbEcCjFVA0DIE3Qj0yMqdTwfdlUGyaObzhbXMdYcmb8mGbtDIoZlCuiUQvt24biEHiaqzlqHbV cdM5/Ifg==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRS-00E6zu-2R; Wed, 17 Jan 2024 01:10:06 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 04/13] ARM: OMAP2+: cm33xx: use matching function name in kernel-doc Date: Tue, 16 Jan 2024 17:09:52 -0800 Message-ID: <20240117011004.22669-5-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788322846689165003 X-GMAIL-MSGID: 1788322846689165003 Prevent a kernel-doc warning by using the correct function name in the kernel-doc comment: cm33xx.c:366: warning: expecting prototype for am33xx_restore_save_context(). Prototype was for am33xx_clkdm_restore_context() instead Signed-off-by: Randy Dunlap Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/cm33xx.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm/mach-omap2/cm33xx.c b/arch/arm/mach-omap2/cm33xx.c --- a/arch/arm/mach-omap2/cm33xx.c +++ b/arch/arm/mach-omap2/cm33xx.c @@ -357,7 +357,7 @@ static int am33xx_clkdm_save_context(str } /** - * am33xx_restore_save_context - Restore the clockdomain transition context + * am33xx_clkdm_restore_context - Restore the clockdomain transition context * @clkdm: The clockdomain pointer whose context needs to be restored * * Restore the clockdomain transition context. From patchwork Wed Jan 17 01:09:53 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188689 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp724965dye; Tue, 16 Jan 2024 22:25:08 -0800 (PST) X-Google-Smtp-Source: AGHT+IHe7f92w4OGffytc3I7fHHLh+SocOWcq2wrSVvMJUQK+kpXjYAin6hA/50TghlUS1oJph4/ X-Received: by 2002:a05:620a:1035:b0:783:54e5:5456 with SMTP id a21-20020a05620a103500b0078354e55456mr6720185qkk.141.1705472708228; Tue, 16 Jan 2024 22:25:08 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705472708; cv=pass; d=google.com; s=arc-20160816; b=XEBOjAnujBcZdYK959sWClhLWGFBFeJKQj+E79dU4k+xS8W11jx4lFre7DNkDh3zZe beP1/ccrxEUW0iu5OjCRaprs5/jywI8i9GsSy3XO1VL3Of2aVuZwHuPk46UClI2A1grW idl1DoHhpadXuzndkMzY3FUDmeNnHg8urkxb8Gkr48TVWTB7864u/6oD/yCt/6duCYa7 nXPokqCklgtZPlkGRpZnE8X+rBsIFhS1DFtuy2lKhWx4R9OKRlZXo6rHXiobX54tPwxP vz/FTSDXxDTXAWYYK7L3Ay27u1qWmc81Cn7f+z0YMQ7v98ifpSGgd/q/8lsX3lNqfQ0T fFSQ== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=YqDqQhI9Tad8JS90rKrmaa82AwzcW8UAGZbm+qX2YYg=; fh=VMpzFrBK+ztgF/4qBQaxEHmgG0/DrXJzv8UTcU5x9W8=; b=GAWiDpn71N2zV/3hEkI1kgI9qLPcCPIHDHbfzw0x9L4V3QFD5FAhVMQhKS27+kvbYH UjOPICGvdPl0DA5TWQUWIljhoPDG6I3IvlwFRRtA5345WPzfFjyjD6pQvyd6ywuGrlhS cBQY/rARs3yZiCKVnEh8/XZznMGb0n89J3goVmt4GlPZKeZK317qNZRVlIw1VT2MgjPb ltWZosNde2m3Y1sTpnVeU4HTy/HGs3YwbZSs0Co6w4W5zKwzaWxkMRYY0sfhemrbnVeD F4b2ycThfM0SlZqVbwpkrh2ptHsbFNUxV0UK9Wd3TD+JCtyEkvXsnBJuzQingnqbSs/0 Mr4Q== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=jjZQJqeL; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28411-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28411-ouuuleilei=gmail.com@vger.kernel.org" Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id e18-20020ac85992000000b004239fe197a8si11071575qte.649.2024.01.16.22.25.08 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 22:25:08 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28411-ouuuleilei=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=@infradead.org header.s=bombadil.20210309 header.b=jjZQJqeL; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28411-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28411-ouuuleilei=gmail.com@vger.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 11A8C1C2557B for ; Wed, 17 Jan 2024 01:11:51 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 38328DDB2; Wed, 17 Jan 2024 01:10:12 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="jjZQJqeL" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 A644215B7; Wed, 17 Jan 2024 01:10:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453809; cv=none; b=o/cu+/W+TfH4KXICxirfEi2o4k6pEotywDA8xkNxRrn4FbcikYu+AOLslPx2jypmQpduEE8tCjYC3swy4KlfuLNh98wbzMPJ3OEIg+KkFB9o5mYUbXKofQHcakkl37gBgOtmUOoE5lX8dYZgq33ix6/7jiVMMpp3Arboie+kWy0= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453809; c=relaxed/simple; bh=TpY9YZBMiKLnHcXHU3L0fU+AEI3fIwR1kbbzoZ8IsGk=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=VOVj+rR4YAOw7KweUNVYLFIuE5vavvlPKbVsmrvgUcnZymGdfSTCgrP9AiQU1QVRHwWYE+vQMAtNi8DuVzoFvIkl8Zcvh6hBCNP7LG2YpNp1u2nslmfraaGPg7RHY8E67QYShRU2EfjRb0gDvFk3xDFk/HDHwcFSjuOV8TC+ARc= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=jjZQJqeL; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=YqDqQhI9Tad8JS90rKrmaa82AwzcW8UAGZbm+qX2YYg=; b=jjZQJqeLLU5KIm7iuhwNWUMoFZ nakExqXN44Zy8V8KZ8rsEiJ6HgVaahmmM2bjzZhjKSXYi+meoqiKvkeoiwOeqsvlsc3iXMxrV/k8+ qlfW0Sstf4IJZrSvTDBReP7XHpZ019qDtiSo9nledLSWCbXN0KO8xOdLzPmo/8thrdjYG3DRJuxj0 Hg1DBQVMSUKnXARbDIotMuKMv0N4vhFQZrVLK2O2xVw+KRLtK94bRa9WVeXqgxOTDGPxAy7H8MydE Mm2p+xDg4MW1VvsBDXKaGzrWS5YaaE9b/jN2vxnTW6uavKPuV219wQJI3F+ImL9b9yw9b+iNm4DVK xlDHonrQ==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRT-00E6zu-05; Wed, 17 Jan 2024 01:10:07 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 05/13] ARM: OMAP2+: CMINST: use matching function name in kernel-doc Date: Tue, 16 Jan 2024 17:09:53 -0800 Message-ID: <20240117011004.22669-6-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788317750460215389 X-GMAIL-MSGID: 1788317750460215389 Prevent a kernel-doc warning by using the correct function name in a kernel-doc comment: cminst44xx.c:249: warning: expecting prototype for omap4_cminst_clkdm_force_sleep(). Prototype was for omap4_cminst_clkdm_force_wakeup() instead Signed-off-by: Randy Dunlap Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/cminst44xx.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm/mach-omap2/cminst44xx.c b/arch/arm/mach-omap2/cminst44xx.c --- a/arch/arm/mach-omap2/cminst44xx.c +++ b/arch/arm/mach-omap2/cminst44xx.c @@ -237,7 +237,7 @@ static void omap4_cminst_clkdm_disable_h } /** - * omap4_cminst_clkdm_force_sleep - try to take a clockdomain out of idle + * omap4_cminst_clkdm_force_wakeup - try to take a clockdomain out of idle * @part: PRCM partition ID that the clockdomain registers exist in * @inst: CM instance register offset (*_INST macro) * @cdoffs: Clockdomain register offset (*_CDOFFS macro) From patchwork Wed Jan 17 01:09:54 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188655 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp650053dye; Tue, 16 Jan 2024 18:21:10 -0800 (PST) X-Google-Smtp-Source: AGHT+IHNj5h7kFEtxYPpl4r0oYkSFSvyBW+LuSWwv9ZYXqEH1VItiMPNqvfmmzumKz4wQslSDb02 X-Received: by 2002:a05:6358:89d:b0:175:e74f:99b5 with SMTP id m29-20020a056358089d00b00175e74f99b5mr4653583rwj.23.1705458070269; Tue, 16 Jan 2024 18:21:10 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705458070; cv=pass; d=google.com; s=arc-20160816; b=FCfXY5ThN5zdYRx8Trde9AbZHv/JqE/hh+cNEKwOaUtbOjYEW6xVmU+Xmja387jqP9 ekscmvcFgeqnRUi9lmWZWzrQv6vtSBWZbltgG81kVoM5T13kILFDa+2uuzcqvnTN/zJx qhR7YgotWk7HmGEiY807GjJhwIfmIc88oVJ+/KZTWthPFTAjYt9z7Q3zOHELmjAscM+P fvi1wt1nZkHm813OhZ/w1k8ie47RNZIO+Nk9C6X4d3f/eSgSMCYBBHYUoClvCsu09kLQ VjnyNFl/YNToErkcQiH4w5DS1iFvuKzqNlor9VTN8SvTeH1pz3xhgoOaspBEJM5YjUvf /7aA== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=mP7AFe9fYHUcfkMXVMCBmHBXRj17q4ZjJgE4XRNARXk=; fh=eh9p85sUbcLNHVsquqM7JlNHei4DDQWdnGB3akrl0C0=; b=VFAstElrSqi7mvyygAW5RbYtYMfWWSFcuDioY8ZtKOvywtZMVJEShCI3L3pwJNqgTQ Bw06xmS6ETwJKC+E8Dmo4dxlugQpJ+Y2A75MQVqvJkhlIv/59Vol+DAJWc9UC/fiODw4 tajVWyCBKC9uqAELN+19eU8y8edm8Cm4hYfhFYHgN0sgyNx/8rzUD0Lkif+w4icLSRXh sb8ka+5TKwmUh33+VMMoaX1okWaENRmrqdio04rckwh9hUcj7awPzbajJvKoNfkWcDP8 9DDmGXUlyh9X0MO33ikQSX2fPv+tds0X4UxZF7ZGTaG1qt+NFvsgJUBs1bR3ryL9yLYw nAXg== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=b9SUaRqh; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28413-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28413-ouuuleilei=gmail.com@vger.kernel.org" Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id y6-20020a17090a644600b0028cfb02353asi14871703pjm.169.2024.01.16.18.21.10 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 18:21:10 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28413-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=@infradead.org header.s=bombadil.20210309 header.b=b9SUaRqh; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28413-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28413-ouuuleilei=gmail.com@vger.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 sv.mirrors.kernel.org (Postfix) with ESMTPS id B27A428D7E8 for ; Wed, 17 Jan 2024 01:13:07 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 80A501427A; Wed, 17 Jan 2024 01:10:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="b9SUaRqh" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 0A5E615CC; Wed, 17 Jan 2024 01:10:07 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453810; cv=none; b=XQ3HNXPaMw91M8ahb1m8uDMnXWyo/uQzH33bLOpXkYtOGDGwztnwbdvLt/hI25VirUbbn6Idm97GxYPSghNEnvoRhfs8MsznXrNNOgiMcI1Xzlrdy83dW14aCWvkUxMSimdWVkeUu4i4cJeUj8WsZTEQVuVzvXOpoXOw0bCcmqM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453810; c=relaxed/simple; bh=RO/Vlr9xwSjT6tqMGGLx8pIF3PiU93RnbeniABzIT60=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=QNw7E/qclDc+qB02X3euUK5YSzRgRdrkBCHds9eQvkAhAwJQaN/96dOdyC8tFD+qRr4VR69+J/331AzYcavGet64ao5hbMlgGbTuj6/MPIL6PLiFw8Nx2iOMiZk0EbUPvCDbrqmlXJOjDZVhWzULDkqfwsA5MBXai2fdK+bhCi4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=b9SUaRqh; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=mP7AFe9fYHUcfkMXVMCBmHBXRj17q4ZjJgE4XRNARXk=; b=b9SUaRqhAvufEAhmS3H9EOr2N3 cz7L2R5Zrk0hUJsFd6TJgMJsmbOr5U1s+E2v1MFNAS3c1V8lHq7TiiKFub4LOWJ0KoEsStDcuP5uZ xQCuQ4RiKx75qRMXM6YQuZf9ssRbelogASCKZ4tQYHSttbNwdMhp1RKhh3ZW6ztzms3g21yPjsLck X/U0CHhV7prBFGvEVifsCpt54canTFyBbjVrv1btTNQBpjLLLJ7wLl/1/aVVaIGmjAgW3twCAc762 z04EAAFG190phwDDTg0TV7cxqrrz2sviVpzzRZFmg6ngTz6sQkz2MKL0KBkzHrbTyjdXuLjLmUzJL UCvMblvA==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRT-00E6zu-16; Wed, 17 Jan 2024 01:10:07 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Paul Walmsley , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 06/13] ARM: OMAP2+: hwmod: remove misuse of kernel-doc Date: Tue, 16 Jan 2024 17:09:54 -0800 Message-ID: <20240117011004.22669-7-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788302401735160686 X-GMAIL-MSGID: 1788302401735160686 kernel-doc does not support documenting data definitions, so change the "/**" comments to common "/*" comments to avoid kernel-doc warnings: omap_hwmod_common_data.c:37: error: Cannot parse struct or union! omap_hwmod_common_data.c:51: error: Cannot parse struct or union! omap_hwmod_common_data.c:60: error: Cannot parse struct or union! Signed-off-by: Randy Dunlap Cc: Paul Walmsley Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/omap_hwmod_common_data.c | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff -- a/arch/arm/mach-omap2/omap_hwmod_common_data.c b/arch/arm/mach-omap2/omap_hwmod_common_data.c --- a/arch/arm/mach-omap2/omap_hwmod_common_data.c +++ b/arch/arm/mach-omap2/omap_hwmod_common_data.c @@ -20,7 +20,7 @@ #include "omap_hwmod_common_data.h" -/** +/* * struct omap_hwmod_sysc_type1 - TYPE1 sysconfig scheme. * * To be used by hwmod structure to specify the sysconfig offsets @@ -36,7 +36,7 @@ struct sysc_regbits omap_hwmod_sysc_type .autoidle_shift = SYSC_TYPE1_AUTOIDLE_SHIFT, }; -/** +/* * struct omap_hwmod_sysc_type2 - TYPE2 sysconfig scheme. * * To be used by hwmod structure to specify the sysconfig offsets if the @@ -50,7 +50,7 @@ struct sysc_regbits omap_hwmod_sysc_type .dmadisable_shift = SYSC_TYPE2_DMADISABLE_SHIFT, }; -/** +/* * struct omap_hwmod_sysc_type3 - TYPE3 sysconfig scheme. * Used by some IPs on AM33xx */ From patchwork Wed Jan 17 01:09:55 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188703 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp740488dye; Tue, 16 Jan 2024 23:11:13 -0800 (PST) X-Google-Smtp-Source: AGHT+IEVe87/K6CvZNdohyLnRHMMciLOdvaKqNYclQ7W+wQTkmd5s6enh9SpT+vc1JzCSRxGaKA+ X-Received: by 2002:a17:903:2448:b0:1d5:f667:1096 with SMTP id l8-20020a170903244800b001d5f6671096mr1361116pls.132.1705475473318; Tue, 16 Jan 2024 23:11:13 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705475473; cv=pass; d=google.com; s=arc-20160816; b=HelaAnucZVfzbhbeVEuxrPa0D1hj1F3gdRpAT6K7FDNsRFdwa4OnE8T547DKDg01c9 HsPtt5eT7XpcoWB3tdZkOBz1IhVzT4BjfEyNwZRH1ZK5KgAZwFUvMXIPFilG8BICkJcF rAFKqk+8/PnZ3siwUsBZ5BoKjnMKYPA1JyHIZWlRgQ75rCQsV+iMzwHWw/dpXC4/cEFR 3I/4Kk0cre3Bmt5J/mlMP5LrDW6ArhC129w4Lg5IgUWv8OEbiIjaEXIo9+mMFIsw2F7S VT2FDiEwexfqqWubTS84MuYT4ptCKy2ClA3EcR64avFiX1uG1T5Zvj/VY8PDIGa1fpnj r62A== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=sGF6uJaEvsCufyOMbTpUXxplWqfaxnjoJpE5oP5VF1w=; fh=EkFzbbH7x3TrSf0a2ZWa3ygtU95ytMsAkXWOlImnaec=; b=CMZsMfW3B9qa+aN/k6UwEY3O2g6Dt0tasKW6Erg/mO74IgbrgHkFJ+kTnS220xSvAI TO37vzpwn+oHl33whtY7fKbe4rfy9xfKGybRLTAMjj30hBlunMvyoHdL5DtJKHKRCxd8 rNXwRx1Qfy0y6bmJyEFWwkzE0+5PnYptz0ZhWsVAxPKQKaO2tiRDjMiFGmGnyY9NgPVR 4si9SLecXL4T8OduI8n2KX/0KFfQ2nd3QvNpz5T9EgIN3f6z1ilxsT7u490M6sWjqyii PYXysQ5eAgA0vfnb1zDHko0AABk2A37ea0oYq66m2Z1su3sQ73tZw7xNoXcd1qwq7JJr eOSw== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=a0Z2lvui; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28412-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28412-ouuuleilei=gmail.com@vger.kernel.org" Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id l10-20020a170902f68a00b001d005527017si14059549plg.313.2024.01.16.23.11.13 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 23:11:13 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28412-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=@infradead.org header.s=bombadil.20210309 header.b=a0Z2lvui; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28412-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28412-ouuuleilei=gmail.com@vger.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 sv.mirrors.kernel.org (Postfix) with ESMTPS id 1BD6A28D8FD for ; Wed, 17 Jan 2024 01:13:09 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 9006B14282; Wed, 17 Jan 2024 01:10:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="a0Z2lvui" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 41F7F17D9; Wed, 17 Jan 2024 01:10:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453809; cv=none; b=O8KsZhPzw69oVqzzWhJ5Dn0oRYwYs12iARQ6o6FFlSKUSc0JSHA54I6WKMMJP0Gz7mdtVx6oLILyuxLPQanNovBy5ouimp0xzMVksn85SajZi/ik7j4tad8/S7GEuvGaJy0xfC6F6NF6KPhJyv5Sv1LWxauQX6cywYLgKbkzFmQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453809; c=relaxed/simple; bh=j6+RY7q13Y+Hd0Y8k8ykBta7KjT/Cne7jir5J+hsisM=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version:Content-Type: Content-Transfer-Encoding; b=tkzPFCaj+JAHIlC+wRCJgxWnCdAtJqP0HCBphn+UII25JZPKe88OmVSHEH04lC2HBeLehAhB/8pxd0bz5CON/hdWvi4ZXa8i3X0/R7G+cqkILL6h4kK4pEtp3RqGC/sIgMCVGUh60JtNKIP8BoKEtKfUWJjD3JngZ4yDAe5hNfw= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=a0Z2lvui; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: Content-Type:MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc: To:From:Sender:Reply-To:Content-ID:Content-Description; bh=sGF6uJaEvsCufyOMbTpUXxplWqfaxnjoJpE5oP5VF1w=; b=a0Z2lvuiJXK7spdORx6yo8UPiY S6VfPLuqkrMN1Rmy13cKrcTA9DQzC1NzIR0UCgmxeBtvg04Bw4MDskW4H5ehtawyqAWki0S4gk357 eGBfayq7HlV+RdUjQLa+uPqpi3lGP/r4dG9ASjuNUC1COkKNFD9SWP2TFNO4DpUfiJC3jieNojyA/ 1TQy4S2RfrhwEACzbiuoyESQf4Habeh2SVi8uXxVvZvam441loTEbTNEtKtx5nnkijVXQOkcVwVuD zvXOVqKfeJAN57bGmg4Ag+ZSIXGGWe+h5Ms73zTTge0Rq0MUvk+cQ2ToEGfZ22h7pAraFqV5JKGPg JVkVIdxg==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRT-00E6zu-28; Wed, 17 Jan 2024 01:10:07 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Paul Walmsley , =?utf-8?q?Beno=C3=AEt_Cousson?= , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 07/13] ARM: OMAP2+: hwmod: fix kernel-doc warnings Date: Tue, 16 Jan 2024 17:09:55 -0800 Message-ID: <20240117011004.22669-8-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788320649484789734 X-GMAIL-MSGID: 1788320649484789734 Use the correct function name in a kernel-doc comment. Use the correct function parameter names in kernel-doc comments. These changes prevent the following warnings: omap_hwmod.c:910: warning: expecting prototype for _init_opt_clk(). Prototype was for _init_opt_clks() instead omap_hwmod.c:2311: warning: Excess function parameter 'n' description in '_init' omap_hwmod.c:2510: warning: Excess function parameter 'n' description in '_setup' omap_hwmod.c:3387: warning: Excess function parameter 'clockdomain' description in 'omap_hwmod_allocate_module' Signed-off-by: Randy Dunlap Cc: Paul Walmsley Cc: "Benoît Cousson" Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/omap_hwmod.c | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff -- a/arch/arm/mach-omap2/omap_hwmod.c b/arch/arm/mach-omap2/omap_hwmod.c --- a/arch/arm/mach-omap2/omap_hwmod.c +++ b/arch/arm/mach-omap2/omap_hwmod.c @@ -900,7 +900,7 @@ static int _init_interface_clks(struct o } /** - * _init_opt_clk - get a struct clk * for the hwmod's optional clocks + * _init_opt_clks - get a struct clk * for the hwmod's optional clocks * @oh: struct omap_hwmod * * * Called from _init_clocks(). Populates the @oh omap_hwmod_opt_clk @@ -2297,7 +2297,7 @@ static void __init parse_module_flags(st /** * _init - initialize internal data for the hwmod @oh * @oh: struct omap_hwmod * - * @n: (unused) + * @data: (unused) * * Look up the clocks and the address space used by the MPU to access * registers belonging to the hwmod @oh. @oh must already be @@ -2493,7 +2493,7 @@ static void _setup_postsetup(struct omap /** * _setup - prepare IP block hardware for use * @oh: struct omap_hwmod * - * @n: (unused, pass NULL) + * @data: (unused, pass NULL) * * Configure the IP block represented by @oh. This may include * enabling the IP block, resetting it, and placing it into a @@ -3367,8 +3367,9 @@ static int omap_hwmod_check_module(struc * omap_hwmod_allocate_module - allocate new module * @dev: struct device * @oh: module + * @data: module data * @sysc_fields: sysc register bits - * @clockdomain: clockdomain + * @clkdm: clockdomain * @rev_offs: revision register offset * @sysc_offs: sysconfig register offset * @syss_offs: sysstatus register offset From patchwork Wed Jan 17 01:09:56 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188679 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp695442dye; Tue, 16 Jan 2024 20:50:09 -0800 (PST) X-Google-Smtp-Source: AGHT+IGhSHngpYd/pouxt5i7dvvHW4KobKnAWMLPA8+UZDpVOH8cviOFZyWr9btsoQqUE52EtQjT X-Received: by 2002:ac8:5fd4:0:b0:429:ccad:5fa7 with SMTP id k20-20020ac85fd4000000b00429ccad5fa7mr9489292qta.123.1705467009239; Tue, 16 Jan 2024 20:50:09 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705467009; cv=pass; d=google.com; s=arc-20160816; b=cecWPXEQxnSEBH5JrnhmGwmcFA8dwUx3y6VeeObrV18BT7H9Cq52naitmrHm5rb+Zx iFBBeaDO7CYGaHUHtn6bxM/7PhhVS9K6KLXP03bn3Up84uAF3bv3bnLWnA25YH2aGPfY hm2JiKlWVKo5BMrLOh+XBK/iWo7bcNMV04bcpnPi1MFmQHW6rojsaDy7bBUZUZRzxoza TZc2c6mCQNxCFtYp0Ugi5sytrqA5c/f6yG0O04G+tzu7vBbrt+56arnJQWk0JfoTDeBm thaAsKkjU6PB8EdUk8mMu7e/B4Nrn8UGuesC055tnRf+J7/B8epYPhI67W1Kthcn9QX3 nEbQ== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=qa6fUxPXUaqPN0YIg7RJSfQQy70I4nGp8qxnNLTyklk=; fh=GTELXRHv4e7BxTfQxEX26rABTx57lfRdUExsFh1sXVs=; b=AcpOUr9U+BOEGnHVnTQIbOo2y4fJsPLm4178kT6fggIKkVqf0zAqXJNImgEmoPr21Z 401BG/fMnfhOoPwj1Otc0zWcfTBilfRvnyYPTw7krsIaQ3arigBCEOL8B9ScnURhdE0e 7DIvaOmxJ/Gh9r7zbr1Abv5EvdaNnv8JOnoPn7cwTtFYfyQn+1mB6dqAqBotJ+j3d1mn duigZ7nvwgtLJy/7T2fPz5pzDn8qdYqjXf9vUPqMkB9hvRHl4r+GQT8TZxSNzsrXE7wQ vtNpQ9j2U9Sp8sQfM1GyvkY09w5iIXI3WJsleEsXbWy422T9JwckzMjh2LZZXJ8yCNqX m7Eg== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b="MRT/NlWw"; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28414-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28414-ouuuleilei=gmail.com@vger.kernel.org" Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id a3-20020ac85b83000000b00429fc86605asi3539740qta.645.2024.01.16.20.50.09 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 20:50:09 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28414-ouuuleilei=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=@infradead.org header.s=bombadil.20210309 header.b="MRT/NlWw"; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28414-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28414-ouuuleilei=gmail.com@vger.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 A8F841C2606A for ; Wed, 17 Jan 2024 01:13:31 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 480EB14AA8; Wed, 17 Jan 2024 01:10:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="MRT/NlWw" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 AF1D529A9; Wed, 17 Jan 2024 01:10:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453810; cv=none; b=Vp8aJBGEbbVXWjxRfYGd64n1TMRypoUHmteJ/MYqQ2nmCUIhPZT0a+AmTusfp64FIZYx44U+HeXdCyY8GQeMtgK3ebGV8e5oUdsmsVSllG41pjGvZP9TZKMKKnYT1/tgW1u0JumJqyaxbIzJjHOYBQAYTIYSD9kRjCCWvIF05vk= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453810; c=relaxed/simple; bh=ao3j/PHziICip5QY+H3PmQcaFdiysra4OxcF9jLCvXo=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=BbyoxJprsaMcq84v8q4t1YM1IRPlAjPlH0doUlqC4tt4kqzK1HCKuN8FK0Xwg1e25flxIjIieeerMJFtUlKwR+bffqPOJJ/JRuV9JzDQg8aKPUHlXqD3ynxD8MqNTZp1ZAmroHYgCRXmtA5wjSulks+xoMTf4poGwjwp76rLrYM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=MRT/NlWw; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=qa6fUxPXUaqPN0YIg7RJSfQQy70I4nGp8qxnNLTyklk=; b=MRT/NlWw839YjjEOkVyFtrW6pG y3TCu+C5AUZIuVLvjgzYiPRN2+11+lTWCVOOoIifeRv+TXsl7xpkVXcgHUZC3ly+7SL8KSBl5TanR MwjENsXt8UBWWQA6psLC0O6SrFhSutx8lq4nu3MJpBmPX/Soxhqi//grPo04cvL4ZjDvNmnV8jZml YIVA8hbSL8bFa8skEDijL8EAPKcQwGNY11rq2kjdfTNhVpWXAazhUYUdllHpVwnf3dSlMO/TVtKe1 LyZb/RCKwlOndgcTSfpe6uKbIiXSvCSfKEcBOZ71D4z0HvcOG3f/3P+OBD+z+wwu24H5kavc98/VC KcpdYklA==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRT-00E6zu-36; Wed, 17 Jan 2024 01:10:08 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Kevin Hilman , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 08/13] ARM: OMAP2+: pmic-cpcap: fix kernel-doc warnings Date: Tue, 16 Jan 2024 17:09:56 -0800 Message-ID: <20240117011004.22669-9-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788311774690670281 X-GMAIL-MSGID: 1788311774690670281 Use the correct function names in kernel-doc comments. Use "Return[s]:" kernel-doc notation for function return values. These changes prevent the following warnings: pmic-cpcap.c:28: warning: expecting prototype for omap_cpcap_vsel_to_vdc(). Prototype was for omap_cpcap_vsel_to_uv() instead pmic-cpcap.c:92: warning: expecting prototype for omap_max8952_vsel_to_vdc(). Prototype was for omap_max8952_vsel_to_uv() instead pmic-cpcap.c:139: warning: expecting prototype for omap_fan5355_vsel_to_vdc(). Prototype was for omap_fan535503_vsel_to_uv() instead pmic-cpcap.c:154: warning: expecting prototype for omap_fan535508_vsel_to_vdc(). Prototype was for omap_fan535508_vsel_to_uv() instead pmic-cpcap.c:28: warning: No description found for return value of 'omap_cpcap_vsel_to_uv' pmic-cpcap.c:42: warning: No description found for return value of 'omap_cpcap_uv_to_vsel' pmic-cpcap.c:92: warning: No description found for return value of 'omap_max8952_vsel_to_uv' pmic-cpcap.c:106: warning: No description found for return value of 'omap_max8952_uv_to_vsel' pmic-cpcap.c:139: warning: No description found for return value of 'omap_fan535503_vsel_to_uv' pmic-cpcap.c:154: warning: No description found for return value of 'omap_fan535508_vsel_to_uv' pmic-cpcap.c:172: warning: No description found for return value of 'omap_fan535503_uv_to_vsel' pmic-cpcap.c:191: warning: No description found for return value of 'omap_fan535508_uv_to_vsel' Signed-off-by: Randy Dunlap Cc: Kevin Hilman Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/pmic-cpcap.c | 24 ++++++++++++------------ 1 file changed, 12 insertions(+), 12 deletions(-) diff -- a/arch/arm/mach-omap2/pmic-cpcap.c b/arch/arm/mach-omap2/pmic-cpcap.c --- a/arch/arm/mach-omap2/pmic-cpcap.c +++ b/arch/arm/mach-omap2/pmic-cpcap.c @@ -18,10 +18,10 @@ #include "vc.h" /** - * omap_cpcap_vsel_to_vdc - convert CPCAP VSEL value to microvolts DC + * omap_cpcap_vsel_to_uv - convert CPCAP VSEL value to microvolts DC * @vsel: CPCAP VSEL value to convert * - * Returns the microvolts DC that the CPCAP PMIC should generate when + * Returns: the microvolts DC that the CPCAP PMIC should generate when * programmed with @vsel. */ static unsigned long omap_cpcap_vsel_to_uv(unsigned char vsel) @@ -35,7 +35,7 @@ static unsigned long omap_cpcap_vsel_to_ * omap_cpcap_uv_to_vsel - convert microvolts DC to CPCAP VSEL value * @uv: microvolts DC to convert * - * Returns the VSEL value necessary for the CPCAP PMIC to + * Returns: the VSEL value necessary for the CPCAP PMIC to * generate an output voltage equal to or greater than @uv microvolts DC. */ static unsigned char omap_cpcap_uv_to_vsel(unsigned long uv) @@ -82,10 +82,10 @@ static struct omap_voltdm_pmic omap_cpca }; /** - * omap_max8952_vsel_to_vdc - convert MAX8952 VSEL value to microvolts DC + * omap_max8952_vsel_to_uv - convert MAX8952 VSEL value to microvolts DC * @vsel: MAX8952 VSEL value to convert * - * Returns the microvolts DC that the MAX8952 Regulator should generate when + * Returns: the microvolts DC that the MAX8952 Regulator should generate when * programmed with @vsel. */ static unsigned long omap_max8952_vsel_to_uv(unsigned char vsel) @@ -99,7 +99,7 @@ static unsigned long omap_max8952_vsel_t * omap_max8952_uv_to_vsel - convert microvolts DC to MAX8952 VSEL value * @uv: microvolts DC to convert * - * Returns the VSEL value necessary for the MAX8952 Regulator to + * Returns: the VSEL value necessary for the MAX8952 Regulator to * generate an output voltage equal to or greater than @uv microvolts DC. */ static unsigned char omap_max8952_uv_to_vsel(unsigned long uv) @@ -129,10 +129,10 @@ static struct omap_voltdm_pmic omap443x_ }; /** - * omap_fan5355_vsel_to_vdc - convert FAN535503 VSEL value to microvolts DC + * omap_fan535503_vsel_to_uv - convert FAN535503 VSEL value to microvolts DC * @vsel: FAN535503 VSEL value to convert * - * Returns the microvolts DC that the FAN535503 Regulator should generate when + * Returns: the microvolts DC that the FAN535503 Regulator should generate when * programmed with @vsel. */ static unsigned long omap_fan535503_vsel_to_uv(unsigned char vsel) @@ -144,10 +144,10 @@ static unsigned long omap_fan535503_vsel } /** - * omap_fan535508_vsel_to_vdc - convert FAN535508 VSEL value to microvolts DC + * omap_fan535508_vsel_to_uv - convert FAN535508 VSEL value to microvolts DC * @vsel: FAN535508 VSEL value to convert * - * Returns the microvolts DC that the FAN535508 Regulator should generate when + * Returns: the microvolts DC that the FAN535508 Regulator should generate when * programmed with @vsel. */ static unsigned long omap_fan535508_vsel_to_uv(unsigned char vsel) @@ -165,7 +165,7 @@ static unsigned long omap_fan535508_vsel * omap_fan535503_uv_to_vsel - convert microvolts DC to FAN535503 VSEL value * @uv: microvolts DC to convert * - * Returns the VSEL value necessary for the MAX8952 Regulator to + * Returns: the VSEL value necessary for the MAX8952 Regulator to * generate an output voltage equal to or greater than @uv microvolts DC. */ static unsigned char omap_fan535503_uv_to_vsel(unsigned long uv) @@ -184,7 +184,7 @@ static unsigned char omap_fan535503_uv_t * omap_fan535508_uv_to_vsel - convert microvolts DC to FAN535508 VSEL value * @uv: microvolts DC to convert * - * Returns the VSEL value necessary for the MAX8952 Regulator to + * Returns: the VSEL value necessary for the MAX8952 Regulator to * generate an output voltage equal to or greater than @uv microvolts DC. */ static unsigned char omap_fan535508_uv_to_vsel(unsigned long uv) From patchwork Wed Jan 17 01:09:57 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188680 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp695667dye; Tue, 16 Jan 2024 20:51:09 -0800 (PST) X-Google-Smtp-Source: AGHT+IGRUPwI19si0tKlBoU/aSXhqV8K6FT5wtWQLb9wpRI8svkv28Jxcm/wTZKKLhlHyygJHpj3 X-Received: by 2002:a2e:3a12:0:b0:2cd:fea:65bd with SMTP id h18-20020a2e3a12000000b002cd0fea65bdmr3814573lja.28.1705467069634; Tue, 16 Jan 2024 20:51:09 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705467069; cv=pass; d=google.com; s=arc-20160816; b=U8ySzzUAc8CBHsAH0m5Qavw9v+v24imCQb61fWCkvGO5kW7vkQKZTgILhNGWJPEYZr m+vZ2da4bXXDVvIi8fx2/tD4/GGDSmts3+X5qQFiszJAnHAPcBa8Ig08jvzZ6YIooEIf /Fba1/f9rHBJBOl5OFusnjkZuHI8RdlRNuGeundHB48dITr/ui/6xCzStM7sBfaXBiQc pwfLptYo5u5ukn6pVpv0j0YSVjY9DjYw3mlrPyIBfscQKkxvwVN1p5UcPY946fb6Mcf+ cTXeY6hq2ijFLvyu11HD1V5qimL1cZ8/6kvPmfLAixX0cifjQHPypRHvEKGaNihIE4Vt Ybaw== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=D/gE019ZmSvllJYQDA3FYN3rYxglmvvmTrq1Zs40Zjg=; fh=eh9p85sUbcLNHVsquqM7JlNHei4DDQWdnGB3akrl0C0=; b=zPeOZFf2du2MmebJyqBtylFWZaVpmW32G9ufIMq9KW+csydCp2+DFMDqb64eKk6pVo lF1kZNfJBxRm9Tic9xwsprRN+6hLy/cxVnp8bKtGAxku4X0W+mVf3YabdpJrx6CVGC2s fgBwnngsQV6gjD7KurBmC7r6DnulrlNb07t5h2oPzFaRp6smH27zs/fYGqVzPu4ZB3Tg fKYV1miYmcXxVI0/fNm1SW+ljpVGBWwxonkHo++YP/qjzDtIHtYkh+ndzbMfoyflkUH/ FRGX+8f02gHElxsMm4qVo+7k2zjJd1k5rgMoOhi344ni31zHvUF12kX+yAvLU7kU9imr FoOA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Ub7fms35; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28415-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28415-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id v21-20020a509555000000b00558548dfc63si5731607eda.436.2024.01.16.20.51.09 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 20:51:09 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28415-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=Ub7fms35; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28415-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28415-ouuuleilei=gmail.com@vger.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 am.mirrors.kernel.org (Postfix) with ESMTPS id 8C51E1F284C1 for ; Wed, 17 Jan 2024 01:13:07 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 80AE81427E; Wed, 17 Jan 2024 01:10:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="Ub7fms35" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 E1F464439; Wed, 17 Jan 2024 01:10:08 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453810; cv=none; b=Oz4z4KgDA3Ul96S4C6j6tIPPJuZRhdGbo+w3QfTZk1DMRUK87mUrfeAmmdU0P3CDCoB41MHPBuoD2iOqVhg945faaZLjvuN7zaJxh7jhCQzeIPCqbSmR6XnitBFt5Q6dcKyqPklKfSzb0/DOOxsO6KZmOFk/iSGsJ3VkHWgFRac= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453810; c=relaxed/simple; bh=BL5aX056bFvjCHUcg1YEdagctUIsMeId5BQPF5YJ4yk=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=inGGmQQkFqo9dI8L+TWk1EyHXDlsnd4YkNGWr5rxnjs34yVtmc1SsQwTBGWCLAQuezlmh+8+B9IIohvmiilSqfmHRi3iALn/LMsmdKy7MMa2YOpyc28Lr3izui8doGXyOcJ4+xiVN1ahlMmrh9HmjSvJ4dsAUtTXY0rNtKfez1M= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=Ub7fms35; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=D/gE019ZmSvllJYQDA3FYN3rYxglmvvmTrq1Zs40Zjg=; b=Ub7fms35Rr/W6I8goOAVJ/n37j 93C1RMl31TxjlgXAzSRAoUug9b1v+9mpr93BhuQBPb5XZ+aEQQ3eSj8epa1n0d/lJt5aiy+DwIHgY olICA6Z3j9WCx/36EY48o+bMg85VkHC7xnwNLrFaDRLaxDQbT+rf4PzzBK5cvtdT0F1m6+SzmFREt lui6vzNfq8FC/3xrMbJhFUgG3SISwCtEtGl5yJI9H14+iZRu6c9SCWwRXqiESh3LJ7KDWrBJOV2Nr sWKOsXCL1DQro1d+2jsVKfjFg3i1o4tylfEqH0LyJJ6eCKKTQfmPeGzbobPbLEHgDpPgzitt/rrW7 ahNq5Q7Q==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRU-00E6zu-0o; Wed, 17 Jan 2024 01:10:08 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Paul Walmsley , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 09/13] ARM: OMAP2+: prm44xx: fix a kernel-doc warning Date: Tue, 16 Jan 2024 17:09:57 -0800 Message-ID: <20240117011004.22669-10-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788311838299133071 X-GMAIL-MSGID: 1788311838299133071 Use the correct function name in a kernel-doc comment to prevent a warning: prm44xx.c:421: warning: expecting prototype for omap44xx_prm_clear_context_lost_flags_old(). Prototype was for omap44xx_prm_clear_context_loss_flags_old() instead Signed-off-by: Randy Dunlap Cc: Paul Walmsley Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/prm44xx.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm/mach-omap2/prm44xx.c b/arch/arm/mach-omap2/prm44xx.c --- a/arch/arm/mach-omap2/prm44xx.c +++ b/arch/arm/mach-omap2/prm44xx.c @@ -407,7 +407,7 @@ static bool omap44xx_prm_was_any_context } /** - * omap44xx_prm_clear_context_lost_flags_old - clear context loss flags + * omap44xx_prm_clear_context_loss_flags_old - clear context loss flags * @part: PRM partition ID (e.g., OMAP4430_PRM_PARTITION) * @inst: PRM instance offset (e.g., OMAP4430_PRM_MPU_INST) * @idx: CONTEXT register offset From patchwork Wed Jan 17 01:09:58 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188681 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp695684dye; Tue, 16 Jan 2024 20:51:13 -0800 (PST) X-Google-Smtp-Source: AGHT+IHsowbArd11U3gG9uudj1sFAy4HtXBhoGFZ1l9xFXJlfxtpjyHgVVrO/PGc20ZaRo4kXpvN X-Received: by 2002:a17:906:28cf:b0:a26:6e89:d94c with SMTP id p15-20020a17090628cf00b00a266e89d94cmr3892711ejd.152.1705467073516; Tue, 16 Jan 2024 20:51:13 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705467073; cv=pass; d=google.com; s=arc-20160816; b=WP+bct5FFBPCtqYBPf0sbQ7VOFUJkjNQSZ+NyWL/qtMMw73AmpjAShmVBjo+Gpnf6o aJ07tGzNRDclv04/EYtgEC5pHEIHiSn+bXjwGEkeky/shuYqR1uboFesbdi+nv2dyfJm N7FhGBUppZjixIeYDZDeTAt+m6ad7wEVec0X0ZTNIA13syTuiegLMIRFNnHwTpoOjMrR o7/gaPkgjz2x913PvyCtq4RgINYO2X/dyB91UOE38g3lJwwdqFLVMoO5WPoy9mVY8x0/ rJuOCvMSIAm7xtumc4jH/uoclJoZgqBvj5Gp0+feg8d/mWnxoKIomzEKmvz3eTwoBZQw 6eiQ== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=ZuLCJOP9Ph+ZIWn7AJcTrgpLCTTV7YzBdRszbkNK8Qk=; fh=eh9p85sUbcLNHVsquqM7JlNHei4DDQWdnGB3akrl0C0=; b=CnibFf5ks1+jnp6BYQNbFM1Gc+kNt4732n6mlXjqmwYNCm5v191v1moHuMr5ddWFmg XVpBUBe4R9BoTPyVbU13cq40QI2JnNctjMMDEo+8Sg8jcJt9+oL6pdzTPU7CaAzQl75n VSMZRIr6Hr3wpfNfRrX8HS88CgJTbd9/EjJHAAuuPC21AeuABnaBU15b6Ah892vtcDm1 O+aRdThgYJlbpEwt4CJyVxldXSAOULbXJ6DcJedl7U3lsdBe3EwuiH2jek1iPEdlJbuo FKcCNBhBhjsSv0jxbNt3u9fOwKAkhqGa3VE77vae3YBYpnRpm+kGqo3rGPhv/lNgtz2o JY+A== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b="bHwc24/N"; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28419-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28419-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [147.75.80.249]) by mx.google.com with ESMTPS id f5-20020a170906048500b00a2d224dd5f1si3535672eja.417.2024.01.16.20.51.13 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 20:51:13 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28419-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) client-ip=147.75.80.249; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b="bHwc24/N"; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28419-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.80.249 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28419-ouuuleilei=gmail.com@vger.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 am.mirrors.kernel.org (Postfix) with ESMTPS id B608D1F289C6 for ; Wed, 17 Jan 2024 01:13:30 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 3D92114AA5; Wed, 17 Jan 2024 01:10:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="bHwc24/N" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 1A8FE522E; Wed, 17 Jan 2024 01:10:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453812; cv=none; b=FAJKB/CHo93fCp4zAvgnkf6e4IXleoTfFa1OTQ4ar8QXenHYUwyfgTA0irhIifWSN6Fj5AVl7U8G+ymA16t2+WXtHrCQ1m+uAZ0cQIA+7k1Pgl/v/uMxv0bRMejxn8kf8f8YvyU9/X4yGrwuLdTTkYTY2K2/fSn7dE9G74EDXSU= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453812; c=relaxed/simple; bh=CSqPH5+UdLpUNxxzaocE3enGj5LEBrTl6eFIglSfw7s=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=YlbrPtzi5/b1neBmQUNLe0nIW9Hwx0HlM5i0MjncN9ntypiqJqF8ERmOdZs4qXYxJYP2DsNIxnqxQJ6w7K5Ergk6pdbppx6yyDQo3wUDhTeG6gzsMjRCd38YY2gRovtlupNxyBuJZhb5mgu+X0fMVGpJilB7tLsGQ69i4p7Phr4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=bHwc24/N; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=ZuLCJOP9Ph+ZIWn7AJcTrgpLCTTV7YzBdRszbkNK8Qk=; b=bHwc24/NIpoVG22MZ7F+PZ5q/S jeD4DKPA82VAaU6o9lylfychFfL5oJoIL1suzKbi8K1T/Qb9VfnVuf8vtdk4G5JZ60aOsojOH1HpQ FXu8BjZLQPVJIkmdFTety0SCkztgRv3ulobRogUvjCI4QShUGr3JdbUpGMKyMVxrwF9cCuunaN6vU vFKJoSmBZmIinxYaJa1MMMJc4r+gB2kMT+sbEmgHN68YJ6dQ6JIglfsFVM9dfR0BB4fThxpElFjhl C4zLlJQlhW4ezwwkAlYT3Pl904IGsLJU9N0KGt+Q2rNXEpnCudrVoMTBrN26A5nzictdPMz3IjcdG p7ItG3KA==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRU-00E6zu-1r; Wed, 17 Jan 2024 01:10:08 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Paul Walmsley , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 10/13] ARM: OMAP2+: PRM: fix kernel-doc warnings Date: Tue, 16 Jan 2024 17:09:58 -0800 Message-ID: <20240117011004.22669-11-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788311841927105082 X-GMAIL-MSGID: 1788311841927105082 Use the correct function name in a kernel-doc comment. Add function parameter descriptions in 2 places. These changes prevent the following warnings: prm_common.c:384: warning: expecting prototype for prm_clear_context_lost_flags_old(). Prototype was for prm_clear_context_loss_flags_old() instead prm_common.c:505: warning: Function parameter or struct member 'vp_id' not described in 'omap_prm_vp_check_txdone' prm_common.c:522: warning: Function parameter or struct member 'vp_id' not described in 'omap_prm_vp_clear_txdone' Signed-off-by: Randy Dunlap Cc: Paul Walmsley Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/prm_common.c | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff -- a/arch/arm/mach-omap2/prm_common.c b/arch/arm/mach-omap2/prm_common.c --- a/arch/arm/mach-omap2/prm_common.c +++ b/arch/arm/mach-omap2/prm_common.c @@ -370,7 +370,7 @@ bool prm_was_any_context_lost_old(u8 par } /** - * prm_clear_context_lost_flags_old - clear context loss flags (old API) + * prm_clear_context_loss_flags_old - clear context loss flags (old API) * @part: PRM partition ID (e.g., OMAP4430_PRM_PARTITION) * @inst: PRM instance offset (e.g., OMAP4430_PRM_MPU_INST) * @idx: CONTEXT register offset @@ -497,6 +497,7 @@ int omap_prm_clear_mod_irqs(s16 module, /** * omap_prm_vp_check_txdone - check voltage processor TX done status + * @vp_id: unique VP instance ID * * Checks if voltage processor transmission has been completed. * Returns non-zero if a transmission has completed, 0 otherwise. @@ -514,6 +515,7 @@ u32 omap_prm_vp_check_txdone(u8 vp_id) /** * omap_prm_vp_clear_txdone - clears voltage processor TX done status + * @vp_id: unique VP instance ID * * Clears the status bit for completed voltage processor transmission * returned by prm_vp_check_txdone. From patchwork Wed Jan 17 01:09:59 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188686 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp716719dye; Tue, 16 Jan 2024 22:01:10 -0800 (PST) X-Google-Smtp-Source: AGHT+IGN1R47Ed4QMPG39UA4a613yGVmpxS/KA1YsLUGkb83Si945BS5IluGfvqt6s8he8LNMpZs X-Received: by 2002:a2e:9c09:0:b0:2cc:dc54:871e with SMTP id s9-20020a2e9c09000000b002ccdc54871emr3975639lji.24.1705471270025; Tue, 16 Jan 2024 22:01:10 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705471269; cv=pass; d=google.com; s=arc-20160816; b=pdEcaur3V/wej/bllDFdpxD4lx54I/WjmRV0xfrz+eHxvAHJTUO0QYdpq6P+QweIuw 8gWYn5jT85vI09Y4lpIGM1Cphl91tiXAc6atiYaUYvCmvMH3kHqdCVrK+QqNAN1/Jyfe Du+5k8uX62XAqFQQ/ETfxGwle02o+chtRzxIpomivvQM/ZZJGeDzesC1wVoE/3Z6RsgL EfcR0nEizUF7lFcTXLbOXMuMa9eaOeV0jZxmbmN55+siuyLhzRuUw6+dLiec98j5rYP0 nwo8WvMaF1I76gB8EYx878wPTdK3fJeUjbD91r+EFmqzIIP32otRdGT4qEth101nCrwD YMFw== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=NgQzwLw26rL6c+tJaDaxoF79yF00tNswbdO97Qj1Pt4=; fh=VMpzFrBK+ztgF/4qBQaxEHmgG0/DrXJzv8UTcU5x9W8=; b=k971HLw5rzRo+flfJZJYXG8oQqBdi/Z40wiZZ93pJBZ1OHiFiBeOqqLWMFuUDqgVz6 UFdUz2Omgkff8bsmrejAXKyCbluI6ZJ99ByD2LuqY914WdSly84Adbqqcbphw7fzilf5 Xkx7xTe0xsMzyFMOfEIqKplvFwariXqfOHdYRawyY92gtm/0fPdjpCuNO0VqWcHBK3N3 26hBC0cPSchAmvZWzOrBtNPeJNmFzUuJp6c2oKTruyGEp/AtrBSy1gwoqc5lgxrK9r51 O0xD7XitaEA14UxHyx1/o3pUdHe6qxo/ujJ3F+zUsnuNwi1/AVQS52COUQnjsPSue9n1 STgA== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=gj+eFygw; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28417-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28417-ouuuleilei=gmail.com@vger.kernel.org" Received: from am.mirrors.kernel.org (am.mirrors.kernel.org. [2604:1380:4601:e00::3]) by mx.google.com with ESMTPS id ef8-20020a05640228c800b005596858e078si2136668edb.543.2024.01.16.22.01.09 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 22:01:09 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28417-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) client-ip=2604:1380:4601:e00::3; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=gj+eFygw; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28417-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:4601:e00::3 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28417-ouuuleilei=gmail.com@vger.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 am.mirrors.kernel.org (Postfix) with ESMTPS id 723DB1F2881A for ; Wed, 17 Jan 2024 01:13:26 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 0FF8414A93; Wed, 17 Jan 2024 01:10:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="gj+eFygw" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 9BBC579CC; Wed, 17 Jan 2024 01:10:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453811; cv=none; b=Z9LPnZwLxNyx2vIaAYfz7yA1UAdg3fdn0BroVP5Lk19H0l/tpP4k5r2ZYfabgj4sgDwZw+68Ykwx1jUMfvhkcnpK/TatEXjZLkhdCtcBC6RQd0NZ+HsIAuRkr0TYYwDiAOkrQIWscFWAdD0PqBQhwyA+2jGWLnhrPj5aaFJ+9CE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453811; c=relaxed/simple; bh=AyE3iZ0YIgSHRY471OTeVM9lvSe3brGHPKOEZ8HuzDQ=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=UwxdH2ak/PQ0W3NaKDGj+aGSAwAUGwqx1u+vlWjOakdJLSeBS2DwWDBTRqDNjTqsMpAtsXWOJkF+6XdB7RcdWEjqUQ1DHkiPeAoRyNgj2gZ0cU45RWmfo3p1N0DV+s9LRkMFA0DgEZsG7yzt/EOg0YF8UwOTdMJnm2EfPgCLo6Q= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=gj+eFygw; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=NgQzwLw26rL6c+tJaDaxoF79yF00tNswbdO97Qj1Pt4=; b=gj+eFygwxAJfFS8oVWkEF4mV4+ POxdvSkYyFjG/UQCXwN+mA1qDum/9TFHBgg/o0vKyPfIY+0IXK48UYijCRN0CaOH3LlWaUmQb+Cle jDf7IoM0dkcbO5WqVgP2LB+uvSie83SP0M4jCR/i0SCCGDwQXnSlVvy6BZ8A0bGv1FMPVlfulbBAD D9XAw+KzZ3pIr/I0k/MvEOijLUAJk8cHWuvKFtoIbo1JsJYG/qrdF0w96J0D1MGF/flXTIzpuCEAO 4wZW4inv0x8t+K9bQHhlRz2lkOiqDgnmQg1TKWtIa5U9zsS2FQHq00Ju94dfoZNh6M9lgsrpMrpBO HDo2JWGg==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRU-00E6zu-2g; Wed, 17 Jan 2024 01:10:08 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 11/13] ARM: OMAP2+: fix a kernel-doc warning Date: Tue, 16 Jan 2024 17:09:59 -0800 Message-ID: <20240117011004.22669-12-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788316242494486468 X-GMAIL-MSGID: 1788316242494486468 Use the correct function name in a kernel-doc comment to prevent a warning: powerdomain.c:1171: warning: expecting prototype for pwrdm_save_context(). Prototype was for pwrdm_restore_context() instead Signed-off-by: Randy Dunlap Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/powerdomain.c | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff -- a/arch/arm/mach-omap2/powerdomain.c b/arch/arm/mach-omap2/powerdomain.c --- a/arch/arm/mach-omap2/powerdomain.c +++ b/arch/arm/mach-omap2/powerdomain.c @@ -1162,7 +1162,7 @@ static int pwrdm_save_context(struct pow } /** - * pwrdm_save_context - restore powerdomain registers + * pwrdm_restore_context - restore powerdomain registers * * Restore powerdomain control registers after a suspend or resume * event. From patchwork Wed Jan 17 01:10:00 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188656 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp650093dye; Tue, 16 Jan 2024 18:21:17 -0800 (PST) X-Google-Smtp-Source: AGHT+IGT8Jsc0kMMdvAuBDu5bmYdRVj2nbY6Ky1WoEBMjQb4QKW4xcp9teiEkxr42FGQ5B+qRjmS X-Received: by 2002:a17:90a:9c05:b0:28d:5def:7b07 with SMTP id h5-20020a17090a9c0500b0028d5def7b07mr194660pjp.32.1705458077546; Tue, 16 Jan 2024 18:21:17 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705458077; cv=pass; d=google.com; s=arc-20160816; b=hGnVF5sPaRZQumqfUgpUflCk6Yaj/r9IsFDfxuuw8GN5jCm/pSAO1OHmZhn6CGGPaz PDaemG5iyVllD8R8tnOjZCW+h/oso4NrqFKySPn9WTmXVEQGxB7qUncpS9Lz1OEnSGdj 2iYI9kgvUorv+5GODT5yc9gJeyJGXNUudQlI33KWXvWG5LTlu5oabRYGsWi0IG40WVT0 6XR8dOOP0e5jszI6rIhNBP9r28DZedlOXzyxSZm2hRjeVs8/v7eNb3VlNgNyGguhVEUR JsGupAkaKk583iyVAXQuXrN1Jj1uBwxMI0rGOxXd551yl4T6NW3d/jkJ3qil4AiEoPb2 rRYw== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=ClK/v0rLso9Z/3FXbTXuYzr4YDDul4TOjSdON3U06CE=; fh=VMpzFrBK+ztgF/4qBQaxEHmgG0/DrXJzv8UTcU5x9W8=; b=Sd2tUvf+rO9Wtc7kL/YH3pn4+ggs6Fs+FGSsNhHk4iZm09aTBesYJ0kGouxk1aZUiG UbaioFcr696P2PRvTSxDpxQZX1/2SBPxU/YQIgNmw7ukHJYard/wNyrvaKa/ZIocSaEP vgiGJQ5AxZetnfdSUT1yj5fqP9j3dzlzJkBjfLB48cZE6zsG8qyz3ny0iEnQk1LNoM5z 0R78N2r3TceIn1NHZl5auDspZ3yoq2mLyaHv59AWNhHrFCnd8NpW4IgWe0hvBBRmpgYw j6wRSsCIaP7CMPzo/vmUyPT5tB4Zbgcxz14h0H52SM+qudEvlX3wVcCGkbGcGG7FFG6Y GuuQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=qyE3IUnN; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28416-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28416-ouuuleilei=gmail.com@vger.kernel.org" Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id n9-20020a17090a9f0900b0028e79313924si2601008pjp.127.2024.01.16.18.21.17 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 18:21:17 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28416-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=@infradead.org header.s=bombadil.20210309 header.b=qyE3IUnN; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28416-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28416-ouuuleilei=gmail.com@vger.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 sv.mirrors.kernel.org (Postfix) with ESMTPS id B5ADD28DB8A for ; Wed, 17 Jan 2024 01:13:24 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 0FF4614A91; Wed, 17 Jan 2024 01:10:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="qyE3IUnN" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 D8703881F; Wed, 17 Jan 2024 01:10:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453811; cv=none; b=S4vv+dnZEtziUTxTCK+0bvqngYvL29LScwaWRVPdyaSBwk1Zonry5vbpm28+0eSHsfg9DJ8ywuzm889PKpBLdmImdEFMUbw5BDTWYOBW3Y+BuG+u3wRXIPEzmt8fMkEeqyeHeexpt/teuPnmWx1FJBYD+x1vgQl7fiunuUZ3yBo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453811; c=relaxed/simple; bh=pVMRQNIGeDoYkpfl9T3yFunV82OMlyMJoPN+08Vl4W8=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=Zkm3onX51+pjAGk0mjn6e8ftaOv2NxqRkF6RY3FzncS0JiAokkjb+r/eoI7KvsVJNQGBZyGoiKx+VPabS4BEfGljUM7FGggVDqJy/SiDFp8DcNMJJiugIQa89DpQvDsMqVc7LdAEZx1ib0rIrwZ+d5SBsw8I2adt059JNYwUWEE= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=qyE3IUnN; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=ClK/v0rLso9Z/3FXbTXuYzr4YDDul4TOjSdON3U06CE=; b=qyE3IUnNbpQg8QAafCaeH3WBy1 9fovh5jIgam0eMRhJ5/Hr5kJc7EgFDjXzY2o6yhAxzMpyKRtPQvFshWXZlGe+seDy/Tm9Q8NnMjTF qbsYo4T5FFxNW7w4axUhZAZx0T6+duHkxkJHnb8ODMsflkj9gXE6PDx17kr/twLNz6n8d/V9J2nIX uVyJOEHLarqkMtR85tzKBRAEdx8Li0kPxDTzaF+E3xc/BJA9M5/ZcCL76NpzgUDLNjULdbvsXRKsL 6PgENL3b9sYthOEFr+fqaFb4pgJhK3Z5G/71OPsbAaJ39eS+SAmLFtoMCBklt1f5KDCvBUCAk2vPk K3Dos1jw==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRV-00E6zu-0M; Wed, 17 Jan 2024 01:10:09 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 12/13] ARM: OMAP2+: fix kernel-doc warnings Date: Tue, 16 Jan 2024 17:10:00 -0800 Message-ID: <20240117011004.22669-13-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788302409213082259 X-GMAIL-MSGID: 1788302409213082259 Use the correct function name in a comment. Use the correct function parameter name in a comment. These changes prevent the following kernel-doc warnings: omap-secure.c:61: warning: expecting prototype for omap_sec_dispatcher(). Prototype was for omap_secure_dispatcher() instead omap-secure.c:191: warning: Excess function parameter 'clr_bits' description in 'rx51_secure_update_aux_cr' Signed-off-by: Randy Dunlap Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/omap-secure.c | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff -- a/arch/arm/mach-omap2/omap-secure.c b/arch/arm/mach-omap2/omap-secure.c --- a/arch/arm/mach-omap2/omap-secure.c +++ b/arch/arm/mach-omap2/omap-secure.c @@ -47,7 +47,7 @@ static void __init omap_optee_init_check } /** - * omap_sec_dispatcher: Routine to dispatch low power secure + * omap_secure_dispatcher - Routine to dispatch low power secure * service routines * @idx: The HAL API index * @flag: The flag indicating criticality of operation @@ -183,7 +183,7 @@ static u32 rx51_secure_dispatcher(u32 id /** * rx51_secure_update_aux_cr: Routine to modify the contents of Auxiliary Control Register * @set_bits: bits to set in ACR - * @clr_bits: bits to clear in ACR + * @clear_bits: bits to clear in ACR * * Return the non-zero error value on failure. */ From patchwork Wed Jan 17 01:10:01 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Randy Dunlap X-Patchwork-Id: 188673 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:7300:42cf:b0:101:a8e8:374 with SMTP id q15csp674779dye; Tue, 16 Jan 2024 19:40:14 -0800 (PST) X-Google-Smtp-Source: AGHT+IHfcqapJDx5xGkxTcU8zZHqYtDq7YhHJhcC27Fw10Oz6OJ83b9YTXA51OB5x5EckP67n6NI X-Received: by 2002:a05:6214:2aa1:b0:681:1322:5f with SMTP id js1-20020a0562142aa100b006811322005fmr235441qvb.58.1705462814191; Tue, 16 Jan 2024 19:40:14 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1705462814; cv=pass; d=google.com; s=arc-20160816; b=wI53Wzn4OaDv6y7yCQD7mnyxCt8onry5ClEyxP6u2tXR2bNLSgZcw58vvK+mqDMvOs 0Ck9iG6Iwo9L0Vu/c9oHIrHSf03ppzQp49G8cBylKfDDvbt4Le61zAeVEPGSh3L6iiTF /iBx11wvGD8xy0F722P0wN2ShtWtWJb+yK/2EIxagX5dNXc6mwl/KpZjU9autB7+ulma DPC4VczVxdlI4V8QYaEyM9ZLaE3n1P7hKor29+HUrWXdEb12aPLWuD0J/kO1tLPtyYlp buArGVHTopUlVoQZpYi4azjwp4fkx5NPqtHUYVK6R9swP0w/To4ySU8KLTMhnaH+dAib kWAg== 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:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=Rfa69KGhRV06omS8OU11mtmpPZ9dpOihzp/ZOk6Xf+g=; fh=VMpzFrBK+ztgF/4qBQaxEHmgG0/DrXJzv8UTcU5x9W8=; b=Y+5ub3lsIRQhHuJVEPoQFdvxx+7PSulu78q2X5/23BJDtDCowfbg/NpzME79OiGOw8 PxrM/feN8W0ExM5LlKV/AXI7vZmHmcZdpKoCO6BcA3g3Sodwoa57DdzAHJ3P/hC3Z4Vo +zXaZi2fFRJVSd+OflG269UWRzNQao7uzSAnXwwV6t8e/fBjGdNtdOMDkwnZ/OFZ7BA3 JFkSB4sNtLX3d7AbaWfRmkNnQ2SFHaMZyXlah5Wu6+Z7z7EVa8BlrgzBAOA5cBT90tMP oSQSsowmNDu2XnUkgRHgODFsf488plgru4z0BFa5UmH+CJlhc5BLvfTMv8bc5zOHeSdG GoQQ== ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=EEs2wemr; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28418-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28418-ouuuleilei=gmail.com@vger.kernel.org" Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [2604:1380:45d1:ec00::1]) by mx.google.com with ESMTPS id v14-20020a0c8e0e000000b00680c767ca46si10933464qvb.12.2024.01.16.19.40.14 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Jan 2024 19:40:14 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-28418-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) client-ip=2604:1380:45d1:ec00::1; Authentication-Results: mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=EEs2wemr; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-28418-ouuuleilei=gmail.com@vger.kernel.org designates 2604:1380:45d1:ec00::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-28418-ouuuleilei=gmail.com@vger.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 42A031C26036 for ; Wed, 17 Jan 2024 01:13:30 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 3D94214AA7; Wed, 17 Jan 2024 01:10:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="EEs2wemr" Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (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 F1B778BED; Wed, 17 Jan 2024 01:10:09 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453811; cv=none; b=kLWLlTXaNEql+zqmDvFHK0HbwQhyjG4ez0dvFXVXhgGYZ9fz0ShZavDOR5oiautbhmeaLK+DrcxSFgarktLesCUPdw5LNNfxaVlcWrQA0o6RIUi8f26ZRi44Ssys2Z9cHAEpec23B7NHL6+Wgh9+cmWJ4MEDkquaHRGKbgBV9mc= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1705453811; c=relaxed/simple; bh=jgmXU1E3Z2SWEh6ABHcsCpSffF6ClS5QkoPdtgw0WSw=; h=DKIM-Signature:Received:From:To:Cc:Subject:Date:Message-ID: X-Mailer:In-Reply-To:References:MIME-Version: Content-Transfer-Encoding; b=OuK3J6X3w9vReX1OWqoUtiNdQnXBUIvpGj40mYH96pHt48yNNBdHnBDX06yq7spbFSICUEDASTA+vQL0qEC5lD1TmOC0eDa3AI4aODzBO1H7mIKS9XQo5ODgMHXYJhbzRrBkgK2Hgn3XPLv57yuJmsarcxN4nG4uWK5XYSOLelA= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=EEs2wemr; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:References:In-Reply-To:Message-ID:Date:Subject:Cc:To:From:Sender :Reply-To:Content-Type:Content-ID:Content-Description; bh=Rfa69KGhRV06omS8OU11mtmpPZ9dpOihzp/ZOk6Xf+g=; b=EEs2wemrsa0B22guu+fu4YngIc LrbzCTnPk7n4Ks7EXGQyadLquqMYsq6wknU2JiW5CMLC+NT0NC3+ThJYyYDveOh/AqTqaTCqUroGK tbvBXTyRHLR+SArNNP53idwxfhqq8F5uUuxmKTDsHKq5GhlSzQsa4AJ4aPcUk38jjSq46lKKzMnZa wxrlsBnv0eSjc4kulABp8UZ6ACPBtKT2AlLZxLnswU4WyUDjSWe+AOLdr8ARSCuljg/tXhG1cdOQZ JRkqVvrCBVgiRPT0COO+QRrtBIATqBVJidWLcWDdARr+Dan0+UNIN6AbgxXll34Led+WtzkHY1Mue sCksqeuQ==; Received: from [50.53.46.231] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.96 #2 (Red Hat Linux)) id 1rPuRV-00E6zu-1H; Wed, 17 Jan 2024 01:10:09 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Tony Lindgren , linux-omap@vger.kernel.org, Russell King , linux-arm-kernel@lists.infradead.org, patches@armlinux.org.uk Subject: [PATCH 13/13] ARM: OMAP2+: fix kernel-doc warnings Date: Tue, 16 Jan 2024 17:10:01 -0800 Message-ID: <20240117011004.22669-14-rdunlap@infradead.org> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20240117011004.22669-1-rdunlap@infradead.org> References: <20240117011004.22669-1-rdunlap@infradead.org> 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: 1788302409213082259 X-GMAIL-MSGID: 1788307375869320129 Use the correct function name in a comment. Add the return value documentation for one function. These changes prevent these warnings: wd_timer.c:76: warning: expecting prototype for omap2_wdtimer_reset(). Prototype was for omap2_wd_timer_reset() instead wd_timer.c:76: warning: No description found for return value of 'omap2_wd_timer_reset' Signed-off-by: Randy Dunlap Cc: Tony Lindgren Cc: linux-omap@vger.kernel.org Cc: Russell King Cc: linux-arm-kernel@lists.infradead.org Cc: patches@armlinux.org.uk --- KernelVersion: 0dd3ee31125508cd67f7e717 arch/arm/mach-omap2/wd_timer.c | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff -- a/arch/arm/mach-omap2/wd_timer.c b/arch/arm/mach-omap2/wd_timer.c --- a/arch/arm/mach-omap2/wd_timer.c +++ b/arch/arm/mach-omap2/wd_timer.c @@ -57,7 +57,7 @@ int omap2_wd_timer_disable(struct omap_h } /** - * omap2_wdtimer_reset - reset and disable the WDTIMER IP block + * omap2_wd_timer_reset - reset and disable the WDTIMER IP block * @oh: struct omap_hwmod * * * After the WDTIMER IP blocks are reset on OMAP2/3, we must also take @@ -71,6 +71,8 @@ int omap2_wd_timer_disable(struct omap_h * during a normal merge window. omap_hwmod_softreset() should be * renamed to omap_hwmod_set_ocp_softreset(), and omap_hwmod_softreset() * should call the hwmod _ocp_softreset() code. + * + * Returns: %0 on success or -errno value on error. */ int omap2_wd_timer_reset(struct omap_hwmod *oh) {