Re: [PATCH] Documentation: security/credentials.rst: explain need to sort group_list

From: Jonathan Corbet
Date: Mon Jan 08 2018 - 11:40:40 EST


On Mon, 08 Jan 2018 10:39:14 +1100
NeilBrown <neilb@xxxxxxxx> wrote:

> > There is value in using the c:func syntax, as it will generate
> > cross-references to the kerneldoc comments for those functions. In this
> > case, it would appear that these comments exist, but nobody has pulled
> > them into the docs yet. I took the liberty of adding :c:func: references
> > to this patch on its way into docs-next so that things will Just Work on
> > that happy day when somebody adds the function documentation.
>
> Is this the sort of thing that might result in that happy day?
> I didn't spend tooo much time on it, in case including the
> kernel-doc in credentials.rst like this was the wrong direction.

>From a very quick look, yes. I'll take a closer look soon. Life has been
a bit ... busy ... around here...

Thanks,

jon