Path: utzoo!utgpu!jarvis.csri.toronto.edu!mailrus!uwm.edu!uakari.primate.wisc.edu!aplcen!haven!ncifcrf!nlm-mcs!adm!xadmx!JZEM%MARIST.BITNET@cunyvm.cuny.edu
From: JZEM%MARIST.BITNET@cunyvm.cuny.edu (William J. Joel)
Newsgroups: comp.lang.pascal
Subject: Re: Indenting
Message-ID: <21061@adm.BRL.MIL>
Date: 5 Oct 89 13:13:33 GMT
Sender: news@adm.BRL.MIL
Lines: 19

I've been listening to this discussion for about a week and I think I
can boil down the reasons for good indenting to one concept:  Source
code should be readable!

What this means is that the structures inhearant (sp?) in the code should
be readily apparent.  One should not need to work through the code to
figure out what's there.  Techniques to improve readability include
indenting as well as comments, line spacing, breaking up of variable
declaerations to create variable tables, etc.  The point for students
is not to force them to learn a single method of indenting but to make
sure that they learn how to make their source code readable.


+--------------------------------------------------------------------------+
+        The proofs are easy.  It's the theorems that are hard!            +
+--------------------------------------------------------------------------+

Bill Joel
jzem@marist.bitnet