From: utzoo!decvax!harpo!esquire!cmcl2!philabs!sdcsvax!davidson Newsgroups: net.misc Title: Re: A hacker by any other name .... Article-I.D.: sdcsvax.2077 Posted: Fri Jun 11 09:38:05 1982 Received: Sun Jun 13 01:23:05 1982 References: watmath.2566 John Winterton suggests that it is improper for the documentation of a program to simply be its listing. I am unclear as to whether he means the user documentation or the maintainers documentation. If the former, then I certainly agree; however, if he means the latter, then I think that his view is only sometimes correct. A code of a good programmer, writing in a decent high level language (e.g., Pascal, Modula-2, even Ada and LISP [augmented with appropriate macros]) is self documenting, and has the virtue that it always correctly describes the current version of the program. -Greg Davidson