From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S966193Ab3DQPb2 (ORCPT ); Wed, 17 Apr 2013 11:31:28 -0400 Received: from mga02.intel.com ([134.134.136.20]:54119 "EHLO mga02.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S964900Ab3DQPb0 (ORCPT ); Wed, 17 Apr 2013 11:31:26 -0400 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.87,494,1363158000"; d="scan'208";a="296370871" Message-ID: <1366212681.2091.65.camel@rzhang1-mobl4> Subject: Re: [PATCH RESEND 09/11] thermal: update kernel-doc for thermal_cooling_device_register From: Zhang Rui To: Eduardo Valentin Cc: linux-pm@vger.kernel.org, linux-kernel@vger.kernel.org Date: Wed, 17 Apr 2013 23:31:21 +0800 In-Reply-To: <1365437258-31412-10-git-send-email-eduardo.valentin@ti.com> References: <1365437258-31412-1-git-send-email-eduardo.valentin@ti.com> <1365437258-31412-10-git-send-email-eduardo.valentin@ti.com> Content-Type: text/plain; charset="UTF-8" X-Mailer: Evolution 3.2.3-0ubuntu6 Content-Transfer-Encoding: 7bit Mime-Version: 1.0 Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, 2013-04-08 at 12:07 -0400, Eduardo Valentin wrote: > This patch updates the documentation for thermal_cooling_device_register > and removes the warnings generated by scripts/kernel-doc -v. > > Signed-off-by: Eduardo Valentin > --- > drivers/thermal/thermal_sys.c | 9 ++++++++- > 1 files changed, 8 insertions(+), 1 deletions(-) > > diff --git a/drivers/thermal/thermal_sys.c b/drivers/thermal/thermal_sys.c > index 98d7d53..f3a4e17 100644 > --- a/drivers/thermal/thermal_sys.c > +++ b/drivers/thermal/thermal_sys.c > @@ -1275,10 +1275,17 @@ static struct class thermal_class = { > }; > > /** > - * thermal_cooling_device_register - register a new thermal cooling device > + * thermal_cooling_device_register() - register a new thermal cooling device > * @type: the thermal cooling device type. > * @devdata: device private data. > * @ops: standard thermal cooling devices callbacks. > + * > + * This interface function adds a new thermal cooling device (fan/processor/...) > + * to /sys/class/thermal/ folder as cooling_device[0-*]. It tries to bind itself > + * to all the thermal zone devices register at the same time. s/register/registered ? thanks, rui > + * > + * Return: a pointer to the created struct thermal_cooling_device or an > + * ERR_PTR. Caller must check return value with IS_ERR*() helpers. > */ > struct thermal_cooling_device * > thermal_cooling_device_register(char *type, void *devdata,