From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00
	autolearn=unavailable autolearn_force=no version=3.4.4
Path: 
 eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!news.eternal-september.org!mx02.eternal-september.org!feeder.eternal-september.org!gandalf.srv.welterde.de!news.jacob-sparre.dk!loke.jacob-sparre.dk!pnx.dk!.POSTED!not-for-mail
From: Jacob Sparre Andersen <sparre@nbi.dk>
Newsgroups: comp.lang.ada
Subject: Re: function Is_Open (File : File_Type) return Boolean; :Text_io
Date: Fri, 30 Oct 2015 09:27:13 +0100
Organization: JSA Research & Innovation
Message-ID: <87611og3ry.fsf@adaheads.sparre-andersen.dk>
References: <f30bbb5d-ebfd-427b-8c16-88aeb8a61318@googlegroups.com>
	<87twpd2qlo.fsf@theworld.com>
	<1pj15r7pul7f1.15qgdyrc8k133$.dlg@40tude.net>
	<87pp0030c1.fsf@theworld.com>
	<135hiczk56x02.1xixcme8btbl4.dlg@40tude.net>
	<n0o9fb$3pq$2@dont-email.me>
	<1dzlgoh4u2j7t$.1un3dfy0oeigd$.dlg@40tude.net>
	<n0qa3q$th8$1@dont-email.me>
	<190shqocxd87d$.1d68ghgqgbvfs$.dlg@40tude.net>
	<87d1vy3f46.fsf@theworld.com>
	<ki9oomfymbau.ckpvghtqa42n.dlg@40tude.net>
	<7e1b4b17-c769-4aa5-a085-a2ccf2ac75ea@googlegroups.com>
	<1quu0fn66x4br$.1f1x6de5oto9u$.dlg@40tude.net>
	<e86561f5-5c5c-4da0-9492-44039d78e7c2@googlegroups.com>
NNTP-Posting-Host: 109.57.156.148.mobile.3.dk
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Trace: loke.gir.dk 1446193634 32608 109.57.156.148 (30 Oct 2015 08:27:14
 GMT)
X-Complaints-To: news@jacob-sparre.dk
NNTP-Posting-Date: Fri, 30 Oct 2015 08:27:14 +0000 (UTC)
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.4 (gnu/linux)
Cancel-Lock: sha1:euNle/rn+9ELgSDpCrnRpk5rSlg=
Xref: news.eternal-september.org comp.lang.ada:28121
Date: 2015-10-30T09:27:13+01:00
List-Id: <comp.lang.ada>

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?