I suggest (as I have before) that each non-trivial comment be sign and
dated. That way
if there is a discrepancy between the comment and the program, the
reader has the
benefit of the information that the document writing was done after the
program and may be
WRONG.
This is the same for changes in the program. Not everyone is going to
look in the CVS
for authors or for changes etc.
RJF