home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #31 / NN_1992_31.iso / spool / alt / usage / english / 10116 < prev    next >
Encoding:
Internet Message Format  |  1992-12-29  |  1.3 KB
  1. Path: sparky!uunet!pipex!bnr.co.uk!uknet!edcastle!edcogsci!iad
  2. From: iad@cogsci.ed.ac.uk (Ivan A Derzhanski)
  3. Newsgroups: alt.usage.english
  4. Subject: Re: Comments in source code
  5. Message-ID: <12221@kesson.ed.ac.uk>
  6. Date: 29 Dec 92 14:05:32 GMT
  7. References: <1992Dec29.060209.17732@g2syd.genasys.com.au>
  8. Organization: Centre for Cognitive Science, Edinburgh, UK
  9. Lines: 19
  10.  
  11. In article <1992Dec29.060209.17732@g2syd.genasys.com.au> roberts@g2syd.genasys.com.au (Robert Swan) writes:
  12. [re comments in C and FORTRAN source code]
  13. <[...] in the newer code, comments tend to be complete sentences and
  14. <(here's the part that interests me) speak in terms of the 1st person
  15. <plural ...  `We need to get the filename', `We can't proceed unless it's
  16. <the right type'.  [...]
  17. <
  18. <Who are `we'.  Me and my program?  Me and the other programmers?
  19. <The royal we (since I am creator of the universe in my program,
  20. <I suppose I could put on royal airs)?
  21.  
  22. I perceive it as the so-called author's "we", standing for `I and my
  23. readers'.  Recall that programs are written to be read by humans.
  24.  
  25. -- 
  26.  `D'ye mind tellin me whit the two o ye are gaun oan aboot?' (The Glasgow
  27. Ivan A Derzhanski  (iad@cogsci.ed.ac.uk; iad@chaos.cs.brandeis.edu)    Gospel)
  28. * Centre for Cognitive Science,  2 Buccleuch Place,  Edinburgh EH8 9LW,  UK
  29. * Cowan House, Pollock Halls, 18 Holyrood Park Road, Edinburgh EH16 5BD, UK
  30.