CS> all the source code had 
CS> been written by programmers who appeared to have the idea 
CS> that comments were for identifying who wrote the code and 
CS> to put arbitrary version numbers on each file.  Obviously 
CS> knowing that a file had been at version 0.2, and then 0.21, 
CS> and then 0.25 is really useful information.  But comments 
CS> shouldn't be used for anything else. Certainly noting what 
CS> each function does should not be done, and identifying the 
CS> purpose of parameters and variables is obviously heresy.  
CS> It left me wondering why they stooped to occasionally use 
CS> intelligible variable names -- why not just put everything 
CS> in some cipher code.

The C Set ICLUI samples are my idea of well-commented code.
Just cycled thru all 6 to make sure LINK386 works now. The
READMEs as a global comment are nice, too. I'm not big on the
version lineage and commented mod. lines, but that is a unique
requirement of the tutorial aspect of the IBM code.

___
 X KWQ/2 1.2e X Dr. Schrodinger! It's the humane society...

--- Maximus/2 2.02