Re: [PATCH -next] certs: Fix some kernel-doc comments

From: David Howells
Date: Thu Mar 31 2022 - 08:56:22 EST


Yang Li <yang.lee@xxxxxxxxxxxxxxxxx> wrote:

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

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

David