Re: [PATCH] kernel-doc: Handle returning pointers to pointers

From: Jonathan Corbet
Date: Thu Jan 26 2017 - 17:25:20 EST


On Mon, 23 Jan 2017 00:18:10 -0800
Matthew Wilcox <mawilcox@xxxxxxxxxxxxx> wrote:

> Clearly nobody ever tried to build the documentation for the radix tree
> before:
>
> include/linux/radix-tree.h:400: warning: cannot understand function
> prototype: 'void ** radix_tree_iter_init(struct radix_tree_iter *iter,
> unsigned long start) '
>
> Indeed, the regexes only handled a single '*', not one-or-more. I have
> tried to fix that, but now I have perl regexes all over my hands, and
> I fear I shall never be clean again.

Applied, thanks.

About your hands, try Dr Bronner's soap; at least, that's what I use for
bicycle grease. What might be harder to shake is your new reputation as
somebody who knows how to fix the kernel-doc script...:)

jon