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: 103376,3d3f20d31be1c33a X-Google-Attributes: gid103376,public X-Google-Thread: f43e6,2c6139ce13be9980 X-Google-Attributes: gidf43e6,public X-Google-Thread: fac41,2c6139ce13be9980 X-Google-Attributes: gidfac41,public From: doylep@ecf.toronto.edu (Patrick Doyle) Subject: Re: Interface/Implementation (was Re: Design by Contract) Date: 1997/09/05 Message-ID: #1/1 X-Deja-AN: 269997719 X-Nntp-Posting-Host: skule.ecf Sender: news@ecf.toronto.edu (News Administrator) References: <340C85CE.6F42@link.com> <340F3801.47E5@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-05T00:00:00+00:00 List-Id: In article <340F3801.47E5@pseserv3.fw.hac.com>, W. Wesley Groleau x4923 wrote: > >> As Patrick explained, comments are either extracted or ignored on the basis of >> where they appear in the class text. Those in interface-specific parts of the >> text are extracted into the short form. > >Does this mean the accuracy and usefulness of the "spec" depends on the >coder's compliance with style rules that are not automtically enforced? 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? -PD -- -- Patrick Doyle doylep@ecf.utoronto.ca