[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: Comments vs. commit log
From: |
Ludovic Courtès |
Subject: |
Re: Comments vs. commit log |
Date: |
Fri, 30 Sep 2011 14:48:57 +0200 |
User-agent: |
Gnus/5.110018 (No Gnus v0.18) Emacs/24.0.90 (gnu/linux) |
Hi!
Andy Wingo <address@hidden> skribis:
> On Tue 27 Sep 2011 22:43, address@hidden (Ludovic Courtès) writes:
>
>> Would it be possible to move the explanations from the commit log to
>> comments in the code?
>>
>> Looking at the above code, I have no idea what a var-table or a counter
>> is, what it’s used for, etc.
>
> Sure. I forget sometimes, because I've read that Waddell & Dybvig paper
> so many times that I forget it's not written down in the source ;)
I wonder what the GCC hacker community would be like if its source code
wasn’t commented. :-)
Seriously though, I think that pointing to the paper would be nice, but
the paper is higher-level than the actual implementation, so comments
could fill in the gap.
Thanks,
Ludo’.