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

[Greg Kroah-Hartman]

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@xxxxxxxxx>
> >> ---
> >>
> >>  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@xxxxxxxxxxxxxxxxxxxx>
> 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@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/