General information
Category:
Coding, syntax & commands
>Paul,
>
>>Seems comments cause all sorts of problems, it's probably best to avoid using them.
>
>ROFL! (You are kidding, right?)
Of course, I think.
Though over the years some of my worst problems have been due to the presence of comments, rather than the lack of them. There's a tendency to believe the comments rather than the code & I've found that many programmers (not me, honest!), in the heat of the moment of fixing a bug, are likely to disregard updating the comments as well as fixing the bug.
Some years ago, my company required a C library to access FoxPro databases, one of the requirements was provision of source code. A short while into the project, a problem was found with the library chosen & due to the response time of the company involved, we looked at the code ourselves only to find no comments. On complaining about the stripping of comments, we were told that the company policy was not to use comments at all - it gave an incentive for their programmers to fully understand all of the code written by the company.
I had another programmer working for me who presented code with apparently no comments - when I complained he showed me the comments were there, they were just written off screen, because they made the code look untidy.
Enough horror stories about comments.
USE THEM & KEEP THEM WELL MAINTAINED.
Previous
Next
Reply
View the map of this thread
View the map of this thread starting from this message only
View all messages of this thread
View all messages of this thread starting from this message only