linux kernel "make xmldocs" fails

[Björn Schließmann]

Binary package hint: linux-source

After unpacking /usr/src/linux-source-2.6.29 from package linux-source 2.6.31.19.32, I tried to build the documentation, but "make xmldocs" fails with an error. For complete output see attached file.

Error(/home/chronoss/kernel/linux-source-2.6.31//drivers/scsi/scsi_transport_fc.c:503): cannot understand prototype: 'atomic_t fc_event_seq; '
[...]
make[1]: *** [Documentation/DocBook/scsi.xml] Error 1
make: *** [xmldocs] Error 2

[Andy Whitcroft (apw)]

[This is an automated message. Apologies if it has reached you inappropriately.]

This bug was reported against the linux-meta package when it likely should have been reported against the linux package instead. We are automatically transitioning this to the linux kernel package so that the appropriate teams are notified and made aware of this issue.

If this bug really is a bug in the linux-meta package you can move it back to linux-meta and tag it kj-linux-meta, or contact us on the #ubuntu-kernel channel on the FreeNode IRC server. Thanks.

[squizzar (jfsibley)]

I got the same thing with "make mandocs" on 2.6.31-20-generic. There is a fix, as described on:
http://irclogs.ubuntu.com/2008/10/27/%23ubuntu-kernel.txt
Basically in linux-source-2.6.31/drivers/scsi/scsi_transport_fc.c, edit line 499 replacing /** with /*

AFAIK this makes no functional change, it's just that docbook gets confused by the /**

[Brad Figg (brad-figg)]

This bug is missing log files that will aid in diagnosing the problem. From a terminal window please run:

apport-collect 517735

and then change the status of the bug to 'Confirmed'.

If, due to the nature of the issue you have encountered, you are unable to run this command, please add a comment stating that fact and change the bug status to 'Confirmed'.

This change has been made by an automated script, maintained by the Ubuntu Kernel Team.