[ovs-dev] [PATCH 2/2] vlog: Change the default timestamp structure.

Ben Pfaff blp at nicira.com
Fri Jan 27 22:43:14 UTC 2012


On Fri, Jan 27, 2012 at 02:15:18PM -0800, Ethan Jackson wrote:
> However, the CodingStyle document says to write comments the way that
> you've done in this patch.  Ben, is there a particular reason for the
> way the CodingStyle document says to write block comments?  If not,
> I'd be inclined to change it to what we typically have done throughout
> the code.

Minor variants in comment style, like whether the /* and */ are on
lines by themselves, just don't bother me much, which is why
CodingStyle says, "You may put the /* and */ on the same line as
comment text if you prefer."  I normally write them on the same line,
so that's probably why a lot of comments are written that way.

I do prefer full sentences that start with capital letters and end
with punctuation, though.



More information about the dev mailing list