* Fixing make mandocs
@ 2006-01-23 4:31 Andi Kleen
2006-01-23 4:49 ` Randy.Dunlap
0 siblings, 1 reply; 6+ messages in thread
From: Andi Kleen @ 2006-01-23 4:31 UTC (permalink / raw)
To: kernel-janitors, linux-kernel
Here would be a good janitor task for 2.6.16. make mandocs currently
doesn't build because a number of descriptions are missing parameters etc.
It would be good if someone could fix that and submit patches for 2.6.16.
It should be relatively straight forward, if one cannot figure out
what a missing parameter does adding a dummy description ("Undocumented")
would be also ok.
-Andi
DOCPROC Documentation/DocBook/kernel-api.xml
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//mm/slab.c:1505): No descript
ion found for parameter 'cachep'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//mm/slab.c:1505): No descript
ion found for parameter 'size'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//mm/slab.c:1505): No descript
ion found for parameter 'align'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//mm/slab.c:1505): No descript
ion found for parameter 'flags'
Error(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//include/asm-i386/uaccess.h:416
): cannot understand prototype: '__always_inline unsigned long __must_check __co
py_to_user_inatomic(void __user *to, const void *from, unsigned long n) '
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//fs/inode.c:1189): No descrip
tion found for parameter 'dentry'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//fs/bio.c:427): No descriptio
n found for parameter 'q'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//include/linux/skbuff.h:308):
No description found for parameter 'copied_early'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//include/linux/skbuff.h:308):
No description found for parameter 'dma_cookie'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/core/skbuff.c:211): No d
escription found for parameter 'fclone'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:920): No
description found for parameter 'clnt'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:920): No
description found for parameter 'flags'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:920): No
description found for parameter 'ops'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:920): No
description found for parameter 'data'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:942): No
description found for parameter 'parent'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/core/dev.c:3317): No des
cription found for parameter 'chan'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/core/dev.c:3317): No des
cription found for parameter 'event'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//kernel/irq/manage.c:177): No
description found for parameter 'new'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//block/ll_rw_blk.c:317): No d
escription found for parameter 'prepare_flush_fn'
Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//block/ll_rw_blk.c:2637): No
description found for parameter 'error'
make[1]: *** [Documentation/DocBook/kernel-api.xml] Error 1
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Fixing make mandocs
2006-01-23 4:31 Fixing make mandocs Andi Kleen
@ 2006-01-23 4:49 ` Randy.Dunlap
2006-01-23 4:52 ` Andi Kleen
0 siblings, 1 reply; 6+ messages in thread
From: Randy.Dunlap @ 2006-01-23 4:49 UTC (permalink / raw)
To: Andi Kleen; +Cc: kernel-janitors, linux-kernel
On Mon, 23 Jan 2006 05:31:27 +0100 Andi Kleen wrote:
>
> Here would be a good janitor task for 2.6.16. make mandocs currently
> doesn't build because a number of descriptions are missing parameters etc.
> It would be good if someone could fix that and submit patches for 2.6.16.
>
> It should be relatively straight forward, if one cannot figure out
> what a missing parameter does adding a dummy description ("Undocumented")
> would be also ok.
>
> -Andi
Lots of these have been fixed in the last 2-3 days by Martin Waitz
and/or me and have been posted on lkml. Martin is collecting them
in his kernel-doc tree.
> DOCPROC Documentation/DocBook/kernel-api.xml
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//mm/slab.c:1505): No descript
> ion found for parameter 'cachep'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//mm/slab.c:1505): No descript
> ion found for parameter 'size'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//mm/slab.c:1505): No descript
> ion found for parameter 'align'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//mm/slab.c:1505): No descript
> ion found for parameter 'flags'
mm/slab.c fixed
> Error(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//include/asm-i386/uaccess.h:416
> ): cannot understand prototype: '__always_inline unsigned long __must_check __co
> py_to_user_inatomic(void __user *to, const void *from, unsigned long n) '
uaccess.h fixed
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//fs/inode.c:1189): No descrip
> tion found for parameter 'dentry'
fixed
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//fs/bio.c:427): No descriptio
> n found for parameter 'q'
fixed
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//include/linux/skbuff.h:308):
> No description found for parameter 'copied_early'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//include/linux/skbuff.h:308):
> No description found for parameter 'dma_cookie'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/core/skbuff.c:211): No d
> escription found for parameter 'fclone'
above seem to be needed.
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:920): No
> description found for parameter 'clnt'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:920): No
> description found for parameter 'flags'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:920): No
> description found for parameter 'ops'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:920): No
> description found for parameter 'data'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/sunrpc/sched.c:942): No
> description found for parameter 'parent'
These are fixed.
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/core/dev.c:3317): No des
> cription found for parameter 'chan'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//net/core/dev.c:3317): No des
> cription found for parameter 'event'
Above seem to be needed.
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//kernel/irq/manage.c:177): No
> description found for parameter 'new'
Fix seems to be needed.
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//block/ll_rw_blk.c:317): No d
> escription found for parameter 'prepare_flush_fn'
> Warning(/usr/src/packages/BUILD/linux-2.6.16-rc1-3//block/ll_rw_blk.c:2637): No
> description found for parameter 'error'
Martin fixed those.
> make[1]: *** [Documentation/DocBook/kernel-api.xml] Error 1
---
~Randy
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Fixing make mandocs
2006-01-23 4:49 ` Randy.Dunlap
@ 2006-01-23 4:52 ` Andi Kleen
2006-01-23 4:53 ` Randy.Dunlap
0 siblings, 1 reply; 6+ messages in thread
From: Andi Kleen @ 2006-01-23 4:52 UTC (permalink / raw)
To: Randy.Dunlap; +Cc: kernel-janitors, linux-kernel
On Monday 23 January 2006 05:49, Randy.Dunlap wrote:
> On Mon, 23 Jan 2006 05:31:27 +0100 Andi Kleen wrote:
>
> >
> > Here would be a good janitor task for 2.6.16. make mandocs currently
> > doesn't build because a number of descriptions are missing parameters etc.
> > It would be good if someone could fix that and submit patches for 2.6.16.
> >
> > It should be relatively straight forward, if one cannot figure out
> > what a missing parameter does adding a dummy description ("Undocumented")
> > would be also ok.
> >
> > -Andi
>
> Lots of these have been fixed in the last 2-3 days by Martin Waitz
> and/or me and have been posted on lkml. Martin is collecting them
> in his kernel-doc tree.
Ok good. Are they going into 2.6.16?
-Andi
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Fixing make mandocs
2006-01-23 4:52 ` Andi Kleen
@ 2006-01-23 4:53 ` Randy.Dunlap
2006-01-23 12:28 ` Martin Waitz
0 siblings, 1 reply; 6+ messages in thread
From: Randy.Dunlap @ 2006-01-23 4:53 UTC (permalink / raw)
To: Andi Kleen, tali; +Cc: kernel-janitors, linux-kernel
On Mon, 23 Jan 2006 05:52:08 +0100 Andi Kleen wrote:
> On Monday 23 January 2006 05:49, Randy.Dunlap wrote:
> > On Mon, 23 Jan 2006 05:31:27 +0100 Andi Kleen wrote:
> >
> > >
> > > Here would be a good janitor task for 2.6.16. make mandocs currently
> > > doesn't build because a number of descriptions are missing parameters etc.
> > > It would be good if someone could fix that and submit patches for 2.6.16.
> > >
> > > It should be relatively straight forward, if one cannot figure out
> > > what a missing parameter does adding a dummy description ("Undocumented")
> > > would be also ok.
> > >
> > > -Andi
> >
> > Lots of these have been fixed in the last 2-3 days by Martin Waitz
> > and/or me and have been posted on lkml. Martin is collecting them
> > in his kernel-doc tree.
>
> Ok good. Are they going into 2.6.16?
I have no idea. Depends on whether Martin (cc-ed) or Andrew
pushes them, I guess.
---
~Randy
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Fixing make mandocs
2006-01-23 4:53 ` Randy.Dunlap
@ 2006-01-23 12:28 ` Martin Waitz
2006-01-23 12:52 ` Andi Kleen
0 siblings, 1 reply; 6+ messages in thread
From: Martin Waitz @ 2006-01-23 12:28 UTC (permalink / raw)
To: Randy.Dunlap; +Cc: Andi Kleen, kernel-janitors, linux-kernel
[-- Attachment #1: Type: text/plain, Size: 602 bytes --]
hoi :)
On Sun, Jan 22, 2006 at 08:53:49PM -0800, Randy.Dunlap wrote:
> > > > Here would be a good janitor task for 2.6.16. make mandocs
> > > > currently doesn't build because a number of descriptions are
> > > > missing parameters etc. It would be good if someone could fix
> > > > that and submit patches for 2.6.16.
the thing that really breaks the build is the new __copy_to_user
prototype which kernel-doc could not understand.
This is fixed in my tree.
> > Ok good. Are they going into 2.6.16?
I'll try to get at least the one kernel-doc fix into 2.6.16.
--
Martin Waitz
[-- Attachment #2: Digital signature --]
[-- Type: application/pgp-signature, Size: 189 bytes --]
^ permalink raw reply [flat|nested] 6+ messages in thread
* Re: Fixing make mandocs
2006-01-23 12:28 ` Martin Waitz
@ 2006-01-23 12:52 ` Andi Kleen
0 siblings, 0 replies; 6+ messages in thread
From: Andi Kleen @ 2006-01-23 12:52 UTC (permalink / raw)
To: Martin Waitz; +Cc: Randy.Dunlap, kernel-janitors, linux-kernel
On Monday 23 January 2006 13:28, Martin Waitz wrote:
> hoi :)
>
> On Sun, Jan 22, 2006 at 08:53:49PM -0800, Randy.Dunlap wrote:
> > > > > Here would be a good janitor task for 2.6.16. make mandocs
> > > > > currently doesn't build because a number of descriptions are
> > > > > missing parameters etc. It would be good if someone could fix
> > > > > that and submit patches for 2.6.16.
>
> the thing that really breaks the build is the new __copy_to_user
> prototype which kernel-doc could not understand.
> This is fixed in my tree.
>
> > > Ok good. Are they going into 2.6.16?
>
> I'll try to get at least the one kernel-doc fix into 2.6.16.
I would just send all that fix build failures.
-Andi
^ permalink raw reply [flat|nested] 6+ messages in thread
end of thread, other threads:[~2006-01-23 12:52 UTC | newest]
Thread overview: 6+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2006-01-23 4:31 Fixing make mandocs Andi Kleen
2006-01-23 4:49 ` Randy.Dunlap
2006-01-23 4:52 ` Andi Kleen
2006-01-23 4:53 ` Randy.Dunlap
2006-01-23 12:28 ` Martin Waitz
2006-01-23 12:52 ` Andi Kleen
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox