home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #30 / NN_1992_30.iso / spool / comp / software / 4946 < prev    next >
Encoding:
Text File  |  1992-12-14  |  1.2 KB  |  34 lines
  1. Newsgroups: comp.software-eng
  2. Path: sparky!uunet!stanford.edu!rock!concert!seq!herbst
  3. From: herbst@seq.uncwil.edu (R.T. Herbst)
  4. Subject: C Code Layout
  5. Message-ID: <1992Dec14.193111.20367@seq.uncwil.edu>
  6. Keywords: C Code
  7. Organization: Univ. of North Carolina @ Wilmington
  8. Date: Mon, 14 Dec 1992 19:31:11 GMT
  9. Lines: 23
  10.  
  11. From the comments on commenting I ferl that I should 
  12. clarify my background.
  13. One I spent 25 years a Bell Telephone Laboratories
  14. Two I was involved in large and small projects. 
  15. Three I am now a professor on mathematical sciences at UNCW.
  16. four I teach software engineering.
  17. five I once wrote a 1000 line SAP program for the IBM 704.
  18.     The program had no comments even my name was missing.
  19.     Months later i picked up the listing and asked 
  20.     "Who wrote this mess"
  21.     This was a long time ago-- circa 1958.
  22.     I learned my lesson. Comments are essential.
  23.     Comments that obscure the code can make
  24.     reading the code very difficult. 
  25.     The code is where the actions is.
  26.     C language permits alongside commenting
  27.     So comment along side the code.
  28.     This allows the code to be continuous.
  29.     Well commented code is needed, but
  30.     Commenting is a small part of the entire process.
  31.     I doubt that there will ever be a agreement on this
  32.     subject. So what.
  33. herbst@seq.uncwil.edu
  34.