Re: [Xen-devel] [PATCH] CODING_STYLE: Allow single-sentence comments without full stops

[George Dunlap <george.dunlap@xxxxxxxxxx>]

On 04/08/16 11:09, Jan Beulich wrote:
>>>> On 04.08.16 at 11:37, <george.dunlap@xxxxxxxxxx> wrote:
>> --- a/CODING_STYLE
>> +++ b/CODING_STYLE
>> @@ -93,7 +93,9 @@ Comments
>>  
>>  Only C style /* ... */ comments are to be used.  C++ style // comments
>>  should not be used.  Multi-word comments should begin with a capital
>> -letter and end with a full stop.
>> +letter.  Comments containing a single sentence may end with a full
>> +stop; comments containing several sentences must have a full stop
>> +after each sentence.
> 
> If we no longer demand a full stop, why would we demand an upper
> case letter at the start?

Because that "looks right" to me; and indeed, if you look at images of
flow charts, you'll find that they all start with a capital letter.

 -George


_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxx
https://lists.xen.org/xen-devel