lkml.org 
[lkml]   [2006]   [Oct]   [8]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
Date
From
SubjectRe: [PATCH] kernel-doc: fix function name in usercopy.c
On Mon, 9 Oct 2006 07:28:51 +0400 Alexey Dobriyan wrote:

> On Sun, Oct 08, 2006 at 07:44:29PM -0700, Randy Dunlap wrote:
> > /**
> > - * strlen_user: - Get the size of a string in user space.
> > + * strnlen_user: - Get the size of a string in user space.
>
> It's better to not spend time fixing mismatches, but to teach kernel-doc
> extract function name from function itself.
>
> /**
> * Get the size of a string in user space.
> * @foo: bar
> */
> size_t strnlen_user()

OK, maybe a good idea. I'll add that to the wish list.
However, we have seen examples of:

/**
* doc for foo
*/
int foo(int arg)
{
}

then someone inserts a new function bar() between the kernel-doc
and foo(). How would we catch that (automated)?
other than by our review process?

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

\
 
 \ /
  Last update: 2006-10-09 05:37    [W:0.102 / U:0.192 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site