2003-09-16 03:09:12

by Michael Still

Subject: [2.6 Patch] Kernel-doc updates 7 of 15 -- /fs/inode.c

This patch removes kernel-doc errors reported whilst doing
a make mandocs on 2.6-test4-bk5

Linus, please apply.

Cheers,
Mikal


--------------------------


diff -Nur linux-2.6.0-test4-bk5-mandocs/fs/inode.c
linux-2.6.0-test4-bk5-mandocs_tweaks/fs/inode.c
--- linux-2.6.0-test4-bk5-mandocs/fs/inode.c 2003-09-04 10:57:06.000000000 +1000
+++ linux-2.6.0-test4-bk5-mandocs_tweaks/fs/inode.c 2003-09-06
19:40:06.000000000 +1000
@@ -252,6 +252,9 @@
}

/*
+ * dispose_list - dispose of the contents of a local list
+ * @head: the head of the list to free
+ *
* Dispose-list gets a local list with local inodes in it, so it doesn't
* need to worry about list corruption and SMP locks.
*/
@@ -728,11 +731,11 @@
/**
* ifind - internal function, you want ilookup5() or iget5().
* @sb: super block of file system to search
- * @hashval: hash value (usually inode number) to search for
+ * @head: the head of the list to search
* @test: callback used for comparisons between inodes
* @data: opaque data pointer to pass to @test
*
- * ifind() searches for the inode specified by @hashval and @data in the inode
+ * ifind() searches for the inode specified by @data in the inode
* cache. This is a generalized version of ifind_fast() for file systems where
* the inode number is not sufficient for unique identification of an inode.
*
@@ -764,6 +767,7 @@
/**
* ifind_fast - internal function, you want ilookup() or iget().
* @sb: super block of file system to search
+ * @head: head of the list to search
* @ino: inode number to search for
*
* ifind_fast() searches for the inode @ino in the inode cache. This is for

--

Michael Still ([email protected]) | "All my life I've had one dream,
http://www.stillhq.com | to achieve my many goals"
UTC + 10 | -- Homer Simpson


-------------------------------------------------
This mail sent through IMP: http://horde.org/imp/

2003-09-16 13:59:34

by Alan

Subject: Re: [2.6 Patch] Kernel-doc updates 7 of 15 -- /fs/inode.c

On Maw, 2003-09-16 at 04:04, Michael Still wrote:
>
> /*

Should be /** there for dispose_list so that the entry is generated,
otherwise it thinks its just a comment. The rest looks great

2003-09-16 23:41:26

by Michael Still

Subject: Re: [2.6 Patch] Kernel-doc updates 7 of 15 -- /fs/inode.c

Quoting Alan Cox <[email protected]>:

> On Maw, 2003-09-16 at 04:04, Michael Still wrote:
> >
> > /*
>
> Should be /** there for dispose_list so that the entry is generated,
> otherwise it thinks its just a comment. The rest looks great

No problemmo -- I'll fix this when I resubmit slightly less broken patches.

Cheers,
Mikal

--

Michael Still ([email protected]) | "All my life I've had one dream,
http://www.stillhq.com | to achieve my many goals"
UTC + 10 | -- Homer Simpson


-------------------------------------------------
This mail sent through IMP: http://horde.org/imp/