Re: [PATCH 03/24] rcu/tree: Use consistent style for comments

From: Joe Perches
Date: Sun May 03 2020 - 20:34:42 EST


On Sun, 2020-05-03 at 17:23 -0700, Paul E. McKenney wrote:
> On Sun, May 03, 2020 at 07:44:00PM -0400, Joel Fernandes wrote:
> > On Fri, May 01, 2020 at 01:52:46PM -0700, Joe Perches wrote:
[]
> > > Perhaps a change to coding-style.rst
> > > ---
> > > diff --git a/Documentation/process/coding-style.rst b/Documentation/process/coding-style.rst
[]
> > > @@ -565,6 +565,11 @@ comments is a little different.
> > > * but there is no initial almost-blank line.
> > > */
> > >
> > > +.. code-block:: c
> > > +
> > > + // Single line and inline comments may also use the c99 // style
> > > + // Block comments as well
> > > +
> > > It's also important to comment data, whether they are basic types or derived
> > > types. To this end, use just one data declaration per line (no commas for
> > > multiple data declarations). This leaves you room for a small comment on each
> >
> > Yeah that's fine with me. This patch just tries to keep it consistent. I am
> > Ok with either style.
>
> My approach has been gradual change. Big-bang changes of this sort
> cause quite a bit of trouble. So I use "//" in new code and (sometimes)
> convert nearby ones when making a change.

I think that's good too.

Mixing styles in the same compilation unit is not
generally the right thing to do.

But right now, c99 comments are not specified as
allowed in coding-style so it's likely appropriate
to add something like this there.