home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #27 / NN_1992_27.iso / spool / comp / lang / cplus / 16603 < prev    next >
Encoding:
Text File  |  1992-11-19  |  1.5 KB  |  36 lines
  1. Newsgroups: comp.lang.c++
  2. Path: sparky!uunet!zaphod.mps.ohio-state.edu!sdd.hp.com!hpscit.sc.hp.com!scd.hp.com!hpscdm!hpuerca.atl.hp.com!sailer
  3. From: sailer@hpuerca.atl.hp.com (Lee Sailer)
  4. Subject: Re: Criticisms Wanted
  5. Message-ID: <BxznBF.ELu@hpuerca.atl.hp.com>
  6. Date: Fri, 20 Nov 1992 00:14:02 GMT
  7. References: <1e1cccINNbsc@terminator.rs.itd.umich.edu>
  8. Organization: Hewlett-Packard NARC Atlanta
  9. X-Newsreader: Tin 1.1.3 PL5
  10. Lines: 24
  11.  
  12. Paul Potts (potts@oit.itd.umich.edu) wrote:
  13. : In article <1992Nov13.060823.1358@BofA.com> dan@BofA.com (Dan Brockman) writes:
  14. : >In article <1992Nov11.175117.15325@bcrka451.bnr.ca> sjm@bcrki65.bnr.ca (Stuart MacMartin) writes:
  15. : >>
  16. : >Reading source code is hardly a crime.  He could be trying to fix the damned
  17. : >bug his benighted colleague wrote into the program.  He could be trying to 
  18. : >find the damned bug.  
  19. : 
  20. : If I could get by without doing it, I would certainly prefer it. The
  21. : programmers that wrote some of the classes I'm using might have been
  22. : making a lot of money, but they sure don't know how to write readable
  23. : code. The biggest reasons seem to be:
  24. : 
  25. )
  26.  
  27. I like reading the source.  But good documentation is very handy, too.
  28.  
  29. perhaps a good compromise is "literate programming".  In LP, the documentation
  30. and the code are the same thing.  As implemented by web, filters exist
  31. which convert the well-documented code to user readable documentation.  Other
  32. filters convert the same code into stuff the compiler can use.
  33.  
  34. lee
  35.  
  36.