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

["Dmitry A. Kazakov" <mailbox@dmitry-kazakov.de>]

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