[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