Relay-Version: version B 2.10 5/3/83; site utzoo.UUCP Posting-Version: version B 2.10.1 ggr 10/28/83; site pyuxbb.UUCP Path: utzoo!linus!decvax!harpo!eagle!allegra!alice!rabbit!pyuxbb!ram From: ram@pyuxbb.UUCP (R Allan Muller) Newsgroups: net.lang Subject: Re: Forced Commenting - (nf) Message-ID: <309@pyuxbb.UUCP> Date: Mon, 9-Jan-84 13:07:41 EST Article-I.D.: pyuxbb.309 Posted: Mon Jan 9 13:07:41 1984 Date-Received: Tue, 10-Jan-84 02:10:06 EST References: <1323@pur-ee.UUCP> Organization: AT&T Bell Laboratories, Piscataway Lines: 8 I find that a printed copy of a program is essential for maintaining large software systems. A visual editor gives a good view of a small portion of a routine; however, it does not show a whole routine at one glance. I believe that programs should be formatted for presentation on paper. Comments can then be placed in line or set off by white space as appropriate. Programs that are formatted for a screen tend to be too compact for my taste; needed documentation is eliminated to allow the program to fit on a screen.