After a little while away from the forums, here I''m back. Probably you won''t notice it at all .

When I code, I use to comment not using "We" nor "I" but the phrase "Simon says".

For example:

// Simon says it will load a bitmap

Or:

// Simon says I''m the hell crazy

But as lately I''m coding alone, Simon can''t tell me nothing at all (or I can''t hear him) so I''m now commenting this way:

// Simon would say it will load a bitmap

Nah, the true is that I always write code as if somebody else was going to read it. That helps me to keep it clear, and it''s always useful to write nice looking code when you are doubtful about if you will release the sources sometime.

About the "We" and "I" in the code, when I write them I mean the following:

"I": meaning what I was trying to do when coded some stuff
"We": the same, but hiding the egocentrical "I" a bit. If you ask a writer why does he write things like "Now let us explain" he''ll tell you that it''s a way to be humble while showing an opinion or action of himself.

Some time before I used to write jokes (most of them very inner and obscure ones) in the commentaries, but when it was coming to be more jokes than real code I decided to stop.


--DK
--H. Hernán Moraldo

Hey, I just comment the code how the voices in my head tell me to.

"There is humor in everything depending on which prespective you look from."

Me, I rarely (if ever) comment my code, for two very good reasons:

1) My self-imposed Doctrine (see my signature), and
2) I usually work alone, and I have a knack for reaading code...most of the time, anyway

When I do comment, though, I do it only in two situations: when I''m using some dumbass shortcut to speed things up (bit shifts instead of math and crap like that), in which case I use the cold, impersonal comment to clarify what I did:

// same as multiplying nWidth by nFactor

Or, if there''s a big chunk of code that''s genuinely confusing - especially hacks and kludges - I''ll comment in full sentences and whatever the hell perspective I choose:

// This _should_ set everything up properly, but I''m not
// sure - better check for kludge-ness ASAP.

I never, ever use we, or us, though... not since the accident... *peers around the room*

-Normie


I am a devout follower of the
"Lazy Programmer''s Doctrime"(tm)...
and I''m damned proud of it, too!
-----
"I came, I saw, I started making
games." ... If you''ll excuse
me, I must resume my search
for my long lost lobotomy stitches.

You aren''t alone... I''m posting from inside your house! Mwahahahaha!

I only post short comments as:

  //Tile animation//Should never come to this point//If go under the playfield - Player should die  

And then I have many //checks this & that
But I often write it in my own dialect(a swedish one)

/MindWipe

"If it doesn''t fit, force it; if it breaks, it needed replacement anyway."