Re: Comments vs. commit log

[Ludovic Courtès]

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’.