home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #30 / NN_1992_30.iso / spool / comp / software / 4897 < prev    next >
Encoding:
Internet Message Format  |  1992-12-12  |  1.3 KB
  1. Path: sparky!uunet!ogicse!emory!gatech!concert!seq!herbst
  2. From: herbst@seq.uncwil.edu (R.T. Herbst)
  3. Newsgroups: comp.software-eng
  4. Subject: C code Layout
  5. Keywords: C code layout
  6. Message-ID: <1992Dec12.122453.8582@seq.uncwil.edu>
  7. Date: 12 Dec 92 12:24:53 GMT
  8. Article-I.D.: seq.1992Dec12.122453.8582
  9. Organization: Univ. of North Carolina @ Wilmington
  10. Lines: 16
  11.  
  12. While directing the eforts of 125 people in producing the 
  13. A Data switching system for the Bell System- Good ol'
  14. Ma bell-- I asked for a sample of code. I founr the comments to
  15. be utter nonsense,. If one removed the code, the comments made no sense.
  16. It was better to let the code speak for itself. If fact the code
  17. was hidden in by the comments. Certainly we need well commented code.
  18. Too many comments that try to say what the code is saying are IMHO
  19. distracting. The code in this case was assembler. Since that time
  20. higher level languages came into use. In particular C language.
  21. My philosophy is to let the language speak for itself. Add comments
  22. where necessary. Again while directing the efforts of hundreds of
  23. people on the Safequard Anti-Balistic Missile System, we set standards
  24. for commenting that let the code be seen. The project met its objectives
  25. and schedule -- one of the few in that time frame. 
  26. Flame on and damned be he or she who flames out.
  27. herbst@seq.uncwil.edu
  28.