[cairo] Re: [cairo-commit] src/cairo-xcb-surface.c

Behdad Esfahbod behdad at behdad.org
Tue Oct 17 11:28:34 PDT 2006


On Tue, 2006-10-17 at 11:11 -0400, Ian Osgood wrote:
> 
> +#include "cairo-clip-private.h"        /* XXX */ 

When committing to cairo please avoid comments like this :).  If there
is something you want to remind the reader here, you really should also
write what it is.  You are not the only one reading the code later.  In
fact, in the long run, you definitely are not the one who needs to be
able to understand the comment!

Thanks,

-- 
behdad
http://behdad.org/

"Commandment Three says Do Not Kill, Amendment Two says Blood Will Spill"
        -- Dan Bern, "New American Language"



More information about the cairo mailing list