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,FREEMAIL_FROM
	autolearn=unavailable autolearn_force=no version=3.4.4
X-Received: by 10.66.255.3 with SMTP id am3mr2497367pad.30.1446141435941;
        Thu, 29 Oct 2015 10:57:15 -0700 (PDT)
X-Received: by 10.50.67.179 with SMTP id o19mr127819igt.3.1446141435907; Thu,
 29 Oct 2015 10:57:15 -0700 (PDT)
Path: 
 eternal-september.org!reader01.eternal-september.org!reader02.eternal-september.org!news.eternal-september.org!mx02.eternal-september.org!feeder.eternal-september.org!news.glorb.com!i2no487906igv.0!news-out.google.com!z4ni40050ign.0!nntp.google.com!i2no487904igv.0!postnews.google.com!glegroupsg2000goo.googlegroups.com!not-for-mail
Newsgroups: comp.lang.ada
Date: Thu, 29 Oct 2015 10:57:15 -0700 (PDT)
In-Reply-To: <1quu0fn66x4br$.1f1x6de5oto9u$.dlg@40tude.net>
Complaints-To: groups-abuse@google.com
Injection-Info: glegroupsg2000goo.googlegroups.com;
 posting-host=91.55.207.116;
 posting-account=rmHyLAoAAADSQmMWJF0a_815Fdd96RDf
NNTP-Posting-Host: 91.55.207.116
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>
User-Agent: G2/1.0
MIME-Version: 1.0
Message-ID: <e86561f5-5c5c-4da0-9492-44039d78e7c2@googlegroups.com>
Subject: Re: function Is_Open (File : File_Type) return Boolean; :Text_io
From: AdaMagica <christ-usch.grein@t-online.de>
Injection-Date: Thu, 29 Oct 2015 17:57:15 +0000
Content-Type: text/plain; charset=ISO-8859-1
Xref: news.eternal-september.org comp.lang.ada:28116
Date: 2015-10-29T10:57:15-07:00
List-Id: <comp.lang.ada>

Am Donnerstag, 29. Oktober 2015 14:37:47 UTC+1 schrieb Dmitry A. Kazakov:
> Actually there are people in c.l.a. against excessive commenting.

What is *excessive* commenting?
There is no self-documenting code, nowhere.

> So, according to you
> 
>    X : Integer;  -- Undocumented
>    Y : Natural; -- Documented
> 
> Don't you find it a bit silly? There is no difference between both.

No difference?

No, I don't find this silly. Both document (which word would you use?) a choice, in a way.

Integer: I need positive and negative numbers; I don't care about the range.
Natural: Negative numbers are not allowed.

type T is range -42 .. +42;  -- no difference to Integer according to you?

This does not save me from documenting the code in separate design documents.

> BTW, any numeric type in Ada is constrained => "documented", according to
> you.