IsForth

Comments

Commenting source code is a forgotten art form. Modern coders seem to think that the code is and of itself enough of an explanation for what it is intended to do. While well written code is of prime importance, NO code is ever self explanitory to all people.

Some elitists feel that if the code was difficult to write (and it always is) then it should be difficult to read and that if you are "Too Stupid" to understand the code wtihout comments then you should not be looking in the source files.

The entire Linux kernel source tree has been written with this holier than thou attitude and in my opinion makes the entire Linux kernel source tree a classic example of some very badly written code. Im sure the code is very good at its job but it is still bad code simply for being almost completely devoid of comments.

In this project I have tried to comment everything. I have tried to make my code readable and understandable by anyone who takes an interest in it. There is nothing within any source file that is so top scret that YOU do not deserve to understand it.