make htmldocs errors

[Peter Teoh]

"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
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/