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

[Ian Jackson <ian.jackson@xxxxxxxxxxxxx>]

George Dunlap writes ("[PATCH] CODING_STYLE: Allow single-sentence comments 
without full stops"):
> One of the common ways in which contributors trip up over the
> CODING_STYLE guides is by not putting a full stop at the end of a
> comment when there is only a single sentence.  Calling these out is a
> waste of everybody's time: The full stop at the end of a comment with
> a single sentence (or a single phrase) adds absolutely nothing to the
> legibility of the code.
> 
> Modify CODING_STYLE to allow comments with a single sentence or
> sentence fragment to either have a full stop or not, while making it
> clear that comments with multiple sentences must have a full stop at
> the end of each sentence.
> 
> Signed-off-by: George Dunlap <george.dunlap@xxxxxxxxxx>

Seriously ?

Yes, the bike shed can be purple with occasional mauve.

Acked-by: Ian Jackson <ian.jackson@xxxxxxxxxxxxx>

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