I personally like flowcharts better than commenting, because
if the program is to be rewritten, the author has a choice of
languages to use.

What happens is that a company has a great programmer that
did a fine job. Say he did his work in MPASM. Now that guy
retires (or moves because his wife, a doctor, makes the REAL
bucks in the family) and it is almost impossible to find someone
that writes MPASM to replace him.

See what I mean? Flowcharts beat the TAR out of comments, every
day of the week.

I use WIZFLOW, a very inexpensive, bugless program. Used
Visio in the past, but it became too fluffy and expensive when
$MS took it over.

--Bob A
-- 
http://www.piclist.com PIC/SX FAQ & list archive
View/change your membership options at
http://mailman.mit.edu/mailman/listinfo/piclist