Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::1:20 as permitted sender) client-ip=2620:137:e000::1:20;
Organization: Red Hat UK Ltd. Registered Address: Red Hat UK Ltd, Amberley
        Place, 107-111 Peascod Street, Windsor, Berkshire, SI4 1TE, United
        Kingdom.
        Registered in England and Wales under Company Registration No. 3798903
From:   David Howells <dhowells@redhat.com>
In-Reply-To: <20220317021249.31655-1-yang.lee@linux.alibaba.com>
References: <20220317021249.31655-1-yang.lee@linux.alibaba.com>
To:     Yang Li <yang.lee@linux.alibaba.com>
Cc:     dhowells@redhat.com, dwmw2@infradead.org, keyrings@vger.kernel.org,
        linux-kernel@vger.kernel.org, Abaci Robot <abaci@linux.alibaba.com>
Subject: Re: [PATCH -next] certs: Fix some kernel-doc comments
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-ID: <3118063.1648731366.1@warthog.procyon.org.uk>
Content-Transfer-Encoding: quoted-printable
Date:   Thu, 31 Mar 2022 13:56:06 +0100
Message-ID: <3118064.1648731366@warthog.procyon.org.uk>
Precedence: bulk

Yang Li <yang.lee@linux.alibaba.com> wrote:

>  /**
> - * Allocate a struct key_restriction for the "builtin and secondary tru=
st"
> - * keyring. Only for use in system_trusted_keyring_init().
> + * get_builtin_and_secondary_restriction - Allocate a struct key_restri=
ction
> + * for the "builtin and secondary trust" keyring. Only for use in
> + * system_trusted_keyring_init().
>   */
>  static __init struct key_restriction *get_builtin_and_secondary_restric=
tion(void)

Better to just turn the "/**" into "/*" for this one.  It's not a function
that should necessarily appear in API docs.

David