From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752282AbcHNSf0 (ORCPT ); Sun, 14 Aug 2016 14:35:26 -0400 Received: from tex.lwn.net ([70.33.254.29]:42669 "EHLO vena.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750745AbcHNSfY (ORCPT ); Sun, 14 Aug 2016 14:35:24 -0400 Date: Sun, 14 Aug 2016 12:35:23 -0600 From: Jonathan Corbet To: Joe Perches Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH] CodingStyle: Remove "Don't use C99-style comments" Message-ID: <20160814123523.26ae4b40@lwn.net> In-Reply-To: <1470333314.3998.245.camel@perches.com> References: <9a191e42dbdfaff2835f5f815fd5413815bba0fd.1468369072.git.joe@perches.com> <1470333314.3998.245.camel@perches.com> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Thu, 04 Aug 2016 10:55:14 -0700 Joe Perches wrote: > > Because Linus may still be reading source code on greenbar paper > > instead of color terminals with code syntax highlighting and > > appropriate font decorations. > > > > Link: http://lkml.kernel.org/r/CA+55aFyQYJerovMsSoSKS7PessZBr4vNp-3QUUwhqk4A4_jcbg@mail.gmail.com > > > > Signed-off-by: Joe Perches > > --- > >  Documentation/CodingStyle | 3 --- > >  1 file changed, 3 deletions(-) > > > > diff --git a/Documentation/CodingStyle b/Documentation/CodingStyle > > index 9a70ddd..19b2e9c 100644 > > --- a/Documentation/CodingStyle > > +++ b/Documentation/CodingStyle > > @@ -461,9 +461,6 @@ When commenting the kernel API functions, please use the kernel-doc format. > >  See the files Documentation/kernel-doc-nano-HOWTO.txt and scripts/kernel-doc > >  for details. > >   > > -Linux style for comments is the C89 "/* ... */" style. > > -Don't use C99-style "// ..." comments. > > - > >  The preferred style for long (multi-line) comments is: > >   > >   /* > > ping? Sorry, I've not been ignoring this, I've just not yet worked up the courage to apply it. Yes, Linus said he's fine with C++-style comments, but I still expect some pushback when people start actually sending them. I don't quite feel a sense of community consensus on this one. Still, what the heck, I'll go ahead and apply it. We can always revert it when people start screaming :) jon