linux-kernel - Re: [PATCH] usb: fix some scripts/kernel-doc warnings

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20130804212919.GA10623@kroah.com>
Date:	Mon, 5 Aug 2013 05:29:19 +0800
From:	Greg Kroah-Hartman <gregkh@...uxfoundation.org>
To:	Yacine Belkadi <yacine.belkadi.1@...il.com>
Cc:	Alan Stern <stern@...land.harvard.edu>,
	Jiri Kosina <jkosina@...e.cz>,
	Sarah Sharp <sarah.a.sharp@...ux.intel.com>,
	Kevin Hilman <khilman@...aro.org>,
	Alexey Khoroshilov <khoroshilov@...ras.ru>,
	Thomas Renninger <trenn@...e.de>,
	Hannes Reinecke <hare@...e.de>,
	Lan Tianyu <tianyu.lan@...el.com>,
	Sebastian Andrzej Siewior <bigeasy@...utronix.de>,
	Ming Lei <ming.lei@...onical.com>,
	Tülin İzer <tulinizer@...il.com>,
	Sachin Kamat <sachin.kamat@...aro.org>,
	Johan Hovold <jhovold@...il.com>, Kay Sievers <kay@...y.org>,
	Julius Werner <jwerner@...omium.org>,
	Yuanhan Liu <yliu.null@...il.com>, linux-usb@...r.kernel.org,
	linux-kernel@...r.kernel.org, linux-doc@...r.kernel.org
Subject: Re: [PATCH] usb: fix some scripts/kernel-doc warnings

On Sun, Aug 04, 2013 at 10:05:36PM +0200, Yacine Belkadi wrote:
> On 08/03/2013 05:29 AM, Greg Kroah-Hartman wrote:
> > On Fri, Aug 02, 2013 at 08:10:04PM +0200, Yacine Belkadi wrote:
> >> When building the htmldocs (in verbose mode), scripts/kernel-doc reports the
> >> following type of warnings:
> >>
> >> Warning(drivers/usb/core/usb.c:76): No description found for return value of
> >> 'usb_find_alt_setting'
> >>
> >> Fix them by:
> >> - adding some missing descriptions of return values
> >> - using "Return" sections for those descriptions
> >>
> >> Signed-off-by: Yacine Belkadi <yacine.belkadi.1@...il.com>
> >> ---
> >>
> >>  Applied to b3a3a9c441e2c8f6b6760de9331023a7906a4ac6
> > 
> > What does this line mean?
> 
> It's the commit on which I created and applied the patch:
> 
> commit b3a3a9c441e2c8f6b6760de9331023a7906a4ac6
> Merge: a582e5f e70e78e
> Author: Linus Torvalds <torvalds@...ux-foundation.org>
> Date:   Mon Jul 22 19:07:24 2013 -0700

Odd, I've never seen anyone use that before.  It's really not needed, so
you don't have to do that in the future.

thanks,

greg k-h
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/