William A. Rowe, Jr.
Tue, 08 Jul 2008 14:29:01 -0700
Mladen Turk wrote:
William A. Rowe, Jr. wrote:Mladen Turk wrote:Any problems renaming the API in 1.3.x as well?Yup, it shipped. So we can @deprecate your original choice of name and add any new name that's appropriate.Does depreciation means the function must be implemented? I suppose it should, so it'll simply call the renamed one.
Call the well-named function from the deprecated one, yes. It's the pattern that is repeated throughout the API. When the deprecated fn disappears in 2.0, it has no impact on the legitimate one.
What a mess ?!# :(
That's called strict versioning, and that's why I *begged* for careful review before 1.3.0 was released.