make xmldocs on linux-next as of 16th/Feb, 2016 failed with error.
.//include/linux/spi/spi.h:932: error: Cannot parse struct or union!
.//drivers/spi/spi.c:2179: warning: No description found for parameter 'gfp'
.//drivers/spi/spi.c:2350: warning: No description found for parameter 'msg'
.//drivers/spi/spi.c:2350: warning: No description found for parameter 'maxsize'
.//drivers/spi/spi.c:2350: warning: No description found for parameter 'gfp'
.//drivers/spi/spi.c:2350: warning: Excess function parameter
'message' description in 'spi_split_transfers_maxsize'
.//drivers/spi/spi.c:2350: warning: Excess function parameter
'max_size' description in 'spi_split_transfers_maxsize'
.//drivers/spi/spi.c:2179: warning: No description found for parameter 'gfp'
.//drivers/spi/spi.c:2350: warning: No description found for parameter 'msg'
.//drivers/spi/spi.c:2350: warning: No description found for parameter 'maxsize'
.//drivers/spi/spi.c:2350: warning: No description found for parameter 'gfp'
.//drivers/spi/spi.c:2350: warning: Excess function parameter
'message' description in 'spi_split_transfers_maxsize'
.//drivers/spi/spi.c:2350: warning: Excess function parameter
'max_size' description in 'spi_split_transfers_maxsize'
make[1]: *** [Documentation/DocBook/device-drivers.xml] Error 2
make: *** [xmldocs] Error 2
$
git bisect pointed out the first bad commit as
d780c3711d9df9bacd56b71cf23443b895a331ca is the first bad commit
commit d780c3711d9df9bacd56b71cf23443b895a331ca
Author: Martin Sperl <ker...@martin.sperl.org>
Date: Mon Dec 14 15:20:18 2015 +0000
spi: core: added spi_resource management
SPI resource management framework used while processing a spi_message
via the spi-core.
Masanari Iida
