Added deprecate utility, and reintroduced deprecated methods for this version.

Author: lannymcnie

build/config.json

@@ -2,6 +2,7 @@
 	"source": [
 		"../src/createjs/utils/extend.js",
 		"../src/createjs/utils/promote.js",
+		"../src/createjs/utils/deprecate.js",
 		"../src/createjs/events/Event.js",
 		"../src/createjs/events/EventDispatcher.js",
 		"../src/createjs/utils/Ticker.js",

src/createjs/utils/Ticker.js

@@ -143,8 +143,8 @@ this.createjs = this.createjs||{};
 // public static properties:
 	/**
 	 * Specifies the timing api (setTimeout or requestAnimationFrame) and mode to use. See
-	 * {{#crossLink "Ticker/TIMEOUT"}}{{/crossLink}}, {{#crossLink "Ticker/RAF"}}{{/crossLink}}, and
-	 * {{#crossLink "Ticker/RAF_SYNCHED"}}{{/crossLink}} for mode details.
+	 * {{#crossLink "Ticker/TIMEOUT:property"}}{{/crossLink}}, {{#crossLink "Ticker/RAF:property"}}{{/crossLink}}, and
+	 * {{#crossLink "Ticker/RAF_SYNCHED:property"}}{{/crossLink}} for mode details.
 	 * @property timingMode
 	 * @static
 	 * @type {String}
@@ -316,6 +316,8 @@ this.createjs = this.createjs||{};
 		if (!Ticker._inited) { return; }
 		Ticker._setupTick();
 	};
+	// Ticker.setInterval is @deprecated. Remove for 1.1+
+	Ticker.setInterval = createjs.deprecate(Ticker._setInterval, "Ticker.setInterval");
 
 	/**
 	 * Use the {{#crossLink "Ticker/interval:property"}}{{/crossLink}} property instead.
@@ -327,6 +329,8 @@ this.createjs = this.createjs||{};
 	Ticker._getInterval = function() {
 		return Ticker._interval;
 	};
+	// Ticker.getInterval is @deprecated. Remove for 1.1+
+	Ticker.getInterval = createjs.deprecate(Ticker._getInterval, "Ticker.getInterval");
 
 	/**
 	 * Use the {{#crossLink "Ticker/framerate:property"}}{{/crossLink}} property instead.
@@ -338,6 +342,8 @@ this.createjs = this.createjs||{};
 	Ticker._setFPS = function(value) {
 		Ticker._setInterval(1000/value);
 	};
+	// Ticker.setFPS is @deprecated. Remove for 1.1+
+	Ticker.setFPS = createjs.deprecate(Ticker._setFPS, "Ticker.setFPS");
 
 	/**
 	 * Use the {{#crossLink "Ticker/framerate:property"}}{{/crossLink}} property instead.
@@ -349,6 +355,8 @@ this.createjs = this.createjs||{};
 	Ticker._getFPS = function() {
 		return 1000/Ticker._interval;
 	};
+	// Ticker.getFPS is @deprecated. Remove for 1.1+
+	Ticker.getFPS = createjs.deprecate(Ticker._getFPS, "Ticker.getFPS");
 
 	/**
 	 * Indicates the target time (in milliseconds) between ticks. Default is 50 (20 FPS).

src/createjs/utils/deprecate.js

@@ -0,0 +1,69 @@
+/*
+* extend
+* Visit http://createjs.com/ for documentation, updates and examples.
+*
+* Copyright (c) 2010 gskinner.com, inc.
+*
+* Permission is hereby granted, free of charge, to any person
+* obtaining a copy of this software and associated documentation
+* files (the "Software"), to deal in the Software without
+* restriction, including without limitation the rights to use,
+* copy, modify, merge, publish, distribute, sublicense, and/or sell
+* copies of the Software, and to permit persons to whom the
+* Software is furnished to do so, subject to the following
+* conditions:
+*
+* The above copyright notice and this permission notice shall be
+* included in all copies or substantial portions of the Software.
+*
+* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+* OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+* HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+* WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+* FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+* OTHER DEALINGS IN THE SOFTWARE.
+*/
+
+/**
+ * @module CreateJS
+ */
+
+// namespace:
+this.createjs = this.createjs||{};
+
+/**
+ * @class Utility Methods
+ */
+
+/**
+ * Wraps deprecated methods so they still be used, but throw warnings to developers.
+ *
+ *	obj.deprecatedMethod = createjs.deprecate("Old Method Name", obj._fallbackMethod);
+ *
+ * The recommended approach for deprecated properties is:
+ *
+ *	try {
+ *		Obj	ect.defineProperties(object, {
+ *			readyOnlyProp: { get: createjs.deprecate("readOnlyProp", function() { return this.alternateProp; }) },
+ *			readWriteProp: {
+ *				get: createjs.deprecate("readOnlyProp", function() { return this.alternateProp; }),
+ *				set: createjs.deprecate("readOnlyProp", function(val) { this.alternateProp = val; })
+ *		});
+ *	} catch (e) {}
+ *
+ * @method deprecate
+ * @param {Function} [fallbackMethod=null] A method to call when the deprecated method is used. See the example for how
+ * @param {String} [name=null] The name of the method or property to display in the console warning.
+ * to deprecate properties.
+ * @return {Function} If a fallbackMethod is supplied, returns a closure that will call the fallback method after
+ * logging the warning in the console.
+ */
+createjs.deprecate = function(fallbackMethod, name) {
+	"use strict";
+	return function() {
+		console && (console.warn || console.log)("Deprecated property or method '"+name+"'. See docs for info.");
+		return fallbackMethod && fallbackMethod.apply(this, arguments);
+	}
+};

src/tweenjs/AbstractTween.js

@@ -228,39 +228,42 @@ this.createjs = this.createjs||{};
 // getter / setters:
 
 	/**
-	 * Deprecated in favor of the {{#crossLink "AbstractTween/paused:property"}}{{/crossLink}} property.
-	 * @method setPaused
+	 * Use the {{#crossLink "AbstractTween/paused:property"}}{{/crossLink}} property instead.
+	 * @method _setPaused
 	 * @param {Boolean} [value=true] Indicates whether the tween should be paused (`true`) or played (`false`).
-	 * @deprecated
 	 * @return {AbstractTween} This tween instance (for chaining calls)
+	 * @protected
 	 * @chainable
 	 */
-	p.setPaused = function(value) {
+	p._setPaused = function(value) {
 		createjs.Tween._register(this, value);
 		return this;
 	};
+	p.setPaused = createjs.deprecate(p._setPaused, "AbstractTween.setPaused");
 
 	/**
-	 * Deprecated in favor of the {{#crossLink "AbstractTween/paused:property"}}{{/crossLink}} property.
-	 * @method getPaused
-	 * @deprecated
+	 * Use the {{#crossLink "AbstractTween/paused:property"}}{{/crossLink}} property instead.
+	 * @method _getPaused
+	 * @protected
 	 */
-	p.getPaused = function() {
+	p._getPaused = function() {
 		return this._paused;
 	};
+	p.getPaused = createjs.deprecate(p._getPaused, "AbstactTween.getPaused");
 
 	/**
-	 * Deprecated in favor of the {{#crossLink "AbstractTween/currentLabel:property"}}{{/crossLink}} property.
-	 * @method getCurrentLabel
-	 * @deprecated
+	 * Use the {{#crossLink "AbstractTween/currentLabel:property"}}{{/crossLink}} property instead.
+	 * @method _getCurrentLabel
+	 * @protected
 	 * @return {String} The name of the current label or null if there is no label
 	 **/
-	p.getCurrentLabel = function(pos) {
+	p._getCurrentLabel = function(pos) {
 		var labels = this.getLabels();
 		if (pos == null) { pos = this.position; }
 		for (var i = 0, l = labels.length; i<l; i++) { if (pos < labels[i].position) { break; } }
 		return (i===0) ? null : labels[i-1].label;
 	};
+	p.getCurrentLabel = createjs.deprecate(p._getCurrentLabel, "AbstractTween.getCurrentLabel");
 
 	/**
 	 * Pauses or unpauses the tween. A paused tween is removed from the global registry and is eligible for garbage
@@ -286,8 +289,8 @@ this.createjs = this.createjs||{};
 
 	try {
 		Object.defineProperties(p, {
-			paused: { set: p.setPaused, get: p.getPaused },
-			currentLabel: { get: p.getCurrentLabel }
+			paused: { set: p._setPaused, get: p._getPaused },
+			currentLabel: { get: p._getCurrentLabel }
 		});
 	} catch (e) {}