Re: [RFC PATCH 3/5] kobject: Fix kernel-doc comment first line

From: Jonathan Corbet
Date: Fri May 03 2019 - 08:23:53 EST


On Thu, 2 May 2019 18:46:16 -0700
Randy Dunlap <rdunlap@xxxxxxxxxxxxx> wrote:

> I have seen this discussion before also. And sometimes it is not even
> a discussion -- it's more of an edict. To which I object/disagree.
> The current (or past) comment style is perfectly fine IMO.
> No caps needed. No ending '.' needed.

For however much this matters...I really don't see that there needs to be
a rule one way or the other on this; the documentation serves its purpose
either way. I guess I see it like "British or American spelling";
there's nothing to drive a conversion in either direction.

jon