Re: Comments (Was: [PHP-DEV] coding standard addition proposal)

Marcus Börger wrote:

At 19:01 11.08.2002, Markus Fischer wrote:

On Sun, Aug 11, 2002 at 11:31:33AM -0400, Dan Kalowsky wrote :

Looking over the commit by Marcus on gd I noticed the #if 0 section on some code. I'd like to propose that the coding standard be updated to NOT do this, but to do something like "#if 0_KALOWSKY" to make life easier for all running through the code. Yeah I know, you can look in the cvs logs to see who did it, but it makes life a little easier I think to do go with the proposed method. Any +/-1s on this idea?

I'm 0 for this. Since looking up log(annotate) is very easy. If you are using Emacs, Ctrl-x v g other editor users may have harder time, though.

    +1

    Generally I think there are far too less comments on the code
    (here being exception of course).

    - Markus

And sometimes i feel guilty when extending code size by comments. In other words: Code Implementation ------------------- [0] Document your code.

I think much more comment in source is preferred, too. -- Yasuo Ohgaki