From mboxrd@z Thu Jan 1 00:00:00 1970 From: ron@ronnatalie.com (Ron Natalie) Date: Wed, 21 Mar 2018 16:48:35 -0400 Subject: [TUHS] Comments in early Unix systems In-Reply-To: <20180321202810.GA6280@minnie.tuhs.org> References: <20180321141753.25C4418C088@mercury.lcs.mit.edu> <6c6699c0-15db-604a-181c-7dad282599e1@kilonet.net> <20180321202810.GA6280@minnie.tuhs.org> Message-ID: <012b01d3c155$fb931e20$f2b95a60$@ronnatalie.com> > Given that the comments never made it into the compiled code, there was no space reason to omit comments. There must have been another reason. Attitudes in software engineering have changed a lot over the 60 years we've been programming. Actually, UNIX was better than a lot of OS sources I've dealt with. Further, you had disk space and compile time issues to worry about. Amusingly, I worked with Mike Muuss for years (first at JHU and then at BRL). Mike believed much in putting comments on everything. The DMR "You're not expected to understand this" comment incensed him so much (yes I know that's not what DMR meant) that he wrote an entire page to explain just what retu/aretu/setka6 were doing there. Amusingly, Mike was further incensed when Mike submitted a bunch of revisions to BSD and McKusick, in the name of maintaining a uniform commenting style, deleted all the comments. I guess NONE is pretty consistent. While this next anecdote strays from UNIX, I worked on a project my first job out of college on a database system written in Fortran and Macro 11 on a two-system RSX-11M+ system. One of the early projects there was to write a program that counted "lines of code" to report to the customer progress or something. The head of software came up to the head database programmer (not me) and said, "Do you know that we ran our line counter on your modules and it said that there is only one line of comments in your entire module). Jerry pointed out their software had to be in error, there weren't any lines of comments. In fact, a closer examination noted it counted one of the MACRO-11 directives (.TITLE or something like that) as a comment. In Jerry's defense, there were comments in the code, just not lines that were only comments. They were just put at the end of the lines of existing instructions.