Received: by 2002:ab2:2994:0:b0:1ef:ca3e:3cd5 with SMTP id n20csp553825lqb; Thu, 14 Mar 2024 21:55:58 -0700 (PDT) X-Forwarded-Encrypted: i=3; AJvYcCXHeNfPq5AttCEJYNB2DEb/G5LNzYySnZEYz9wvv+9j4U/GlVZiHTQmEUlGW1AJidrcdqyaU/UkzOnXqqIlnKqvk5VlqslZNQ2LP4r3rw== X-Google-Smtp-Source: AGHT+IGUbJ73CsLrkTSWI4gGvVMSMRctbSvtuwcRUARBknKxlfFU6ERdZyD95iyKemADsrSGgAJJ X-Received: by 2002:a25:918f:0:b0:dcc:4b44:3377 with SMTP id w15-20020a25918f000000b00dcc4b443377mr3350368ybl.25.1710478558572; Thu, 14 Mar 2024 21:55:58 -0700 (PDT) ARC-Seal: i=2; a=rsa-sha256; t=1710478558; cv=pass; d=google.com; s=arc-20160816; b=P/GN56K3BT0jjwT4ElROsmCI6BZTYtOU8V8GbcjzoHvueuizPj1gu3aMno2oq0/U3u 43aZ003T4TuCKdch+3VH509aVUKZpDQwlYu3OOAjaBy5/r1fMbWVupAIbnS0OIXgf9uA 7O6h3fe5cyZXBVthoX/xrjjOiP+AkUdBKNbe4wgWHGAmo7LVE0RXGpJxEQtpDeH2dOvZ 8Rs70LmzDQilIkYJ/sPUuVgmAvPcTvFZaD8vVg1Ih9rMQRT7q0VhUGgXKWOiE8c8ib7C a35OlURwrxRVVEiXOzlICTR9BWYPDgN/7qSsuercgrQ+4cgU5jNo5Mw8cOVCvxXb/mm/ 3E7A== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:in-reply-to:from:references:cc:to :content-language:subject:user-agent:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:date:message-id:dkim-signature; bh=t+bIzMjxJuGGhtOWha6ywfboWHnjmdtyGquxlI+CJQw=; fh=I1TaNshy7yOpyTGxMYHQMqA/4LMx9Ez8yvqb7oY9NmY=; b=N54IiGJwCvw3UAHSPqvqyurd1t1Py4rg1qg/Cmz5WShdcZaAXX3iSNGv2XssFQHCc+ j2EvPp2JJSkbqC7ag3b/LtO2EQJBnmSdmFwfdMeh7q1w4qt+LNrhLadGo03HV4wXi2X0 +wfTSN4Abh8tdSPvskvGawFAhVPB+k+5qJ4PNebVBSGzm48lLTnNqk2f2Z/7dJdVNR/u 6y/KV3jN+3JtoNp152N9rdnbj8D9t/4adv95zuhBpVRyU8S3XFhfNpWRXtDGPMTDRELf rr2beMfAT77GxZbPcZZt4ORT/aXWJ+eLoQUt8HCggd34KutGVxkh5SZvG4DNDQ4nj7vD I7sw==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@infradead.org header.s=bombadil.20210309 header.b=wX3fTx76; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-104060-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-104060-linux.lists.archive=gmail.com@vger.kernel.org" Return-Path: Received: from sv.mirrors.kernel.org (sv.mirrors.kernel.org. [2604:1380:45e3:2400::1]) by mx.google.com with ESMTPS id y14-20020a63ce0e000000b005dc96417b0fsi1970756pgf.161.2024.03.14.21.55.58 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 14 Mar 2024 21:55:58 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel+bounces-104060-linux.lists.archive=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=wX3fTx76; arc=pass (i=1 dkim=pass dkdomain=infradead.org); spf=pass (google.com: domain of linux-kernel+bounces-104060-linux.lists.archive=gmail.com@vger.kernel.org designates 2604:1380:45e3:2400::1 as permitted sender) smtp.mailfrom="linux-kernel+bounces-104060-linux.lists.archive=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 3E01A283710 for ; Fri, 15 Mar 2024 04:55:58 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 5B4BBE55F; Fri, 15 Mar 2024 04:55:52 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="wX3fTx76" 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 28317DDA9; Fri, 15 Mar 2024 04:55:48 +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=1710478551; cv=none; b=V6kR6Or9z5QoIthFd9XGD0FTwI53YodPBTFoKHTxl6yHQnsHlVOUuUfYhCpDg/uRmb+0ec0LYZ8tUkoO66q2KtGJRM18CrIrEsK2Lo7KwwDLYTTPk445wLI4tUXZDUucXjIpT7wEhHmOJdXTtYoSa3hvwJD7yK9IQK/iNRbwAi4= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1710478551; c=relaxed/simple; bh=+aFnlU8sVV7br4We/EkXYelHujQrdfZV21yVHMFaQqY=; h=Message-ID:Date:MIME-Version:Subject:To:Cc:References:From: In-Reply-To:Content-Type; b=HsyObmZLrlIsSevWu3Dbg/Jg8jdfHwmA4d/ImwOVs7hdcjrzb7f7qpgzjklM8SKH8vGk8wK1sypwSyTrg6yWbMHvsK4tUfPfC/WutSVRP/+jrli924gF1n5g1iDk6dHphzuRm76PA4fepU48iCvE2ouzYs+xGSV+ExZnp6fVobY= 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=wX3fTx76; 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:In-Reply-To:From:References:Cc:To:Subject:MIME-Version:Date: Message-ID:Sender:Reply-To:Content-ID:Content-Description; bh=t+bIzMjxJuGGhtOWha6ywfboWHnjmdtyGquxlI+CJQw=; b=wX3fTx76SdeNFG9qod3TY6OXyj wMV+UhX4QStLD+UwamXWaoTVemH5ygpYyBsH5/otnqt/C0N24JnhgK7YIY1O4O+PK2hKoX1wid9pa X+HDPoONM9O5OXf575OdkR4yw/ZGezZl98cyJMIND/MeAuGAq1nMFLfFW0j+/dPEj9SQa/byPRKLt w6q3QJp5saTAuR9kN87x3KjbkiH+BzUVvJCLUdhYr3p8neWb5D+m//EL/yJ+yTMGuCeHtmpFe44QV YM96/qw21mwNuldMlHRMzmvXZgDOwlMciCa+HOTacLvxHyIgYnfirB1O+AFCh6WZnSGE+S/UT1nr/ XVuAN72Q==; Received: from [50.53.2.121] (helo=[192.168.254.15]) by bombadil.infradead.org with esmtpsa (Exim 4.97.1 #2 (Red Hat Linux)) id 1rkzbf-0000000Gfyd-3utH; Fri, 15 Mar 2024 04:55:48 +0000 Message-ID: <11706f70-539d-43b3-8b5d-e20bdd38d23b@infradead.org> Date: Thu, 14 Mar 2024 21:55:47 -0700 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Subject: Re: [PATCH -next v2] ACPI: Add kernel-doc comments for ACPI suspend and hibernation functions Content-Language: en-US To: Yang Li , rafael@kernel.org Cc: linux-acpi@vger.kernel.org, linux-kernel@vger.kernel.org References: <20240315003753.96173-1-yang.lee@linux.alibaba.com> From: Randy Dunlap In-Reply-To: <20240315003753.96173-1-yang.lee@linux.alibaba.com> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit On 3/14/24 17:37, Yang Li wrote: > This patch enhances the documentation for the ACPI power management > functions related to system suspend and hibernation. This includes the > use of kernel-doc style comments which provide developers with clearer > guidance on the usage and expectations of these functions. > > Signed-off-by: Yang Li Reviewed-by: Randy Dunlap Tested-by: Randy Dunlap Thanks. > --- > > change in v2: > --According to Randy's suggestion, use a space between '*' > and function names, function parameters. > > drivers/acpi/sleep.c | 24 ++++++++++++++---------- > 1 file changed, 14 insertions(+), 10 deletions(-) > -- #Randy