Received: by 2002:a05:6a10:a0d1:0:0:0:0 with SMTP id j17csp289758pxa; Fri, 31 Jul 2020 12:03:55 -0700 (PDT) X-Google-Smtp-Source: ABdhPJz0ornKZHQ5wzPjAulDmwsdFOrf3KRfbs0+4UnsOjKTCmKLnt04tugVcLQ/4Xc7IF8aw393 X-Received: by 2002:a17:906:e0e:: with SMTP id l14mr5163622eji.398.1596222235415; Fri, 31 Jul 2020 12:03:55 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1596222235; cv=none; d=google.com; s=arc-20160816; b=v8KZkjOOCBEIl1gRBJsJVBEEPA9ict977MaMxvNmeZR6L4oMsOzOVy477RKeNZz6MX iZ283NY32SzXB5A3XRqZ7R8hM1rZpLWd9JOJaPu9f/2X8Q5580jtFPwjQz9vdfoTKrVA ZAgZQ2W5UrLZIwcVtNrRSZfMrWspA+FZMRP2y6KlyzeUmwrl3WJ6SywnXDpd4XGz6hEN uiC4+tDpvPhnLlnLKHNlwAdDA22Q/YzBYApCtHAP1gBwLdbZXR7Sk7PDeLpOrifji+Rk UYEVOmnxgfy0QkRhweAk3TDRORpqDbu5pwATlQ5Rf+qxF0qnV0BlGnUtKDrrzi43uih6 EsiA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-disposition:mime-version:references:message-id:subject:cc :to:from:date; bh=VZ6FN2M0JopBM4LOM2glqvTbPCKQ+H9IqyiCMXnpj/g=; b=F15FuhpEX6aFeWBmXaVopVam9/WkHicchhtPbEPdpBYgbRh+8MsuUmurgN2NE8U6Dc oRbks1yOQrXxlkcqjzC+GLLC+lc+HhCZZXBJ7d/w4EiVzXycuWOMb02Is2BLokL9URhO n075nnRaShecs8CCSEY8LOzbEQ3YkuoDMmUQDJMLoW97mXi908ghRSREN6ZrZvaLMqOR T57sMLyFL4GjF5ydKNL1lkFrYhImvX21mK77EXo9ISJOgRW8ZLgRJXDD8K4uLPY8g2Vt pcPpUUEddncizRp/tpAoo5maAdLCY+RCMmkDlt98CHnfWWkNKOFt63gCs562gJf0Ql/Y fnMQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [23.128.96.18]) by mx.google.com with ESMTP id p7si5763789ejy.206.2020.07.31.12.03.09; Fri, 31 Jul 2020 12:03:55 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-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-kernel-owner@vger.kernel.org designates 23.128.96.18 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1729209AbgGaTDB (ORCPT + 99 others); Fri, 31 Jul 2020 15:03:01 -0400 Received: from netrider.rowland.org ([192.131.102.5]:42297 "HELO netrider.rowland.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with SMTP id S1726925AbgGaTDB (ORCPT ); Fri, 31 Jul 2020 15:03:01 -0400 Received: (qmail 47503 invoked by uid 1000); 31 Jul 2020 15:03:00 -0400 Date: Fri, 31 Jul 2020 15:03:00 -0400 From: Alan Stern To: "Rafael J. Wysocki" Cc: Linux PM , LKML , Ulf Hansson , Wolfram Sang , Sakari Ailus Subject: Re: [PATCH] PM: runtime: Add kerneldoc comments to multiple helpers Message-ID: <20200731190300.GA47100@rowland.harvard.edu> References: <2672940.cHDmkauF2A@kreacher> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <2672940.cHDmkauF2A@kreacher> User-Agent: Mutt/1.10.1 (2018-07-13) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Fri, Jul 31, 2020 at 07:03:26PM +0200, Rafael J. Wysocki wrote: > From: Rafael J. Wysocki > > Add kerneldoc comments to multiple PM-runtime helper functions > defined as static inline wrappers around lower-level routines to > provide quick reference decumentation of their behavior. > > Some of them are similar to each other with subtle differences only > and the behavior of some of them may appear as counter-intuitive, so > clarify all that to avoid confusion. > > Signed-off-by: Rafael J. Wysocki Acked-by: Alan Stern