Re: kernel htmldocs partialy failed?

2005-09-02 Thread Joel Soete



Grant Grundler wrote:


[...]

It's clearly a set of upstream problems.
I have no idea if it's "known".
My advice is to check on kernel-janitors mailing list.

 


Ok I will check.

Thanks for feedback,
   Joel


--
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



Re: kernel htmldocs partialy failed?

2005-08-31 Thread Grant Grundler
On Tue, Aug 30, 2005 at 06:15:00PM +0200, tsd78163 wrote:
> Just looking to build the kernel doc (htmldoc to be accurate) of the latest
> parisc-linux cvs kernel 2.6.13-pa0, I fist install xmlto dpkg then after my 
> usual:
...
> with following warnings and errors:
> Warning(/CAD/linux-2.6.13-pa0-20050829/kernel/sched.c:1495): No description
> found for parameter 'rq'

AFAICT, none of the warnings are hppa specific.
I expect patches to fix the warnings would be welcome about now
for 2.6.14-rc releases. kernel-janitors mailing list is probably
a good place to submit those patches:
https://lists.osdl.org/mailman/listinfo/kernel-janitors


> Use of uninitialized value in join or string at
> /CAD/linux-2.6.13-pa0-20050829/scripts/kernel-doc line 369,  line 698.

I suspect this warning is occurring as a result of misformatted
docbook comments in the C code. " line xxx" is the input file.
I have no idea how to correlate them though.

> Error(/CAD/linux-2.6.13-pa0-20050829/include/sound/pcm.h:914): cannot
> understand prototype: ''

This is a bug in kernel-doc script I think.
Here is the offending line from pcm.h:
/* int snd_pcm_format_cpu_endian(snd_pcm_format_t format); */

> My debian install is an unstable and having no more testing one, I would
> like to know if it's pb linked to my install or is it a upstream known pb?

It's clearly a set of upstream problems.
I have no idea if it's "known".
My advice is to check on kernel-janitors mailing list.

grant


-- 
To UNSUBSCRIBE, email to [EMAIL PROTECTED]
with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]



kernel htmldocs partialy failed?

2005-08-30 Thread tsd78163
Hello all,

Just looking to build the kernel doc (htmldoc to be accurate) of the latest
parisc-linux cvs kernel 2.6.13-pa0, I fist install xmlto dpkg then after my 
usual:
 # make oldconfig
 # make V=1 vmlinux

I play with:
 # make htmldocs

which build the *.xml for the most but failed at the ending:
  DOCPROC Documentation/DocBook/kernel-api.xml

with following warnings and errors:
Warning(/CAD/linux-2.6.13-pa0-20050829/kernel/sched.c:1495): No description
found for parameter 'rq'
Use of uninitialized value in join or string at
/CAD/linux-2.6.13-pa0-20050829/scripts/kernel-doc line 369,  line 698.
Warning(/CAD/linux-2.6.13-pa0-20050829/mm/slab.c:2793): No description found
for parameter 'unused'
Warning(/CAD/linux-2.6.13-pa0-20050829/arch/i386/lib/usercopy.c): no
structured comments found
Warning(/CAD/linux-2.6.13-pa0-20050829/ipc/util.c:373): No description found
for parameter 'head'
Warning(/CAD/linux-2.6.13-pa0-20050829/ipc/util.c:390): No description found
for parameter 'head'
Warning(/CAD/linux-2.6.13-pa0-20050829/kernel/sysctl.c:2012): No description
found for parameter 'ppos'
Warning(/CAD/linux-2.6.13-pa0-20050829/include/linux/fs.h:1190): No
description found for parameter 'find_exported_dentry'
Warning(/CAD/linux-2.6.13-pa0-20050829/include/linux/fs.h:1190): No
description found for parameter 'find_exported_dentry'
Warning(/CAD/linux-2.6.13-pa0-20050829/include/linux/fs.h): no structured
comments found
Warning(/CAD/linux-2.6.13-pa0-20050829/kernel/irq/manage.c:31): No description
found for parameter 'irq'
Warning(/CAD/linux-2.6.13-pa0-20050829/kernel/irq/manage.c): no structured
comments found
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/pci.c:238): No description
found for parameter 'platform_pci_set_power_state'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/pci-driver.c:35): No
description found for parameter 'driver'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/pci-driver.c:35): No
description found for parameter 'buf'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/pci-driver.c:35): No
description found for parameter 'count'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/pci-driver.c:174): No
description found for parameter 'drv'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/pci-driver.c:174): No
description found for parameter 'pci_dev'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/pci-driver.c:416): No
description found for parameter 'drv'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/msi.c:598): No description
found for parameter 'entries'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/msi.c:598): No description
found for parameter 'nvec'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/hotplug.c): no structured
comments found
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/pci/probe.c:663): No
description found for parameter 'dev'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/driver.c:39): No
description found for parameter 'start'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/driver.c:76): No
description found for parameter 'drv'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/core.c:390): No
description found for parameter 'parent'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:75): No
description found for parameter 'class'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:75): No
description found for parameter 'buf'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:75): No
description found for parameter 'count'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:136): No
description found for parameter 'class_dev'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:136): No
description found for parameter 'buf'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:136): No
description found for parameter 'count'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:239): No
description found for parameter 'kobj'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:239): No
description found for parameter 'buffer'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:239): No
description found for parameter 'offset'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:239): No
description found for parameter 'count'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:404): No
description found for parameter 'firmware_p'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:404): No
description found for parameter 'name'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:404): No
description found for parameter 'device'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:462): No
description found for parameter 'fw'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_class.c:480): No
description found for parameter 'name'
Warning(/CAD/linux-2.6.13-pa0-20050829/drivers/base/firmware_