Messages in this thread | | | Date | Tue, 22 Jul 2008 19:07:59 +0800 | From | "Peter Teoh" <> | Subject | make htmldocs errors |
| |
"make htmldocs" generated the following errors:
Warning(/sda4/download/linux_linus/linux-2.6//include/asm-x86/unaligned.h): no structured comments found Warning(/sda4/download/linux_linus/linux-2.6//kernel/rcupdate.c:81): No description found for parameter 'synchronize_rcu' Warning(/sda4/download/linux_linus/linux-2.6//kernel/rcupdate.c:81): No description found for parameter 'call_rcu' Error(/sda4/download/linux_linus/linux-2.6//drivers/pci/pci.c:1133): duplicate section name 'Description' Error(/sda4/download/linux_linus/linux-2.6//drivers/pci/pci.c:1189): duplicate section name 'Description' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'id' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'attach_adapter' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'detach_adapter' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'detach_client' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'probe' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'remove' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'shutdown' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'suspend' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'resume' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'command' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'driver' Warning(/sda4/download/linux_linus/linux-2.6//include/linux/i2c.h:169): No description found for parameter 'id_table' make[1]: *** [Documentation/DocBook/kernel-api.xml] Error 2 make: *** [htmldocs] Error 2
Can someone explain what is the cause of the error? Is it because "make htmldocs" attempt to detect for description marked as "/* */" beside the field name?
Thank you. -- Regards, Peter Teoh
| |