Re: Ada's Assembly Language Comments

[dewar@merv.cs.nyu.edu (Robert Dewar)]

Peter Herman said

<<HOWEVER(!) there is no means of further enclosing like

    /*  surrounding text  /*  original text  */   surrounding text */

(as the syntax might suggest at first glance)
because the FIRST appearance of    */     will end all commentary.
I consider this paradoxon another unacceptable immaturity,
like so many others.
>>



More entertaining still is that dividing things by dereferenced values is
quite hazardous in C:

      x = a+b/*c;

and of course is made more hazardous by the fact that comments extend
over multiple lines.

Like most other things in Ada, the comment choice was not casual, the
decisions are very deliberate, and indeed this particular choice was
not a particularly controversial one, I think the arguments are
rather persuasive that block comments do NOT help the reader.

Sure they help the writer by requiring fewer keystrokes in the editor,
but the design of Ada does not care much about convenience to the
writer, it is dedicated to making the life of the code reader easier.

In Ada, if you see

    X := 3;

you know it is an assignment statement, you do not have to search
arbitrarily large amounts of surrounding text to see if perhaps it
might be a comment after all.

Even those people who do a lot of code writing do more code reading,
and appreciate this bias (even when they are reading their own code :-)