[ENH] deprecation 3

Stephane Ducasse ducasse at iam.unibe.ch
Wed May 21 17:47:55 UTC 2003


Yes

Sorry for the "bug"

Stef

On Wednesday, May 21, 2003, at 06:52 PM, Doug Way wrote:

>
> On Sunday, May 11, 2003, at 12:52 PM, Stephane Ducasse wrote:
>
>> ...
>> You can have a look at the KCP-63 on 
>> http://minnow.cc.gatech.edu/squeak/3083
>
> This changeset looks good, but before we harvest it, I'd like to make 
> sure the examples in the class comment are clear about how to use the 
> methods.
>
>
> Here's the example in the latest KCP-63 version:
>
>   "Idiom: Imagine I want to deprecated foo
>
>   foo
> 	^ 'foo'
>   I can do
>
>   foo
> 	self deprecatedExplanation: 'The method oldMethod was not good. Use 
> Bar>>foo instead'
> 	^ 'foo'
>
>   or  for certain cases such as primitive I rename foo as fooDeprecated
>
>   fooDeprecated
> 	^ <primitive>
>
>   foo
> 	^ self deprecated: [self fooDeprecated] explanation: 'The method 
> oldMethod was not good. Use Bar>>foo instead'"
>
>
> I might at least change 'oldMethod' to 'foo' and Bar>>foo to 
> Bar>>newFoo in the examples to be more clear.  Because #foo is what is 
> being deprecated, right?
>
> So, the example might look like this:
>
>   "Idiom: Imagine I want to deprecate the message #foo...
>
>   foo
> 	^ 'foo'
>
>   I can do
>
>   foo
> 	self deprecatedExplanation: 'The method #foo was not good. Use 
> Bar>>newFoo instead'
> 	^ 'foo'
>
>   or for certain cases such as when #foo implements a primitive, #foo 
> can be renamed to #fooDeprecated.
>
>   fooDeprecated
> 	^ <primitive>
>
>   foo
> 	^ self deprecated: [self fooDeprecated] explanation: 'The method #foo 
> was not good. Use Bar>>newFoo instead'"
>
>
>
> Does this make sense?
>
> - Doug Way
>
>



More information about the Squeak-dev mailing list