Re: function Is_Open (File : File_Type) return Boolean; :Text_io

[Jacob Sparre Andersen <sparre@nbi.dk>]

AdaMagica <christ-usch.grein@t-online.de> writes:

> What is *excessive* commenting?

All comments are in my view excessive. - That doesn't mean that they
aren't occasionally necessary, but the ideal must in my view be that
what we pass to the compiler is also what we ask the programmer to read.

If I have to put comments in my sources I see it as me not being a good
enough programmer to express what I want to do in a way my colleagues
understand.

I'm not against documentation, but I really don't like in-source
comments.

The kind of comments which make sense to me are those which contain a
reference to a detailed explanation of why something is done the way it
is.  I.e. a reference to a mathematical statement, a paper describing an
algorithm or a performance analysis of two competing algorithms.

Greetings,

Jacob
-- 
Why is it that all of the instruments seeking intelligent
life in the universe are pointed away from Earth?