> OK. I put those in the class comments because the browser creates the
> comment for you by default, like:
> A RBLiteralValuesSpellingRule is xxxxxxxxx.
>
> Instance Variables
>        matcher:
>
> matcher
>        - xxxxx
> So it is your call whether you want class comments to be able to have the
> variable names in.

Ahh true, I just never used that kind of class comment. But in this
case we should probably do a camel case normalization for the class
comment too. Thanks for pointing out.

>> - I don't know about apostrophes at the end of the word. Should they be
>> removed?
>>
>>    methods''
>>    don't'
>>    RB'
>>    IT'
>>    OK'
>>
>>
>
> Again, your call as to whether you want people to be able to use in class
> comments something like:
>
> To test, enter into a workspace:
> 'This is what you need to type'
>
> or,
>
> The valid entries are: 'yes', 'no','maybe'
>
> There is the edge case of possessive plural apostrophes like:
>
> The methods' categories
>
> which is grammatically correct but most people can probably live without.

Ok, thanks for the clarification. I am convinced that they need to be trimmed.

Lukas

-- 
Lukas Renggli
http://www.lukas-renggli.ch

_______________________________________________
Pharo-project mailing list
[email protected]
http://lists.gforge.inria.fr/cgi-bin/mailman/listinfo/pharo-project

Reply via email to