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.3 required=5.0 tests=BAYES_00,INVALID_MSGID
	autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 1108a1,2c6139ce13be9980
X-Google-Attributes: gid1108a1,public
X-Google-Thread: fac41,2c6139ce13be9980
X-Google-Attributes: gidfac41,public
X-Google-Thread: f43e6,2c6139ce13be9980
X-Google-Attributes: gidf43e6,public
X-Google-Thread: 103376,3d3f20d31be1c33a
X-Google-Attributes: gid103376,public
From: doylep@ecf.toronto.edu (Patrick Doyle)
Subject: Re: Interface/Implementation (was Re: Design by Contract)
Date: 1997/09/06
Message-ID: <EG2C9u.6tx@ecf.toronto.edu>#1/1
X-Deja-AN: 270147667
X-Nntp-Posting-Host: skule.ecf
Sender: news@ecf.toronto.edu (News Administrator)
References: <340C85CE.6F42@link.com> <340F3801.47E5@pseserv3.fw.hac.com>
 <EG1JGF.6Bp@ecf.toronto.edu> <34104798.17D7@pseserv3.fw.hac.com>
Organization: University of Toronto, Engineering Computing Facility
Newsgroups: comp.object,comp.software-eng,comp.lang.ada,comp.lang.eiffel
Date: 1997-09-06T00:00:00+00:00
List-Id: <comp.lang.ada>


In article <34104798.17D7@pseserv3.fw.hac.com>,
W. Wesley Groleau x4923 <wwgrol@pseserv3.fw.hac.com> wrote:
>
>> [I said:]
>> 
>>   What do you mean by "enforced"?  How could they be any more 
>> "enforced" than to either be or not be included in the short form?  
>> How can the compiler tell what kind of comments you are adding if 
>> you add them wrong?
>
>That's the point.  The implication has been made that certain types
>of comments are needed in the short form, and to get them there, one
>has to follow some rule which has not been stated in this thread.
>
>Whereas if the spec is a truly separate item (not generated by a tool)
>any comments it has (right or wrong) can not be omitted by the
>non-existent extraction process.  Nor can the non-existent extraction 
>process add something from the implementation.

I see what you mean.  This is true.  However, remember that in order
for comments to appear in the interface file, the programmer must
put them *there* instead of the implementation file.  If this seems
trivial to you, then good, because I think it's trivial too.  But so
is putting the comments in the right place in Eiffel.

It looks like this:

class Goober
  feature Puree is
        -- Comments describing the interface
    do
        -- Comments describing the implementation
    end
end

See, the interface comments still appear in the interface, and the
implementation comments still appear in the implementation.  It's
just that they're in the same file now.

So whatever miniscule amount of mental discipline is necessary to put
comments in the right place in Ada applies to Eiffel too.

(BTW, I hope I got the comment placement right--I've never used the
short tool!)

 -PD
-- 
--
Patrick Doyle
doylep@ecf.utoronto.ca