Subject: Re: Theories on why Lisp source *seems* to have less comments?
From: (Rob Warnock)
Date: Sat, 22 Jul 2006 05:36:35 -0500
Newsgroups: comp.lang.lisp
Message-ID: <>
Tim X  <> wrote:
| My experience has been that most code comments are next to useless.
| How often do you see something like
|     x = 10        // set x to 10
| Maybe slightly exaggerated, but you get the idea.

Far too often, unfortunately.

The TOPS-10 5-Series Monitor Coding Conventions (LEVELD.MEM)
prescribed a comment on every line [but this *was* all in
assembler, after all!]. But the rule was that you *never* used
the comment to describe *what* an instruction did -- the reader
is presumed to know the language in question -- but *why* the
instruction (or short sequence of instructions) was being used,
or other higher-level information such as particularly tricky


Rob Warnock			<>
627 26th Avenue			<URL:>
San Mateo, CA 94403		(650)572-2607