linux-kernel - [linux-next] make xmldoc failed with commit d780c3711d9df9bac

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [day] [month] [year] [list]

Date:	Tue, 16 Feb 2016 22:51:58 +0900
From:	Masanari Iida <standby24x7@...il.com>
To:	kernel@...tin.sperl.org, broonie@...nel.org,
	"linux-kernel@...r.kernel.org" <linux-kernel@...r.kernel.org>,
	Jonathan Corbet <corbet@....net>,
	linux-doc <linux-doc@...r.kernel.org>, linux-spi@...r.kernel.org
Subject: [linux-next] make xmldoc failed with commit d780c3711d9df9bac

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 <kernel@...tin.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