From f6abe2a71273ad6c44f96d11fd0ea6c188d34e69 Mon Sep 17 00:00:00 2001 From: Brian Moschel Date: Mon, 5 May 2014 00:05:56 -0500 Subject: [PATCH] adding deprecation warnings the right way for attributes and setter --- map/attributes/doc/attributes.md | 9 ++++++--- map/setter/doc/setter.md | 9 +++++---- 2 files changed, 11 insertions(+), 7 deletions(-) diff --git a/map/attributes/doc/attributes.md b/map/attributes/doc/attributes.md index 112a885c4b1..198cbc2572b 100644 --- a/map/attributes/doc/attributes.md +++ b/map/attributes/doc/attributes.md @@ -6,11 +6,14 @@ @group can.Map.attributes.static static @group can.Map.attributes.prototype prototype -@body -## Deprecation Warning +@deprecated {2.1} The attributes plugin (and the setter plugin) have been deprecated in +favor of the new [can.Map.prototype.define define] plugin, which provides the same +functionality. It will still be maintained up to 3.0 and potentially after. +Projects using converters or serializers should consider switching to [can.Map.prototype.define.type define's type] +and [can.Map.prototype.define.serialize define's serialize]. -The attributes plugin (and the setter plugin) has been deprecated in 2.1 in favor of the new [can.Map.prototype.define define] plugin, which provides the same functionality. +@body ## Use diff --git a/map/setter/doc/setter.md b/map/setter/doc/setter.md index 5110778f248..faed31ce12d 100644 --- a/map/setter/doc/setter.md +++ b/map/setter/doc/setter.md @@ -5,6 +5,11 @@ Specify setter methods on [can.Map can.Maps]. +@deprecated {2.1} The setter plugin (and the attributes plugin) have been deprecated in +favor of the new [can.Map.prototype.define define] plugin, which provides the same +functionality. It will still be maintained up to 3.0 and potentially after. +Projects using setters should consider switching to [can.Map.prototype.define.set define setters]. + @signature `setATTR: function(newValue,setValue,setErrors)` Specifies a setter method for the `ATTR` attribute. @@ -25,10 +30,6 @@ set undefined values. @body -## Deprecation Warning - -The attributes plugin (and the setter plugin) has been deprecated in 2.1 in favor of the new [can.Map.prototype.define define] plugin, which provides the same functionality. - ## Use `can.Map.setter(name, setValue(value), setErrors(errors))` extends the Map object