From patchwork Fri Nov 13 08:58:10 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alex Shi X-Patchwork-Id: 324279 Delivered-To: patch@linaro.org Received: by 2002:a05:6e02:5ce:0:0:0:0 with SMTP id l14csp1032679ils; Fri, 13 Nov 2020 00:58:36 -0800 (PST) X-Google-Smtp-Source: ABdhPJz2v23gf92UxYqjfml+iG6o2lu15+PdgyRVNCY7KrUMwvVHekS34N0Q9ulCmC2kdIJ5ZvuF X-Received: by 2002:a17:906:46d2:: with SMTP id k18mr902131ejs.33.1605257916529; Fri, 13 Nov 2020 00:58:36 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1605257916; cv=none; d=google.com; s=arc-20160816; b=E87NpoDbDA1K63aqS+3IG7Tw9dLLiXPfzRiV+Bc4BTbIyfrd9JouRza3UL6YV0ZoDZ YBbXtExrv0e9GOiMA6+bd+aXA4NxeCPaBzkMnmpviBJkvC1Ao1MJ7a1hOr5fQmEV9nbQ jKXVpAEImwWs2WbNso1cXrdBlZx1H/jySh7vr1Ifhzi9v6GMdNepHHW1LACl2DF8S39D gPPeaw9kuWRL+/gLvaG0Yf6t34Zu1xIQyBNdEuTlt1Lt4QRyZI37tc8kHYXPAslY23RB i5XQOl+P8+dbmaZznGC0VSeskpADXrZdLB6cfkZSYf3jXUYsi3tubwy8qYWjvZ4kJMj3 tmyg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:to:message-id:date:subject:cc:from; bh=aPLpJeYwvn3mjzpN745eC0YcX6RZpPrmzxbRjK4Zjnk=; b=iSUAj0XK4Vz+giF2N46qVCmkaCJMH6ttTvJLGUfIQWhIcmII9vRGOWVrpfaySaYuCs 3h+yKNYJ5sLuHK2RQTOeEBciH5UxCkt4Y4SZsg4obwq7II0opy+xqJlYx9x5ngVNPKTB jP2Xw/8RXBg353nKGKm6ajwva0QN4IKFBpQDiT9pl3vF6CldN3762NnVxsEEbLUeVw1g pl5pqVtuCIhrOa+K+ipKeHuYbZWmAkdCgNoCnwqXXbnf7MbeOi7MCN4ReCg3EBkGSm1b Hn8WX1XkO11KSFE3xmYUJu6WHNKSLg8kwtwKJXBweltOqQrtr32vLvtTtffFyl46Vsfa lg9w== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-pm-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-pm-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id h13si5971111edt.581.2020.11.13.00.58.36; Fri, 13 Nov 2020 00:58:36 -0800 (PST) Received-SPF: pass (google.com: domain of linux-pm-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) client-ip=23.128.96.18; Authentication-Results: mx.google.com; spf=pass (google.com: domain of linux-pm-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-pm-owner@vger.kernel.org; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=alibaba.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726237AbgKMI6e (ORCPT + 9 others); Fri, 13 Nov 2020 03:58:34 -0500 Received: from out30-45.freemail.mail.aliyun.com ([115.124.30.45]:51864 "EHLO out30-45.freemail.mail.aliyun.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726149AbgKMI6d (ORCPT ); Fri, 13 Nov 2020 03:58:33 -0500 X-Alimail-AntiSpam: AC=PASS; BC=-1|-1; BR=01201311R891e4; CH=green; DM=||false|; DS=||; FP=0|-1|-1|-1|0|-1|-1|-1; HT=e01e04420; MF=alex.shi@linux.alibaba.com; NM=1; PH=DS; RN=5; SR=0; TI=SMTPD_---0UFAepvk_1605257910; Received: from aliy80.localdomain(mailfrom:alex.shi@linux.alibaba.com fp:SMTPD_---0UFAepvk_1605257910) by smtp.aliyun-inc.com(127.0.0.1); Fri, 13 Nov 2020 16:58:31 +0800 From: Alex Shi Cc: "Rafael J. Wysocki" , Len Brown , Pavel Machek , linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH] PM / suspend: fix kernel-doc markup Date: Fri, 13 Nov 2020 16:58:10 +0800 Message-Id: <1605257895-5536-1-git-send-email-alex.shi@linux.alibaba.com> X-Mailer: git-send-email 1.8.3.1 To: unlisted-recipients:; (no To-header on input) Precedence: bulk List-ID: X-Mailing-List: linux-pm@vger.kernel.org Add parameter explanation to fix kernel-doc marks: kernel/power/suspend.c:233: warning: Function parameter or member 'state' not described in 'suspend_valid_only_mem' kernel/power/suspend.c:344: warning: Function parameter or member 'state' not described in 'suspend_prepare' Signed-off-by: Alex Shi Cc: "Rafael J. Wysocki" Cc: Len Brown Cc: Pavel Machek Cc: linux-pm@vger.kernel.org Cc: linux-kernel@vger.kernel.org --- kernel/power/suspend.c | 2 ++ 1 file changed, 2 insertions(+) -- 2.29.GIT diff --git a/kernel/power/suspend.c b/kernel/power/suspend.c index 32391acc806b..502d86ed99c7 100644 --- a/kernel/power/suspend.c +++ b/kernel/power/suspend.c @@ -224,6 +224,7 @@ EXPORT_SYMBOL_GPL(suspend_set_ops); /** * suspend_valid_only_mem - Generic memory-only valid callback. + * @state: Suspend state to be set * * Platform drivers that implement mem suspend only and only need to check for * that in their .valid() callback can use this instead of rolling their own @@ -335,6 +336,7 @@ static int suspend_test(int level) /** * suspend_prepare - Prepare for entering system sleep state. + * @state: suspend state which sleep from * * Common code run for every system sleep state that can be entered (except for * hibernation). Run suspend notifiers, allocate the "suspend" console and