Most Efficient Symbol/Letter for Separating Text

Miscellaneous Forums/General Discussion/Most Efficient Symbol/Letter for Separating Text

The forum is locked. These are the original blitzbasic.com forums, kept so they can still be read. No new topics, replies or edits can be made here. To join in, head over to the Blitz3D+ forums.

I agree with CS_TBL, there's no use in commenting code that is so easily readable. But at the same time, what the code is doing isn't always clear. Line-by-line, there's no point in having comments. But the big picture, that's where commenting is usually needed. You may be able to figure out that such-and-such code sorts out a list, for example, but what kind of order is it in? And why are we sorting it to begin with? Those kinds of comments are what's needed.

Even if code is designed to be modular, I still think the code must be commented. The comments will never be needed if the module works exactly how it's supposed to. But what if there are bugs, or if the module has to be modified to work with new problems? Comments in the code will definately help matters here.

Comments are there to be your friend, but you shouldn't over-do them, as they'll be more of a nuisance then. Everything in moderation. :)