At 08:08 AM 3/8/01 -0800, Sam Linder wrote:
>I agree with both Olin and Scott regarding the level of documentation that
>should be present in both C and ASM programs. There should be an overall
>description of what the chunk of code is doing and there should also be line
>by line comments as necessary to help clarify what each part of the code is
>doing (especially in ASM). For my money, I would always rather have too many
>comments than not enough. Too many "guru's" out there think their code is so
>"self-documenting" that they are blind to the fact that no one else can
>initially understand it without a careful perusal of each line of code.


Written Chinese is also self-documenting. :)
--
Dave's Engineering Page: http://www.dvanhorn.org
Where's dave? http://www.findu.com/cgi-bin/find.cgi?kc6ete-9

--
http://www.piclist.com hint: PICList Posts must start with ONE topic:
[PIC]:,[SX]:,[AVR]: ->uP ONLY! [EE]:,[OT]: ->Other [BUY]:,[AD]: ->Ads