[Moose-dev] Re: [Better Comment Initiative]: FAMIXSourceLanguage

Hi, First note: in Moose we use third person for comments, not first person.

Second note: we decided to put the comment related to the meta-model in the <FM3Comment:> on the class side, and we keep the implementation Smalltalk comments for the class.

The rest is inline. On Tue, Sep 27, 2011 at 9:57 AM, Stéphane Ducasse &lt;stephane.ducasse(a)inria.fr&gt; wrote: We get ------ FAMIXSourceLanguage This represents the programming language in which an entity is written. It is used for dispatching entity actions for specific languages. For example, formatting a source text will be performed according to the language. We can get --------- I represent the programming language in which an entity is written. I'm used for dispatching entity actions for specific languages. For example, formatting a source text will be performed according to the language. API: format: aSourceString from: anEntity This is not really an API. As the category says, it is a utility method used internally by Moose. isAttached @@no idea what it is.@@ This says whether there are any entities attached associated with language. Again, this is a utility method. By default, if there are no entities attached, it means that all of them are of this language. sourcedEntities References to the entities saying explicitly that are written in this language @@But it does not help me at all@@ This is what it is :). See the comment above. Doru Now I do not get why we have sourceEntities added to the source language. _______________________________________________ Moose-dev mailing list Moose-dev(a)iam.unibe.ch https://www.iam.unibe.ch/mailman/listinfo/moose-dev -- -- www.tudorgirba.com "Every thing has its own flow" _______________________________________________ Moose-dev mailing list Moose-dev(a)iam.unibe.ch https://www.iam.unibe.ch/mailman/listinfo/moose-dev