Messages in this thread | | | From | andy.shevchenko@gmail ... | Date | Sat, 22 Jul 2023 00:37:31 +0300 | Subject | Re: [PATCH v2 6/8] iio: core: Fix issues and style of the comments |
| |
Fri, Jul 21, 2023 at 01:48:34PM -0700, Randy Dunlap kirjoitti: > On 7/21/23 10:00, Andy Shevchenko wrote:
...
> > - * Return: 0 for successful release > > + * Returns: 0 for successful release.
> As documented in Documentation/doc-guide/kernel-doc.rst: > The return value, if any, should be described in a dedicated section > named ``Return``. > > However, as you (and I) have found, "Returns:" also works as a section name.
Plural allowed for some section(s): '\s*(\@[.\w]+|\@\.\.\.|description|context|returns?|notes?|examples?)\s*:([^:].*)?$'
> Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Thank you!
-- With Best Regards, Andy Shevchenko
| |