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=-0.3 required=5.0 tests=BAYES_00,
	REPLYTO_WITHOUT_TO_CC autolearn=no 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!aioe.org!.POSTED!not-for-mail
From: "Dmitry A. Kazakov" <mailbox@dmitry-kazakov.de>
Newsgroups: comp.lang.ada
Subject: Re: function Is_Open (File : File_Type) return Boolean; :Text_io
Date: Thu, 29 Oct 2015 19:26:39 +0100
Organization: cbb software GmbH
Message-ID: <8oa3b2zp0rcj$.iv7bvnb8mgiz$.dlg@40tude.net>
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>
Reply-To: mailbox@dmitry-kazakov.de
NNTP-Posting-Host: j6IQVb9uobzjXrpQLDU2rQ.user.speranza.aioe.org
Mime-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
X-Complaints-To: abuse@aioe.org
User-Agent: 40tude_Dialog/2.0.15.1
X-Notice: Filtered by postfilter v. 0.8.2
Xref: news.eternal-september.org comp.lang.ada:28118
Date: 2015-10-29T19:26:39+01:00
List-Id: <comp.lang.ada>

On Thu, 29 Oct 2015 10:57:15 -0700 (PDT), AdaMagica wrote:

> 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.

What about this:

   if X > 0 then -- When X is positive
      ...
   else -- When X is zero or negative
      ...
   end if;

>> 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.

So, what does not document, then?

> 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?

Regarding documentation? None. Neither document anything. They declare
types and objects of certain properties, that is.

A documentation would refer to the problem space and point out other things
that cannot be expressed in the language.

My point was that comparing to C's rough equivalent

   typedef T int;

in Ada less documentation would be required, because the language can
express more, in particular, the values range, the behavior when the range
is violated etc.

-- 
Regards,
Dmitry A. Kazakov
http://www.dmitry-kazakov.de