On Tue, 3 Feb 2015, Bjørn Mork wrote:
"Robert P. J. Day" <rpjday@crashcourse.ca> writes:
actually, i just found where this is a known issue:
Probably because it's a rare construct.
But looking closer at this, trying to understand why the simple test using
scripts/kernel-doc lib/crc32.c |man -l -
seemed to sort of work, I found that your main problem isn't really the lack of kernel-doc support for array pointer parameters. It's a simple mismatch between the documented and the exported functions.
scripts/docproc will only generate docs for exported symbols. lib/crc32.c has no documented *and* exported functions, and thats why the output is empty. The array pointer is a red herring.
ah, good point, i had totally missed that. i'll move this discussion to the linux-doc list and resolve it there. rday -- ======================================================================== Robert P. J. Day Ottawa, Ontario, CANADA http://crashcourse.ca Twitter: http://twitter.com/rpjday LinkedIn: http://ca.linkedin.com/in/rpjday ========================================================================