All of lore.kernel.org
 help / color / mirror / Atom feed
From: Andi Kleen <ak@suse.de>
To: kernel-janitors@lists.osdl.org, linux-kernel@vger.kernel.org
Subject: [KJ] Fixing make mandocs
Date: Mon, 23 Jan 2006 04:31:27 +0000	[thread overview]
Message-ID: <200601230531.27609.ak@suse.de> (raw)

[-- Attachment #1: Type: text/plain, Size: 2997 bytes --]


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

[-- Attachment #2: Type: text/plain, Size: 168 bytes --]

_______________________________________________
Kernel-janitors mailing list
Kernel-janitors@lists.osdl.org
https://lists.osdl.org/mailman/listinfo/kernel-janitors

WARNING: multiple messages have this Message-ID (diff)
From: Andi Kleen <ak@suse.de>
To: kernel-janitors@lists.osdl.org, linux-kernel@vger.kernel.org
Subject: Fixing make mandocs
Date: Mon, 23 Jan 2006 05:31:27 +0100	[thread overview]
Message-ID: <200601230531.27609.ak@suse.de> (raw)


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

             reply	other threads:[~2006-01-23  4:31 UTC|newest]

Thread overview: 12+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2006-01-23  4:31 Andi Kleen [this message]
2006-01-23  4:31 ` Fixing make mandocs Andi Kleen
2006-01-23  4:49 ` [KJ] " Randy.Dunlap
2006-01-23  4:49   ` Randy.Dunlap
2006-01-23  4:52   ` [KJ] " Andi Kleen
2006-01-23  4:52     ` Andi Kleen
2006-01-23  4:53     ` [KJ] " Randy.Dunlap
2006-01-23  4:53       ` Randy.Dunlap
2006-01-23 12:28       ` [KJ] " Martin Waitz
2006-01-23 12:28         ` Martin Waitz
2006-01-23 12:52         ` [KJ] " Andi Kleen
2006-01-23 12:52           ` Andi Kleen

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=200601230531.27609.ak@suse.de \
    --to=ak@suse.de \
    --cc=kernel-janitors@lists.osdl.org \
    --cc=linux-kernel@vger.kernel.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body. 
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.